xref: /illumos-gate/usr/src/man/man3proc/Psetsysentry.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 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. The system call entry tracing flags cause a thread to
50stop on entry to the system call and the exit tracing flags cause a
51thread to stop on return from the system call, before control returns
52back to the user land process. For more information on the state of the
53thread and for information on manipulating the
54.Sy sysset_t ,
55see
56.Xr proc 4 .
57.Pp
58Note that only active processes may have their system call tracing flags
59updated.  Process handles that refer to core files, zombie processes,
60and files do not have fault tracing flags and this function is a no-op
61on them.
62.Sh INTERFACE STABILITY
63.Sy Uncommitted
64.Sh MT-LEVEL
65See
66.Sy LOCKING
67in
68.Xr libproc 3LIB .
69.Sh SEE ALSO
70.Xr Intro 2 ,
71.Xr libproc 3LIB ,
72.Xr proc 4
73