usr/src/man/man3proc/Psetfault.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 PSETFAULT 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Psetfault
  19 .Nd set fault tracing flags
  20 .Sh LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft void
  25 .Fo Psetfault
  26 .Fa "struct ps_prochandle *P"
  27 .Fa "const fltset_t *set"
  28 .Fc
  29 .Sh DESCRIPTION
  30 The
  31 .Fn Psetfault
  32 function sets the fault tracing flags on the process handle
  33 .Fa P
  34 to
  35 .Fa set .
  36 It replaces any existing fault tracing flags on the process.
  37 These flags indicate which faults cause execution of the thread to stop.
  38 Allowing another tool, such as a debugger, to act upon the process.
  39 For more information on faults and the
  40 .Sy fltset_t
  41 structure see the
  42 .Sy PCSFAULT
  43 section in
  44 .Xr proc 4 .
  45 The current fault set for the process may be obtained through the
  46 .Xr Pfault 3PROC
  47 function.
  48 .Pp
  49 Note, only active processes may have their fault set updated.
  50 Process handles that refer to core files, zombie processes, and files do not
  51 have fault tracing flags and this function is a no-op on them.
  52 .Sh INTERFACE STABILITY
  53 .Sy Uncommitted
  54 .Sh MT-LEVEL
  55 See
  56 .Sy LOCKING
  57 in
  58 .Xr libproc 3LIB .
  59 .Sh SEE ALSO
  60 .Xr libproc 3LIB ,
  61 .Xr Pfault 3PROC ,
  62 .Xr proc 4