xref: /illumos-gate/usr/src/man/man3proc/Psetsignal.3proc (revision b41e2fb6b2658a36accc73b3b86d99375e700dba)
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 PSETSIGNAL 3PROC
16.Os
17.Sh NAME
18.Nm Psetsignal
19.Nd set signal tracing flags
20.Sh LIBRARY
21.Lb libproc
22.Sh SYNOPSIS
23.In libproc.h
24.Ft void
25.Fo Psetsignal
26.Fa "struct ps_prochandle *P"
27.Fa "const sigset_t *set"
28.Fc
29.Sh DESCRIPTION
30The
31.Fn Psetsignal
32function sets the signal tracing flags for the process handle
33.Fa P
34to
35.Fa set .
36The call to
37.Fn Psetsignal
38replaces any existing signal tracing flags entirely with
39.Fa set .
40The signal tracing flags determine which signals, when received by a
41thread in the process, will cause that thread to stop.
42For more information on the behavior of the signal tracing flags, including
43which signals may be traced this way, see the
44.Sy PCSTRACE
45section in
46.Xr proc 5 .
47.Pp
48The
49.Fa set
50argument may be manipulated with the standard signal set manipulation
51functions such as
52.Xr sigaddset 3C ,
53.Xr sigdelset 3C ,
54and others which may all be found in
55.Xr sigsetops 3C .
56.Pp
57Note, only active processes may have their signal tracing flags updated.
58Process handles that refer to core files, zombie processes, and files do
59not have fault tracing flags and this function is a no-op on them.
60.Sh INTERFACE STABILITY
61.Sy Uncommitted
62.Sh MT-LEVEL
63See
64.Sy LOCKING
65in
66.Xr libproc 3LIB .
67.Sh SEE ALSO
68.Xr sigsetops 3C ,
69.Xr signal.h 3HEAD ,
70.Xr libproc 3LIB ,
71.Xr Psignal 3PROC ,
72.Xr proc 5
73