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