1 /* vi: set sw=4 ts=4: */
3 * Mini kill/killall[5] implementation for busybox
5 * Copyright (C) 1995, 1996 by Bruce Perens <bruce@pixar.com>.
6 * Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
8 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
11 //usage:#define kill_trivial_usage
12 //usage: "[-l] [-SIG] PID..."
13 //usage:#define kill_full_usage "\n\n"
14 //usage: "Send a signal (default: TERM) to given PIDs\n"
15 //usage: "\n -l List all signal names and numbers"
16 /* //usage: "\n -s SIG Yet another way of specifying SIG" */
18 //usage:#define kill_example_usage
19 //usage: "$ ps | grep apache\n"
20 //usage: "252 root root S [apache]\n"
21 //usage: "263 www-data www-data S [apache]\n"
22 //usage: "264 www-data www-data S [apache]\n"
23 //usage: "265 www-data www-data S [apache]\n"
24 //usage: "266 www-data www-data S [apache]\n"
25 //usage: "267 www-data www-data S [apache]\n"
26 //usage: "$ kill 252\n"
28 //usage:#define killall_trivial_usage
29 //usage: "[-l] [-q] [-SIG] PROCESS_NAME..."
30 //usage:#define killall_full_usage "\n\n"
31 //usage: "Send a signal (default: TERM) to given processes\n"
32 //usage: "\n -l List all signal names and numbers"
33 /* //usage: "\n -s SIG Yet another way of specifying SIG" */
34 //usage: "\n -q Don't complain if no processes were killed"
36 //usage:#define killall_example_usage
37 //usage: "$ killall apache\n"
39 //usage:#define killall5_trivial_usage
40 //usage: "[-l] [-SIG] [-o PID]..."
41 //usage:#define killall5_full_usage "\n\n"
42 //usage: "Send a signal (default: TERM) to all processes outside current session\n"
43 //usage: "\n -l List all signal names and numbers"
44 //usage: "\n -o PID Don't signal this PID"
45 /* //usage: "\n -s SIG Yet another way of specifying SIG" */
49 /* Note: kill_main is directly called from shell in order to implement
50 * kill built-in. Shell substitutes job ids with process groups first.
52 * This brings some complications:
54 * + we can't use xfunc here
55 * + we can't use applet_name
56 * + we can't use bb_show_usage
57 * (Above doesn't apply for killall[5] cases)
59 * kill %n gets translated into kill ' -<process group>' by shell (note space!)
60 * This is needed to avoid collision with kill -9 ... syntax
63 int kill_main(int argc UNUSED_PARAM
, char **argv
)
67 int signo
= SIGTERM
, errors
= 0, quiet
= 0;
68 #if !ENABLE_KILLALL && !ENABLE_KILLALL5
72 /* How to determine who we are? find 3rd char from the end:
73 * kill, killall, killall5
74 * ^i ^a ^l - it's unique
75 * (checking from the start is complicated by /bin/kill... case) */
76 const char char3
= argv
[0][strlen(argv
[0]) - 3];
77 #define killall (ENABLE_KILLALL && char3 == 'a')
78 #define killall5 (ENABLE_KILLALL5 && char3 == 'l')
81 /* Parse any options */
84 if (!arg
|| arg
[0] != '-') {
88 /* The -l option, which prints out signal names.
89 * Intended usage in shell:
90 * echo "Died of SIG`kill -l $?`"
91 * We try to mimic what kill from coreutils-6.8 does */
92 if (arg
[1] == 'l' && arg
[2] == '\0') {
95 /* Print the whole signal list */
101 if (isdigit(arg
[0])) {
102 signo
= bb_strtou(arg
, NULL
, 10);
104 bb_error_msg("unknown signal '%s'", arg
);
107 /* Exitcodes >= 0x80 are to be treated
108 * as "killed by signal (exitcode & 0x7f)" */
109 puts(get_signame(signo
& 0x7f));
110 /* TODO: 'bad' signal# - coreutils says:
111 * kill: 127: invalid signal
112 * we just print "127" instead */
114 signo
= get_signum(arg
);
116 bb_error_msg("unknown signal '%s'", arg
);
119 printf("%d\n", signo
);
126 /* The -q quiet option */
127 if (killall
&& arg
[1] == 'q' && arg
[2] == '\0') {
136 arg
++; /* skip '-' */
138 /* -o PID? (if present, it always is at the end of command line) */
139 if (killall5
&& arg
[0] == 'o')
142 if (argv
[1] && arg
[0] == 's' && arg
[1] == '\0') { /* -s SIG? */
144 } /* else it must be -SIG */
145 signo
= get_signum(arg
);
146 if (signo
< 0) { /* || signo > MAX_SIGNUM ? */
147 bb_error_msg("bad signal name '%s'", arg
);
157 procps_status_t
* p
= NULL
;
158 /* compat: exitcode 2 is "no one was signaled" */
161 /* Find out our session id */
163 /* Stop all processes */
164 if (signo
!= SIGSTOP
&& signo
!= SIGCONT
)
166 /* Signal all processes except those in our session */
167 while ((p
= procps_scan(p
, PSSCAN_PID
|PSSCAN_SID
)) != NULL
) {
170 if (p
->sid
== (unsigned)sid
171 || p
->sid
== 0 /* compat: kernel thread, don't signal it */
172 || p
->pid
== (unsigned)pid
178 /* All remaining args must be -o PID options.
179 * Check p->pid against them. */
185 if (arg
[0] != '-' || arg
[1] != 'o') {
186 bb_error_msg("bad option '%s'", arg
);
191 if (!arg
[0] && *args
)
193 omit
= bb_strtoi(arg
, NULL
, 10);
195 bb_error_msg("invalid number '%s'", arg
);
207 /* And let them continue */
208 if (signo
!= SIGSTOP
&& signo
!= SIGCONT
)
213 /* Pid or name is required for kill/killall */
215 bb_error_msg("you need to specify whom to kill");
220 /* Looks like they want to do a killall. Do that */
224 pidList
= find_pid_by_name(arg
);
228 bb_error_msg("%s: no process killed", arg
);
232 for (pl
= pidList
; *pl
; pl
++) {
235 if (kill(*pl
, signo
) == 0)
239 bb_perror_msg("can't kill pid %d", (int)*pl
);
248 /* Looks like they want to do a kill. Do that */
250 #if ENABLE_ASH || ENABLE_HUSH
252 * We need to support shell's "hack formats" of
253 * " -PRGP_ID" (yes, with a leading space)
254 * and " PID1 PID2 PID3" (with degenerate case "")
256 while (*arg
!= '\0') {
260 pid
= bb_strtoi(arg
, &end
, 10);
261 if (errno
&& (errno
!= EINVAL
|| *end
!= ' ')) {
262 bb_error_msg("invalid number '%s'", arg
);
266 if (kill(pid
, signo
) != 0) {
267 bb_perror_msg("can't kill pid %d", (int)pid
);
270 arg
= end
; /* can only point to ' ' or '\0' now */
273 pid
= bb_strtoi(arg
, NULL
, 10);
275 bb_error_msg("invalid number '%s'", arg
);
277 } else if (kill(pid
, signo
) != 0) {
278 bb_perror_msg("can't kill pid %d", (int)pid
);