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 SYNOPSIS 21.Lb libproc 22.In libproc.h 23.Ft void 24.Fo Pupdate_maps 25.Fa "struct ps_prochandle *P" 26.Fc 27.Sh DESCRIPTION 28The 29.Fn Pupdate_maps 30function is used to verify that all of the cached mappings in the 31process 32.Fa P 33are still valid and update the cached data with any new information. 34This is generally called in response to activity by the run-time 35link-editor. In general, the 36.Sy libproc 37library takes care of managing the need to call this function; however, 38debuggers, introspection tools, and others that are interposing on rtld 39activity or other actions, may need to call this function. 40Note that the 41.Fn Pupdate_maps 42function is only meaningful for active processes. It will do nothing on 43process handles that refer to core files, zombie processes, and ELF 44objects. 45.Sh INTERFACE STABILITY 46.Sy Uncommitted 47.Sh MT-LEVEL 48See 49.Sy LOCKING 50in 51.Xr libproc 3LIB . 52.Sh SEE ALSO 53.Xr libproc 3LIB , 54.Xr Pupdate_syms 3PROC 55