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