usr/src/man/man3proc/Psetsignal.3proc

   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
  29 The
  30 .Fn Psetsignal
  31 function sets the signal tracing flags for the process handle
  32 .Fa P
  33 to
  34 .Fa set .
  35 The call to
  36 .Fn Psetsignal
  37 replaces any existing signal tracing flags entirely with
  38 .Fa set .
  39 The signal tracing flags determine which signals, when received by a
  40 thread in the process, will cause that thread to stop.
  41 For more information on the behavior of the signal tracing flags, including
  42 which signals may be traced this way, see the
  43 .Sy PCSTRACE
  44 section in
  45 .Xr proc 4 .
  46 .Pp
  47 The
  48 .Fa set
  49 argument may be manipulated with the standard signal set manipulation
  50 functions such as
  51 .Xr sigaddset 3C ,
  52 .Xr sigdelset 3C ,
  53 and others which may all be found in
  54 .Xr sigsetops 3C .
  55 .Pp
  56 Note, only active processes may have their signal tracing flags updated.
  57 Process handles that refer to core files, zombie processes, and files do
  58 not have fault tracing flags and this function is a no-op on them.
  59 .Sh INTERFACE STABILITY
  60 .Sy Uncommitted
  61 .Sh MT-LEVEL
  62 See
  63 .Sy LOCKING
  64 in
  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