xref: /illumos-gate/usr/src/man/man3proc/Psetsysentry.3proc (revision 45ede40b2394db7967e59f19288fae9b62efd4aa)
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 PSETSYSENTRY 3PROC
16.Os
17.Sh NAME
18.Nm Psetsysentry ,
19.Nm Psetsysexit
20.Nd set system call tracing flags
21.Sh LIBRARY
22.Lb libproc
23.Sh SYNOPSIS
24.In libproc.h
25.Ft void
26.Fo Psetsysentry
27.Fa "struct ps_prochandle *P"
28.Fa "const sysset_t *set"
29.Fc
30.Ft void
31.Fo Psetsysexit
32.Fa "struct ps_prochandle *P"
33.Fa "const sysset_t *set"
34.Fc
35.Sh DESCRIPTION
36The
37.Fn Psetsysentry
38and
39.Fn Psetsysexit
40set the system call entry and exit tracing flags respectively in the
41process handle
42.Fa P
43to
44.Fa set .
45The call to
46.Fn Psetsysentry
47or
48.Fn Psetsysexit
49replaces the corresponding set of system call tracing flags entirely
50with the new set.
51The system call entry tracing flags cause a thread to stop on entry to the
52system call and the exit tracing flags cause a thread to stop on return from the
53system call, before control returns back to the user land process.
54For more information on the state of the thread and for information on
55manipulating the
56.Sy sysset_t ,
57see
58.Xr proc 4 .
59.Pp
60Note that only active processes may have their system call tracing flags
61updated.
62Process handles that refer to core files, zombie processes, and files do not
63have fault tracing flags and this function is a no-op on them.
64.Sh INTERFACE STABILITY
65.Sy Uncommitted
66.Sh MT-LEVEL
67See
68.Sy LOCKING
69in
70.Xr libproc 3LIB .
71.Sh SEE ALSO
72.Xr Intro 2 ,
73.Xr libproc 3LIB ,
74.Xr proc 4
75