Print this page
10229 Some man pages have incorrect cross-references
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man3proc/Psignal.3proc
+++ new/usr/src/man/man3proc/Psignal.3proc
1 1 .\"
2 2 .\" This file and its contents are supplied under the terms of the
3 3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 4 .\" You may only use this file in accordance with the terms of version
5 5 .\" 1.0 of the CDDL.
6 6 .\"
7 7 .\" A full copy of the text of the CDDL should have accompanied this
8 8 .\" source. A copy of the CDDL is also available via the Internet at
9 9 .\" http://www.illumos.org/license/CDDL.
10 10 .\"
11 11 .\"
12 12 .\" Copyright 2015 Joyent, Inc.
13 13 .\"
14 14 .Dd May 11, 2016
15 15 .Dt PSIGNAL 3PROC
16 16 .Os
17 17 .Sh NAME
18 18 .Nm Psignal
19 19 .Nd set signal tracing action
20 20 .Sh LIBRARY
21 21 .Lb libproc
22 22 .Sh SYNOPSIS
23 23 .In libproc.h
24 24 .Ft int
25 25 .Fo Psignal
26 26 .Fa "struct ps_prochandle *P"
27 27 .Fa "int which"
28 28 .Fa "int stop"
29 29 .Fc
30 30 .Sh DESCRIPTION
31 31 The
32 32 .Fn Psignal
33 33 function sets the signal tracing flag for the process handle
34 34 .Fa P .
35 35 If
36 36 .Fa stop
37 37 is
38 38 .Sy non-zero
39 39 it causes the process handle to stop threads that encounter the signal
40 40 .Fa which .
↓ open down ↓ |
40 lines elided |
↑ open up ↑ |
41 41 If
42 42 .Fa stop
43 43 is
44 44 .Sy zero ,
45 45 then it disables tracing for the signal
46 46 .Fa which .
47 47 .Pp
48 48 The signal constants, representing valid values for
49 49 .Fa which ,
50 50 can be found in
51 -.Xr signal.h 3HEAD.
51 +.Xr signal.h 3HEAD .
52 52 The signal
53 53 .Dv SIGKILL
54 54 may not be stopped.
55 55 .Pp
56 56 Note, only active processes may have their signal tracing flags updated.
57 57 Process handles that refer to core files, zombie processes, and files do
58 58 not have signal tracing flags.
59 59 Calling this function on them is an error.
60 60 .Sh RETURN VALUES
61 61 Upon successful completion, the
62 62 .Fn Psignal
63 63 function returns the previous disposition of the signal
64 64 .Fa which .
65 65 It returns
66 66 .Sy 1
67 67 if it was set and
68 68 .Sy 0
69 69 if not.
70 70 Otherwise,
71 71 .Sy -1
72 72 is returned and
73 73 .Sy errno
74 74 is set to indicate the error.
75 75 .Sh ERRORS
76 76 The
77 77 .Fn Psignal
78 78 function will fail if:
79 79 .Bl -tag -width Er
80 80 .It Er EINVAL
81 81 .Fa which
82 82 is
83 83 .Dv SIGKILL
84 84 and
85 85 .Fa stop
86 86 is non-zero .
87 87 .Pp
88 88 .Fa which
89 89 is not a valid signal.
90 90 .It Er ENOENT
91 91 .Fa P
92 92 does not correspond to an active process.
93 93 .El
94 94 .Sh INTERFACE STABILITY
95 95 .Sy Uncommitted
96 96 .Sh MT-LEVEL
97 97 See
98 98 .Sy LOCKING
99 99 in
100 100 .Xr libproc 3LIB .
101 101 .Sh SEE ALSO
102 102 .Xr signal.h 3HEAD ,
103 103 .Xr libproc 3LIB ,
104 104 .Xr Psetsignal 3PROC ,
105 105 .Xr proc 4
↓ open down ↓ |
44 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX