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 LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft void
  25 .Fo Preset_maps
  26 .Fa "struct ps_prochandle *P"
  27 .Fc
  28 .Sh DESCRIPTION
  29 The
  30 .Fn Preset_maps
  31 function resets all of the mapping data, cached symbol tables, debug
  32 information, CTF, and more in the process handle
  33 .Fa P .
  34 The map information will rebuild itself on the execution of another
  35 .Xr libproc 3LIB
  36 function that requires the information.
  37 This function should be called any time after a process handle performs
  38 an
  39 .Xr exec 2 .
  40 As such, this interface is only relevant to the manipulation of live
  41 processes and not core files or ELF files.
  42 For more information, see the
  43 .Sy PROGRAMMING NOTES
  44 section in
  45 .Xr libproc 3LIB .
  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 exec 2 ,
  55 .Xr libproc 3LIB ,
  56 .Xr proc 4