Debian Codegraph @

upstream/fedora-44/man2/kill.2

raw
1 .\" Copyright (c) 1992 Drew Eckhardt ([email protected]), March 28, 1992
2 .\"
3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
4 .\"
5 .\" Modified by Michael Haardt <[email protected]>
6 .\" Modified by Thomas Koenig <[email protected]>
7 .\" Modified 1993-07-23 by Rik Faith <[email protected]>
8 .\" Modified 1993-07-25 by Rik Faith <[email protected]>
9 .\" Modified 1995-11-01 by Michael Haardt
10 .\" <[email protected]>
11 .\" Modified 1996-04-14 by Andries Brouwer <[email protected]>
12 .\" [added some polishing contributed by Mike Battersby <[email protected]>]
13 .\" Modified 1996-07-21 by Andries Brouwer <[email protected]>
14 .\" Modified 1997-01-17 by Andries Brouwer <[email protected]>
15 .\" Modified 2001-12-18 by Andries Brouwer <[email protected]>
16 .\" Modified 2002-07-24 by Michael Kerrisk <[email protected]>
17 .\" Added note on historical rules enforced when an unprivileged process
18 .\" sends a signal.
19 .\" Modified 2004-06-16 by Michael Kerrisk <[email protected]>
20 .\" Added note on CAP_KILL
21 .\" Modified 2004-06-24 by aeb
22 .\" Modified, 2004-11-30, after idea from [email protected]
23 .\"
24 .TH kill 2 2025-02-12 "Linux man-pages 6.13"
25 .SH NAME
26 kill \- send signal to a process
27 .SH LIBRARY
28 Standard C library
29 .RI ( libc ,\~ \-lc )
30 .SH SYNOPSIS
31 .nf
32 .B #include <signal.h>
33 .P
34 .BI "int kill(pid_t " pid ", int " sig );
35 .fi
36 .P
37 .RS -4
38 Feature Test Macro Requirements for glibc (see
39 .BR feature_test_macros (7)):
40 .RE
41 .P
42 .BR kill ():
43 .nf
44 _POSIX_C_SOURCE
45 .fi
46 .SH DESCRIPTION
47 The
48 .BR kill ()
49 system call
50 can be used to send any signal to any process group or process.
51 .P
52 If \fIpid\fP is positive, then signal \fIsig\fP is sent to the
53 process with the ID specified by \fIpid\fP.
54 .P
55 If \fIpid\fP equals 0, then \fIsig\fP is sent to every process in the
56 process group of the calling process.
57 .P
58 If \fIpid\fP equals \-1, then \fIsig\fP is sent to every process
59 for which the calling process has permission to send signals,
60 except for process 1 (\fIinit\fP), but see below.
61 .P
62 If \fIpid\fP is less than \-1, then \fIsig\fP is sent to every process
63 in the process group whose ID is \fI\-pid\fP.
64 .P
65 If \fIsig\fP is 0, then no signal is sent,
66 but existence and permission checks are still performed;
67 this can be used to check for the existence of a process ID or
68 process group ID that the caller is permitted to signal.
69 .P
70 For a process to have permission to send a signal,
71 it must either be privileged (under Linux: have the
72 .B CAP_KILL
73 capability in the user namespace of the target process),
74 or the real or effective user ID of the sending process must equal
75 the real or saved set-user-ID of the target process.
76 In the case of
77 .BR SIGCONT ,
78 it suffices when the sending and receiving
79 processes belong to the same session.
80 (Historically, the rules were different; see HISTORY.)
81 .SH RETURN VALUE
82 On success, zero is returned.
83 If signals were sent to a process group,
84 success means that at least one signal was delivered.
85 On error, \-1 is returned, and
86 .I errno
87 is set to indicate the error.
88 .SH ERRORS
89 .TP
90 .B EINVAL
91 An invalid signal was specified.
92 .TP
93 .B EPERM
94 The calling process does not have permission to send the signal
95 to any of the target processes.
96 .TP
97 .B ESRCH
98 The target process or process group does not exist.
99 Note that an existing process might be a zombie,
100 a process that has terminated execution, but
101 has not yet been
102 .BR wait (2)ed
103 for.
104 .SH STANDARDS
105 POSIX.1-2008.
106 .SH HISTORY
107 POSIX.1-2001, SVr4, 4.3BSD.
108 .SS Linux notes
109 Across different kernel versions, Linux has enforced different rules
110 for the permissions required for an unprivileged process
111 to send a signal to another process.
112 .\" In the 0.* kernels things chopped and changed quite
113 .\" a bit - MTK, 24 Jul 02
114 In Linux 1.0 to 1.2.2, a signal could be sent if the
115 effective user ID of the sender matched effective user ID of the target,
116 or the real user ID of the sender matched the real user ID of the target.
117 From Linux 1.2.3 until 1.3.77, a signal could be sent if the
118 effective user ID of the sender matched either the real or effective
119 user ID of the target.
120 The current rules, which conform to POSIX.1, were adopted
121 in Linux 1.3.78.
122 .SH NOTES
123 The only signals that can be sent to process ID 1, the
124 .I init
125 process, are those for which
126 .I init
127 has explicitly installed signal handlers.
128 This is done to assure the
129 system is not brought down accidentally.
130 .P
131 POSIX.1 requires that \fIkill(\-1,sig)\fP send \fIsig\fP
132 to all processes that the calling process may send signals to,
133 except possibly for some implementation-defined system processes.
134 Linux allows a process to signal itself, but on Linux the call
135 \fIkill(\-1,sig)\fP does not signal the calling process.
136 .P
137 POSIX.1 requires that if a process sends a signal to itself,
138 and the sending thread does not have the signal blocked,
139 and no other thread
140 has it unblocked or is waiting for it in
141 .BR sigwait (3),
142 at least one
143 unblocked signal must be delivered to the sending thread before the
144 .BR kill ()
145 returns.
146 .SH BUGS
147 In Linux 2.6 up to and including Linux 2.6.7,
148 there was a bug that meant that when sending signals to a process group,
149 .BR kill ()
150 failed with the error
151 .B EPERM
152 if the caller did not have permission to send the signal to \fIany\fP (rather
153 than \fIall\fP) of the members of the process group.
154 Notwithstanding this error return, the signal was still delivered
155 to all of the processes for which the caller had permission to signal.
156 .SH SEE ALSO
157 .BR kill (1),
158 .BR _exit (2),
159 .BR pidfd_send_signal (2),
160 .BR signal (2),
161 .BR tkill (2),
162 .BR exit (3),
163 .BR killpg (3),
164 .BR sigqueue (3),
165 .BR capabilities (7),
166 .BR credentials (7),
167 .BR signal (7)