1.\" 2.\" This file and its contents are supplied under the terms of the 3.\" Common Development and Distribution License ("CDDL"), version 1.0. 4.\" You may only use this file in accordance with the terms of version 5.\" 1.0 of the CDDL. 6.\" 7.\" A full copy of the text of the CDDL should have accompanied this 8.\" source. A copy of the CDDL is also available via the Internet at 9.\" http://www.illumos.org/license/CDDL. 10.\" 11.\" 12.\" Copyright 2015 Joyent, Inc. 13.\" 14.Dd May 11, 2016 15.Dt PUPDATE_MAPS 3PROC 16.Os 17.Sh NAME 18.Nm Pupdate_maps 19.Nd update address space mappings 20.Sh LIBRARY 21.Lb libproc 22.Sh SYNOPSIS 23.In libproc.h 24.Ft void 25.Fo Pupdate_maps 26.Fa "struct ps_prochandle *P" 27.Fc 28.Sh DESCRIPTION 29The 30.Fn Pupdate_maps 31function is used to verify that all of the cached mappings in the 32process 33.Fa P 34are still valid and update the cached data with any new information. 35This is generally called in response to activity by the run-time 36link-editor. 37In general, the 38.Sy libproc 39library takes care of managing the need to call this function; however, 40debuggers, introspection tools, and others that are interposing on rtld 41activity or other actions, may need to call this function. 42Note that the 43.Fn Pupdate_maps 44function is only meaningful for active processes. 45It will do nothing on process handles that refer to core files, zombie 46processes, and ELF objects. 47.Sh INTERFACE STABILITY 48.Sy Uncommitted 49.Sh MT-LEVEL 50See 51.Sy LOCKING 52in 53.Xr libproc 3LIB . 54.Sh SEE ALSO 55.Xr libproc 3LIB , 56.Xr Pupdate_syms 3PROC 57