usr/src/man/man3proc/Preset_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 PRESET_MAPS 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Preset_maps
  19 .Nd reset memory mapping data after exec
  20 .Sh SYNOPSIS
  21 .Lb libproc
  22 .In libproc.h
  23 .Ft void
  24 .Fo Preset_maps
  25 .Fa "struct ps_prochandle *P"
  26 .Fc
  27 .Sh DESCRIPTION
  28 The
  29 .Fn Preset_maps
  30 function resets all of the mapping data, cached symbol tables, debug
  31 information, CTF, and more in the process handle
  32 .Fa P .
  33 The map information will rebuild itself on the execution of another
  34 .Xr libproc 3LIB
  35 function that requires the information.
  36 This function should be called any time after a process handle performs
  37 an
  38 .Xr exec 2 .
  39 As such, this interface is only relevant to the manipulation of live
  40 processes and not core files or ELF files.
  41 For more information, see the
  42 .Sy PROGRAMMING NOTES
  43 section in
  44 .Xr libproc 3LIB .
  45 .Sh INTERFACE STABILITY
  46 .Sy Uncommitted
  47 .Sh MT-LEVEL
  48 See
  49 .Sy LOCKING
  50 in
  51 .Xr libproc 3LIB .
  52 .Sh SEE ALSO
  53 .Xr exec 2 ,
  54 .Xr libproc 3LIB ,
  55 .Xr proc 4