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