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