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