usr/src/man/man3proc/Pupdate_maps.3proc

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