2
3 NAME
4 Psignal - set signal tracing action
5
6 LIBRARY
7 Process Control Library (libproc, -lproc)
8
9 SYNOPSIS
10 #include <libproc.h>
11
12 int
13 Psignal(struct ps_prochandle *P, int which, int stop);
14
15 DESCRIPTION
16 The Psignal() function sets the signal tracing flag for the process
17 handle P. If stop is non-zero it causes the process handle to stop
18 threads that encounter the signal which. If stop is zero, then it
19 disables tracing for the signal which.
20
21 The signal constants, representing valid values for which, can be found
22 in signal.h(3HEAD.) The signal SIGKILL may not be stopped.
23
24 Note, only active processes may have their signal tracing flags updated.
25 Process handles that refer to core files, zombie processes, and files do
26 not have signal tracing flags. Calling this function on them is an
27 error.
28
29 RETURN VALUES
30 Upon successful completion, the Psignal() function returns the previous
31 disposition of the signal which. It returns 1 if it was set and 0 if
32 not. Otherwise, -1 is returned and errno is set to indicate the error.
33
34 ERRORS
35 The Psignal() function will fail if:
36
37 EINVAL which is SIGKILL and stop is non-zero .
38
39 which is not a valid signal.
40
41 ENOENT P does not correspond to an active process.
42
|
2
3 NAME
4 Psignal - set signal tracing action
5
6 LIBRARY
7 Process Control Library (libproc, -lproc)
8
9 SYNOPSIS
10 #include <libproc.h>
11
12 int
13 Psignal(struct ps_prochandle *P, int which, int stop);
14
15 DESCRIPTION
16 The Psignal() function sets the signal tracing flag for the process
17 handle P. If stop is non-zero it causes the process handle to stop
18 threads that encounter the signal which. If stop is zero, then it
19 disables tracing for the signal which.
20
21 The signal constants, representing valid values for which, can be found
22 in signal.h(3HEAD). The signal SIGKILL may not be stopped.
23
24 Note, only active processes may have their signal tracing flags updated.
25 Process handles that refer to core files, zombie processes, and files do
26 not have signal tracing flags. Calling this function on them is an
27 error.
28
29 RETURN VALUES
30 Upon successful completion, the Psignal() function returns the previous
31 disposition of the signal which. It returns 1 if it was set and 0 if
32 not. Otherwise, -1 is returned and errno is set to indicate the error.
33
34 ERRORS
35 The Psignal() function will fail if:
36
37 EINVAL which is SIGKILL and stop is non-zero .
38
39 which is not a valid signal.
40
41 ENOENT P does not correspond to an active process.
42
|