xref: /illumos-gate/usr/src/man/man3proc/Preset_maps.3proc (revision 66582b606a8194f7f3ba5b3a3a6dca5b0d346361)
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
29The
30.Fn Preset_maps
31function resets all of the mapping data, cached symbol tables, debug
32information, CTF, and more in the process handle
33.Fa P .
34The map information will rebuild itself on the execution of another
35.Xr libproc 3LIB
36function that requires the information.
37This function should be called any time after a process handle performs
38an
39.Xr exec 2 .
40As such, this interface is only relevant to the manipulation of live
41processes and not core files or ELF files.
42For more information, see the
43.Sy PROGRAMMING NOTES
44section in
45.Xr libproc 3LIB .
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 exec 2 ,
55.Xr libproc 3LIB ,
56.Xr proc 4
57