1killpg(3C) Standard C Library Functions killpg(3C)
2
3
4
6 killpg - send signal to a process group
7
9 #include <signal.h>
10
11 int killpg(pid_t pgrp, int sig);
12
13
15 The killpg() function sends the signal sig to the process group pgrp.
16 See signal.h(3HEAD) for a list of signals.
17
18
19 The real or effective user ID of the sending process must match the
20 real or saved set-user ID of the receiving process, unless the effec‐
21 tive user ID of the sending process is the privileged user. A single
22 exception is the signal SIGCONT, which may always be sent to any
23 descendant of the current process.
24
26 Upon successful completion, 0 is returned. Otherwise, −1 is returned
27 and errno is set to indicate the error.
28
30 The killpg() function will fail and no signal will be sent if:
31
32 EINVAL The sig argument is not a valid signal number.
33
34
35 EPERM The effective user ID of the sending process is not privi‐
36 leged user, and neither its real nor effective user ID
37 matches the real or saved set-user ID of one or more of the
38 target processes.
39
40
41 ESRCH No processes were found in the specified process group.
42
43
45 See attributes(5) for descriptions of the following attributes:
46
47
48
49
50 ┌─────────────────────────────┬─────────────────────────────┐
51 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
52 ├─────────────────────────────┼─────────────────────────────┤
53 │Interface Stability │Standard │
54 ├─────────────────────────────┼─────────────────────────────┤
55 │MT-Level │MT-Safe │
56 └─────────────────────────────┴─────────────────────────────┘
57
59 kill(2), setpgrp(2), sigaction(2), signal.h(3HEAD), attributes(5),
60 standards(5)
61
62
63
64SunOS 5.11 24 Jul 2002 killpg(3C)