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 4 . 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 4 73