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. 36In general, the 37.Sy libproc 38library takes care of managing the need to call this function; however, 39debuggers, introspection tools, and others that are interposing on rtld 40activity or other actions, may need to call this function. 41Note that the 42.Fn Pupdate_maps 43function is only meaningful for active processes. 44It will do nothing on process handles that refer to core files, zombie 45processes, and ELF objects. 46.Sh INTERFACE STABILITY 47.Sy Uncommitted 48.Sh MT-LEVEL 49See 50.Sy LOCKING 51in 52.Xr libproc 3LIB . 53.Sh SEE ALSO 54.Xr libproc 3LIB , 55.Xr Pupdate_syms 3PROC 56