Print this page
8158 Want named threads API
9857 proc manpages should have LIBRARY section
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man3proc/Pclearfault.3proc.man.txt
+++ new/usr/src/man/man3proc/Pclearfault.3proc.man.txt
1 1 PCLEARFAULT(3PROC) Process Control Library Functions PCLEARFAULT(3PROC)
2 2
3 3 NAME
4 4 Pclearfault, Lclearfault - clear process and thread faults
5 5
6 -SYNOPSIS
6 +LIBRARY
7 7 Process Control Library (libproc, -lproc)
8 +
9 +SYNOPSIS
8 10 #include <libproc.h>
9 11
10 12 int
11 13 Pclearfault(struct ps_prochandle *P);
12 14
13 15 int
14 16 Lclearfault(struct ps_lwphandle *L);
15 17
16 18 DESCRIPTION
17 19 During normal operation a process may encounter a fault, due to a
18 20 hardware exception, identifying a problem with the running process.
19 21 Hardware faults include things like executing illegal instructions,
20 22 encountering a breakpoint, and arithmetic exceptions. Faults are
21 23 discussed further in proc(4).
22 24
23 25 The Pclearfault() function instructs the system to clear any fault
24 26 pending delivery to a thread in the process represented by the process
25 27 handle P. The pending fault will never be delivered to process
26 28 represented by P.
27 29
28 30 The Lclearfault() function is identical to the Pclearfault() function,
29 31 except rather than operating on the representative thread of the process
30 32 it operates on the thread handle L.
31 33
32 34 The Pclearfault() and Lclearfault() functions only have meaning for
33 35 active processes. They will fail on process handles corresponding to
34 36 zombie processes, ELF objects, and cores.
35 37
36 38 RETURN VALUES
37 39 Upon successful completion, the Pclearfault() and Lclearfault() functions
38 40 clear pending faults and return 0. Otherwise, -1 is returned, errno is
39 41 set to indicate the error, and no faults are cleared.
40 42
41 43 ERRORS
42 44 For a full list of possible errors see the DIAGNOSTICS section in
43 45 proc(4).
44 46
45 47 INTERFACE STABILITY
46 48 Uncommitted
47 49
48 50 MT-LEVEL
49 51 See LOCKING in libproc(3LIB).
50 52
51 53 SEE ALSO
52 54 libproc(3LIB), proc(4)
53 55
54 56 illumos May 11, 2016 illumos
↓ open down ↓ |
37 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX