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.
14 //config: The command kill sends the specified signal to the specified
15 //config: process or process group. If no signal is specified, the TERM
16 //config: signal is sent.
18 //config:config KILLALL
19 //config: bool "killall"
22 //config: killall sends a signal to all processes running any of the
23 //config: specified commands. If no signal name is specified, SIGTERM is
26 //config:config KILLALL5
27 //config: bool "killall5"
30 //config: The SystemV killall command. killall5 sends a signal
31 //config: to all processes except kernel threads and the processes
32 //config: in its own session, so it won't kill the shell that is running
33 //config: the script it was called from.
35 //applet:IF_KILL(APPLET(kill, BB_DIR_BIN, BB_SUID_DROP))
36 // APPLET_ODDNAME:name main location suid_type help
37 //applet:IF_KILLALL( APPLET_ODDNAME(killall, kill, BB_DIR_USR_BIN, BB_SUID_DROP, killall))
38 //applet:IF_KILLALL5(APPLET_ODDNAME(killall5, kill, BB_DIR_USR_SBIN, BB_SUID_DROP, killall5))
40 //kbuild:lib-$(CONFIG_KILL) += kill.o
41 //kbuild:lib-$(CONFIG_KILLALL) += kill.o
42 //kbuild:lib-$(CONFIG_KILLALL5) += kill.o
44 //usage:#define kill_trivial_usage
45 //usage: "[-l] [-SIG] PID..."
46 //usage:#define kill_full_usage "\n\n"
47 //usage: "Send a signal (default: TERM) to given PIDs\n"
48 //usage: "\n -l List all signal names and numbers"
49 /* //usage: "\n -s SIG Yet another way of specifying SIG" */
51 //usage:#define kill_example_usage
52 //usage: "$ ps | grep apache\n"
53 //usage: "252 root root S [apache]\n"
54 //usage: "263 www-data www-data S [apache]\n"
55 //usage: "264 www-data www-data S [apache]\n"
56 //usage: "265 www-data www-data S [apache]\n"
57 //usage: "266 www-data www-data S [apache]\n"
58 //usage: "267 www-data www-data S [apache]\n"
59 //usage: "$ kill 252\n"
61 //usage:#define killall_trivial_usage
62 //usage: "[-l] [-q] [-SIG] PROCESS_NAME..."
63 //usage:#define killall_full_usage "\n\n"
64 //usage: "Send a signal (default: TERM) to given processes\n"
65 //usage: "\n -l List all signal names and numbers"
66 /* //usage: "\n -s SIG Yet another way of specifying SIG" */
67 //usage: "\n -q Don't complain if no processes were killed"
69 //usage:#define killall_example_usage
70 //usage: "$ killall apache\n"
72 //usage:#define killall5_trivial_usage
73 //usage: "[-l] [-SIG] [-o PID]..."
74 //usage:#define killall5_full_usage "\n\n"
75 //usage: "Send a signal (default: TERM) to all processes outside current session\n"
76 //usage: "\n -l List all signal names and numbers"
77 //usage: "\n -o PID Don't signal this PID"
78 /* //usage: "\n -s SIG Yet another way of specifying SIG" */
82 /* Note: kill_main is directly called from shell in order to implement
83 * kill built-in. Shell substitutes job ids with process groups first.
85 * This brings some complications:
87 * + we can't use xfunc here
88 * + we can't use applet_name
89 * + we can't use bb_show_usage
90 * (Above doesn't apply for killall[5] cases)
92 * kill %n gets translated into kill ' -<process group>' by shell (note space!)
93 * This is needed to avoid collision with kill -9 ... syntax
96 //kbuild:lib-$(CONFIG_ASH_JOB_CONTROL) += kill.o
97 //kbuild:lib-$(CONFIG_HUSH_KILL) += kill.o
99 #define SH_KILL (ENABLE_ASH_JOB_CONTROL || ENABLE_HUSH_KILL)
100 /* If shells want to have "kill", for ifdefs it's like ENABLE_KILL=1 */
103 # define ENABLE_KILL 1
105 #define KILL_APPLET_CNT (ENABLE_KILL + ENABLE_KILLALL + ENABLE_KILLALL5)
107 int kill_main(int argc UNUSED_PARAM, char **argv)
111 int signo = SIGTERM, errors = 0, quiet = 0;
113 #if KILL_APPLET_CNT == 1
114 # define is_killall ENABLE_KILLALL
115 # define is_killall5 ENABLE_KILLALL5
117 /* How to determine who we are? find 3rd char from the end:
118 * kill, killall, killall5
119 * ^i ^a ^l - it's unique
120 * (checking from the start is complicated by /bin/kill... case) */
121 const char char3 = argv[0][strlen(argv[0]) - 3];
122 # define is_killall (ENABLE_KILLALL && char3 == 'a')
123 # define is_killall5 (ENABLE_KILLALL5 && char3 == 'l')
126 /* Parse any options */
129 if (!arg || arg[0] != '-') {
133 /* The -l option, which prints out signal names.
134 * Intended usage in shell:
135 * echo "Died of SIG`kill -l $?`"
136 * We try to mimic what kill from coreutils-6.8 does */
137 if (arg[1] == 'l' && arg[2] == '\0') {
140 /* Print the whole signal list */
146 if (isdigit(arg[0])) {
147 signo = bb_strtou(arg, NULL, 10);
149 bb_error_msg("unknown signal '%s'", arg);
152 /* Exitcodes >= 0x80 are to be treated
153 * as "killed by signal (exitcode & 0x7f)" */
154 puts(get_signame(signo & 0x7f));
155 /* TODO: 'bad' signal# - coreutils says:
156 * kill: 127: invalid signal
157 * we just print "127" instead */
159 signo = get_signum(arg);
161 bb_error_msg("unknown signal '%s'", arg);
164 printf("%d\n", signo);
171 /* The -q quiet option */
172 if (is_killall && arg[1] == 'q' && arg[2] == '\0') {
181 arg++; /* skip '-' */
183 /* -o PID? (if present, it always is at the end of command line) */
184 if (is_killall5 && arg[0] == 'o')
187 if (argv[1] && arg[0] == 's' && arg[1] == '\0') { /* -s SIG? */
189 } /* else it must be -SIG */
190 signo = get_signum(arg);
191 if (signo < 0) { /* || signo > MAX_SIGNUM ? */
192 bb_error_msg("bad signal name '%s'", arg);
202 procps_status_t* p = NULL;
203 /* compat: exitcode 2 is "no one was signaled" */
206 /* Find out our session id */
208 /* Stop all processes */
209 if (signo != SIGSTOP && signo != SIGCONT)
211 /* Signal all processes except those in our session */
212 while ((p = procps_scan(p, PSSCAN_PID|PSSCAN_SID)) != NULL) {
215 if (p->sid == (unsigned)sid
216 || p->sid == 0 /* compat: kernel thread, don't signal it */
217 || p->pid == (unsigned)pid
223 /* All remaining args must be -o PID options.
224 * Check p->pid against them. */
230 if (arg[0] != '-' || arg[1] != 'o') {
231 bb_error_msg("bad option '%s'", arg);
236 if (!arg[0] && *args)
238 omit = bb_strtoi(arg, NULL, 10);
240 bb_error_msg("invalid number '%s'", arg);
252 /* And let them continue */
253 if (signo != SIGSTOP && signo != SIGCONT)
258 #if ENABLE_KILL || ENABLE_KILLALL
259 /* Pid or name is required for kill/killall */
261 bb_error_msg("you need to specify whom to kill");
265 if (!ENABLE_KILL || is_killall) {
266 /* Looks like they want to do a killall. Do that */
270 pidList = find_pid_by_name(arg);
274 bb_error_msg("%s: no process killed", arg);
278 for (pl = pidList; *pl; pl++) {
281 if (kill(*pl, signo) == 0)
285 bb_perror_msg("can't kill pid %d", (int)*pl);
296 /* Looks like they want to do a kill. Do that */
300 * We need to support shell's "hack formats" of
301 * " -PRGP_ID" (yes, with a leading space)
302 * and " PID1 PID2 PID3" (with degenerate case "")
304 while (*arg != '\0') {
308 pid = bb_strtoi(arg, &end, 10);
309 if (errno && (errno != EINVAL || *end != ' ')) {
310 bb_error_msg("invalid number '%s'", arg);
314 if (kill(pid, signo) != 0) {
315 bb_perror_msg("can't kill pid %d", (int)pid);
318 arg = end; /* can only point to ' ' or '\0' now */
320 # else /* ENABLE_KILL but !SH_KILL */
321 pid = bb_strtoi(arg, NULL, 10);
323 bb_error_msg("invalid number '%s'", arg);
325 } else if (kill(pid, signo) != 0) {
326 bb_perror_msg("can't kill pid %d", (int)pid);