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_SYMS 3PROC
16.Os
17.Sh NAME
18.Nm Pupdate_syms
19.Nd update cached symbol tables
20.Sh LIBRARY
21.Lb libproc
22.Sh SYNOPSIS
23.In libproc.h
24.Ft void
25.Fo Pupdate_syms
26.Fa "struct ps_prochandle *P"
27.Fc
28.Sh DESCRIPTION
29The
30.Fn Pupdate_syms
31function is used to update all of the cached symbol tables in the
32process handle
33.Fa P :
34updating, invalidating, and caching new symbol tables as appropriate for
35functions such as
36.Xr Psymbol_iter 3PROC .
37This is generally called in response to activity by the run-time
38link-editor.
39In general, the
40.Sy libproc
41library takes care of managing the need to call this function;
42however, debuggers, introspection tools, and others that are
43interposing on rtld activity may need to call this function.
44Note that the
45.Fn Pupdate_syms
46function is only meaningful for active processes.
47It will do nothing on process handles that refer to core files, zombie
48processes, and ELF objects.
49.Sh INTERFACE STABILITY
50.Sy Uncommitted
51.Sh MT-LEVEL
52See
53.Sy LOCKING
54in
55.Xr libproc 3LIB .
56.Sh SEE ALSO
57.Xr libproc 3LIB ,
58.Xr Pupdate_maps 3PROC
59