xref: /illumos-gate/usr/src/man/man3proc/Psetfault.3proc (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
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
30The
31.Fn Psetfault
32function sets the fault tracing flags on the process handle
33.Fa P
34to
35.Fa set .
36It replaces any existing fault tracing flags on the process.
37These flags indicate which faults cause execution of the thread to stop.
38Allowing another tool, such as a debugger, to act upon the process.
39For more information on faults and the
40.Sy fltset_t
41structure see the
42.Sy PCSFAULT
43section in
44.Xr proc 5 .
45The current fault set for the process may be obtained through the
46.Xr Pfault 3PROC
47function.
48.Pp
49Note, only active processes may have their fault set updated.
50Process handles that refer to core files, zombie processes, and files do not
51have fault tracing flags and this function is a no-op on them.
52.Sh INTERFACE STABILITY
53.Sy Uncommitted
54.Sh MT-LEVEL
55See
56.Sy LOCKING
57in
58.Xr libproc 3LIB .
59.Sh SEE ALSO
60.Xr libproc 3LIB ,
61.Xr Pfault 3PROC ,
62.Xr proc 5
63