xref: /illumos-gate/usr/src/man/man3proc/Psetsignal.3proc (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
143051d27SRobert Mustacchi.\"
243051d27SRobert Mustacchi.\" This file and its contents are supplied under the terms of the
343051d27SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0.
443051d27SRobert Mustacchi.\" You may only use this file in accordance with the terms of version
543051d27SRobert Mustacchi.\" 1.0 of the CDDL.
643051d27SRobert Mustacchi.\"
743051d27SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this
843051d27SRobert Mustacchi.\" source.  A copy of the CDDL is also available via the Internet at
943051d27SRobert Mustacchi.\" http://www.illumos.org/license/CDDL.
1043051d27SRobert Mustacchi.\"
1143051d27SRobert Mustacchi.\"
1243051d27SRobert Mustacchi.\" Copyright 2015 Joyent, Inc.
1343051d27SRobert Mustacchi.\"
1443051d27SRobert Mustacchi.Dd May 11, 2016
1543051d27SRobert Mustacchi.Dt PSETSIGNAL 3PROC
1643051d27SRobert Mustacchi.Os
1743051d27SRobert Mustacchi.Sh NAME
1843051d27SRobert Mustacchi.Nm Psetsignal
1943051d27SRobert Mustacchi.Nd set signal tracing flags
20ab618543SJohn Levon.Sh LIBRARY
2143051d27SRobert Mustacchi.Lb libproc
22ab618543SJohn Levon.Sh SYNOPSIS
2343051d27SRobert Mustacchi.In libproc.h
2443051d27SRobert Mustacchi.Ft void
2543051d27SRobert Mustacchi.Fo Psetsignal
2643051d27SRobert Mustacchi.Fa "struct ps_prochandle *P"
2743051d27SRobert Mustacchi.Fa "const sigset_t *set"
2843051d27SRobert Mustacchi.Fc
2943051d27SRobert Mustacchi.Sh DESCRIPTION
3043051d27SRobert MustacchiThe
3143051d27SRobert Mustacchi.Fn Psetsignal
3243051d27SRobert Mustacchifunction sets the signal tracing flags for the process handle
3343051d27SRobert Mustacchi.Fa P
3443051d27SRobert Mustacchito
3543051d27SRobert Mustacchi.Fa set .
3643051d27SRobert MustacchiThe call to
3743051d27SRobert Mustacchi.Fn Psetsignal
3843051d27SRobert Mustacchireplaces any existing signal tracing flags entirely with
3943051d27SRobert Mustacchi.Fa set .
4043051d27SRobert MustacchiThe signal tracing flags determine which signals, when received by a
4172d3dbb9SYuri Pankovthread in the process, will cause that thread to stop.
4272d3dbb9SYuri PankovFor more information on the behavior of the signal tracing flags, including
4372d3dbb9SYuri Pankovwhich signals may be traced this way, see the
4443051d27SRobert Mustacchi.Sy PCSTRACE
4543051d27SRobert Mustacchisection in
46*bbf21555SRichard Lowe.Xr proc 5 .
4743051d27SRobert Mustacchi.Pp
4843051d27SRobert MustacchiThe
4943051d27SRobert Mustacchi.Fa set
5043051d27SRobert Mustacchiargument may be manipulated with the standard signal set manipulation
5143051d27SRobert Mustacchifunctions such as
5243051d27SRobert Mustacchi.Xr sigaddset 3C ,
5343051d27SRobert Mustacchi.Xr sigdelset 3C ,
5443051d27SRobert Mustacchiand others which may all be found in
5543051d27SRobert Mustacchi.Xr sigsetops 3C .
5643051d27SRobert Mustacchi.Pp
5743051d27SRobert MustacchiNote, only active processes may have their signal tracing flags updated.
5843051d27SRobert MustacchiProcess handles that refer to core files, zombie processes, and files do
5943051d27SRobert Mustacchinot have fault tracing flags and this function is a no-op on them.
6043051d27SRobert Mustacchi.Sh INTERFACE STABILITY
6143051d27SRobert Mustacchi.Sy Uncommitted
6243051d27SRobert Mustacchi.Sh MT-LEVEL
6343051d27SRobert MustacchiSee
6443051d27SRobert Mustacchi.Sy LOCKING
6543051d27SRobert Mustacchiin
6643051d27SRobert Mustacchi.Xr libproc 3LIB .
6743051d27SRobert Mustacchi.Sh SEE ALSO
6843051d27SRobert Mustacchi.Xr sigsetops 3C ,
6943051d27SRobert Mustacchi.Xr signal.h 3HEAD ,
7043051d27SRobert Mustacchi.Xr libproc 3LIB ,
7143051d27SRobert Mustacchi.Xr Psignal 3PROC ,
72*bbf21555SRichard Lowe.Xr proc 5
73