2 * Copyright (c) 1988, 1993, 1994
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 * must display the following acknowledgement:
15 * This product includes software developed by the University of
16 * California, Berkeley and its contributors.
17 * 4. Neither the name of the University nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 * oct 5 1994 -- almost entirely re-written to allow for process names.
35 * modifications (c) salvatore valente <svalente@mit.edu>
36 * may be used / modified / distributed under the same terms as the original.
38 * 1999-02-22 Arkadiusz MiĆkiewicz <misiek@pld.ORG.PL>
39 * - added Native Language Support
41 * 1999-11-13 aeb Accept signal numbers 128+s.
43 * Copyright (C) 2014 Sami Kerola <kerolasa@iki.fi>
44 * Copyright (C) 2014 Karel Zak <kzak@redhat.com>
47 #include <ctype.h> /* for isdigit() */
55 #include "closestream.h"
57 #include "pidfd-utils.h"
58 #include "procutils.h"
64 /* partial success, otherwise we return regular EXIT_{SUCCESS,FAILURE} */
65 #define KILL_EXIT_SOMEOK 64
68 KILL_FIELD_WIDTH
= 11,
69 KILL_OUTPUT_WIDTH
= 72
78 struct list_head follow_ups
;
90 struct list_head follow_ups
;
103 static void print_signal_name(int signum
)
105 const char *name
= signum_to_signame(signum
);
108 printf("%s\n", name
);
112 if (SIGRTMIN
<= signum
&& signum
<= SIGRTMAX
) {
113 printf("RT%d\n", signum
- SIGRTMIN
);
117 printf("%d\n", signum
);
120 static void pretty_print_signal(FILE *fp
, size_t term_width
, size_t *lpos
,
121 int signum
, const char *name
)
123 if (term_width
< (*lpos
+ KILL_FIELD_WIDTH
)) {
127 *lpos
+= KILL_FIELD_WIDTH
;
128 fprintf(fp
, "%2d %-8s", signum
, name
);
131 static void print_all_signals(FILE *fp
, int pretty
)
133 size_t n
, lth
, lpos
= 0, width
;
134 const char *signame
= NULL
;
138 for (n
= 0; get_signame_by_idx(n
, &signame
, NULL
) == 0; n
++) {
139 lth
= 1 + strlen(signame
);
140 if (KILL_OUTPUT_WIDTH
< lpos
+ lth
) {
149 fputs(" RT<N> RTMIN+<N> RTMAX-<N>", fp
);
156 width
= get_terminal_width(KILL_OUTPUT_WIDTH
+ 1) - 1;
157 for (n
= 0; get_signame_by_idx(n
, &signame
, &signum
) == 0; n
++)
158 pretty_print_signal(fp
, width
, &lpos
, signum
, signame
);
160 pretty_print_signal(fp
, width
, &lpos
, SIGRTMIN
, "RTMIN");
161 pretty_print_signal(fp
, width
, &lpos
, SIGRTMAX
, "RTMAX");
166 static void err_nosig(char *name
)
168 warnx(_("unknown signal %s; valid signals:"), name
);
169 print_all_signals(stderr
, 1);
173 static int arg_to_signum(char *arg
, int maskbit
)
179 numsig
= strtol(arg
, &ep
, 10);
180 if (NSIG
<= numsig
&& maskbit
&& (numsig
& 128) != 0)
182 if (*ep
!= 0 || numsig
< 0 || NSIG
<= numsig
)
186 return signame_to_signum(arg
);
189 static void __attribute__((__noreturn__
)) usage(void)
192 fputs(USAGE_HEADER
, out
);
193 fprintf(out
, _(" %s [options] <pid>|<name>...\n"), program_invocation_short_name
);
195 fputs(USAGE_SEPARATOR
, out
);
196 fputs(_("Forcibly terminate a process.\n"), out
);
198 fputs(USAGE_OPTIONS
, out
);
199 fputs(_(" -a, --all do not restrict the name-to-pid conversion to processes\n"
200 " with the same uid as the present process\n"), out
);
201 fputs(_(" -s, --signal <signal> send this <signal> instead of SIGTERM\n"), out
);
203 fputs(_(" -q, --queue <value> use sigqueue(2), not kill(2), and pass <value> as data\n"), out
);
206 fputs(_(" --timeout <milliseconds> <follow-up signal>\n"
207 " wait up to timeout and send follow-up signal\n"), out
);
209 fputs(_(" -p, --pid print pids without signaling them\n"), out
);
210 fputs(_(" -l, --list[=<signal>] list signal names, or convert a signal number to a name\n"), out
);
211 fputs(_(" -L, --table list signal names and numbers\n"), out
);
212 fputs(_(" --verbose print pids that will be signaled\n"), out
);
214 fputs(USAGE_SEPARATOR
, out
);
215 printf(USAGE_HELP_OPTIONS(24));
216 printf(USAGE_MAN_TAIL("kill(1)"));
221 static void __attribute__((__noreturn__
)) print_kill_version(void)
223 static const char *features
[] = {
232 printf(_("%s from %s"), program_invocation_short_name
, PACKAGE_STRING
);
234 if (ARRAY_SIZE(features
)) {
236 fputs(_(" (with: "), stdout
);
237 for (i
= 0; i
< ARRAY_SIZE(features
); i
++) {
238 fputs(features
[i
], stdout
);
239 if (i
+ 1 < ARRAY_SIZE(features
))
242 fputs(")\n", stdout
);
247 static char **parse_arguments(int argc
, char **argv
, struct kill_control
*ctl
)
251 /* Loop through the arguments. Actually, -a is the only option
252 * can be used with other options. The 'kill' is basically a
253 * one-option-at-most program. */
254 for (argc
--, argv
++; 0 < argc
; argc
--, argv
++) {
258 if (!strcmp(arg
, "--")) {
262 if (!strcmp(arg
, "-v") || !strcmp(arg
, "-V") ||
263 !strcmp(arg
, "--version"))
264 print_kill_version();
265 if (!strcmp(arg
, "-h") || !strcmp(arg
, "--help"))
267 if (!strcmp(arg
, "--verbose")) {
271 if (!strcmp(arg
, "-a") || !strcmp(arg
, "--all")) {
275 if (!strcmp(arg
, "-l") || !strcmp(arg
, "--list")) {
277 print_all_signals(stdout
, 0);
281 errx(EXIT_FAILURE
, _("too many arguments"));
282 /* argc == 2, accept "kill -l $?" */
284 if ((ctl
->numsig
= arg_to_signum(arg
, 1)) < 0)
285 errx(EXIT_FAILURE
, _("unknown signal: %s"),
287 print_signal_name(ctl
->numsig
);
290 /* for compatibility with procps kill(1) */
291 if (!strncmp(arg
, "--list=", 7) || !strncmp(arg
, "-l=", 3)) {
292 char *p
= strchr(arg
, '=') + 1;
293 if ((ctl
->numsig
= arg_to_signum(p
, 1)) < 0)
294 errx(EXIT_FAILURE
, _("unknown signal: %s"), p
);
295 print_signal_name(ctl
->numsig
);
298 if (!strcmp(arg
, "-L") || !strcmp(arg
, "--table")) {
299 print_all_signals(stdout
, 1);
302 if (!strcmp(arg
, "-p") || !strcmp(arg
, "--pid")) {
305 errx(EXIT_FAILURE
, _("%s and %s are mutually exclusive"), "--pid", "--signal");
308 errx(EXIT_FAILURE
, _("%s and %s are mutually exclusive"), "--pid", "--queue");
312 if (!strcmp(arg
, "-s") || !strcmp(arg
, "--signal")) {
314 errx(EXIT_FAILURE
, _("not enough arguments"));
317 errx(EXIT_FAILURE
, _("%s and %s are mutually exclusive"), "--pid", "--signal");
320 if ((ctl
->numsig
= arg_to_signum(arg
, 0)) < 0)
325 if (!strcmp(arg
, "-q") || !strcmp(arg
, "--queue")) {
327 errx(EXIT_FAILURE
, _("option '%s' requires an argument"), arg
);
329 errx(EXIT_FAILURE
, _("%s and %s are mutually exclusive"), "--pid", "--queue");
332 ctl
->sigdata
.sival_int
= strtos32_or_err(arg
, _("argument error"));
338 if (!strcmp(arg
, "--timeout")) {
339 struct timeouts
*next
;
343 errx(EXIT_FAILURE
, _("option '%s' requires an argument"), arg
);
346 next
= xcalloc(1, sizeof(*next
));
347 next
->period
= strtos32_or_err(arg
, _("argument error"));
348 INIT_LIST_HEAD(&next
->follow_ups
);
351 if ((next
->sig
= arg_to_signum(arg
, 0)) < 0)
353 list_add_tail(&next
->follow_ups
, &ctl
->follow_ups
);
357 /* 'arg' begins with a dash but is not a known option.
358 * So it's probably something like -HUP, or -1/-n try to
361 * -n could be either signal n or pid -n (a process group
362 * number). In case of doubt, POSIX tells us to assume a
363 * signal. But if a signal has already been parsed, then
364 * assume it is a process group, so stop parsing options. */
368 if ((ctl
->numsig
= arg_to_signum(arg
, 0)) < 0)
369 errx(EXIT_FAILURE
, _("invalid signal name or number: %s"), arg
);
372 errx(EXIT_FAILURE
, _("%s and %s are mutually exclusive"), "--pid", "--signal");
375 errx(EXIT_FAILURE
, _("not enough arguments"));
380 static int kill_with_timeout(const struct kill_control
*ctl
)
383 struct pollfd p
= { 0 };
384 siginfo_t info
= { 0 };
385 struct list_head
*entry
;
387 info
.si_code
= SI_QUEUE
;
388 info
.si_signo
= ctl
->numsig
;
389 info
.si_uid
= getuid();
390 info
.si_pid
= getpid();
391 info
.si_value
.sival_int
=
392 ctl
->use_sigval
!= 0 ? ctl
->use_sigval
: ctl
->numsig
;
394 if ((pfd
= pidfd_open(ctl
->pid
, 0)) < 0)
395 err(EXIT_FAILURE
, _("pidfd_open() failed: %d"), ctl
->pid
);
399 if (pidfd_send_signal(pfd
, ctl
->numsig
, &info
, 0) < 0)
400 err(EXIT_FAILURE
, _("pidfd_send_signal() failed"));
401 list_for_each(entry
, &ctl
->follow_ups
) {
402 struct timeouts
*timeout
;
404 timeout
= list_entry(entry
, struct timeouts
, follow_ups
);
405 n
= poll(&p
, 1, timeout
->period
);
407 err(EXIT_FAILURE
, _("poll() failed"));
409 info
.si_signo
= timeout
->sig
;
411 printf(_("timeout, sending signal %d to pid %d\n"),
412 timeout
->sig
, ctl
->pid
);
413 if (pidfd_send_signal(pfd
, timeout
->sig
, &info
, 0) < 0)
414 err(EXIT_FAILURE
, _("pidfd_send_signal() failed"));
421 static int kill_verbose(const struct kill_control
*ctl
)
426 printf(_("sending signal %d to pid %d\n"), ctl
->numsig
, ctl
->pid
);
428 printf("%ld\n", (long) ctl
->pid
);
433 rc
= kill_with_timeout(ctl
);
438 rc
= sigqueue(ctl
->pid
, ctl
->numsig
, ctl
->sigdata
);
441 rc
= kill(ctl
->pid
, ctl
->numsig
);
444 warn(_("sending signal to %s failed"), ctl
->arg
);
448 int main(int argc
, char **argv
)
450 struct kill_control ctl
= { .numsig
= SIGTERM
};
451 int nerrs
= 0, ct
= 0;
453 setlocale(LC_ALL
, "");
454 bindtextdomain(PACKAGE
, LOCALEDIR
);
456 close_stdout_atexit();
459 INIT_LIST_HEAD(&ctl
.follow_ups
);
461 argv
= parse_arguments(argc
, argv
, &ctl
);
463 /* The rest of the arguments should be process ids and names. */
464 for ( ; (ctl
.arg
= *argv
) != NULL
; argv
++) {
468 ctl
.pid
= strtol(ctl
.arg
, &ep
, 10);
469 if (errno
== 0 && ep
&& *ep
== '\0' && ctl
.arg
< ep
) {
470 if (kill_verbose(&ctl
) != 0)
474 struct proc_processes
*ps
= proc_open_processes();
480 proc_processes_filter_by_uid(ps
, getuid());
482 proc_processes_filter_by_name(ps
, ctl
.arg
);
483 while (proc_next_pid(ps
, &ctl
.pid
) == 0) {
484 if (kill_verbose(&ctl
) != 0)
489 proc_close_processes(ps
);
493 warnx(_("cannot find process \"%s\""), ctl
.arg
);
499 while (!list_empty(&ctl
.follow_ups
)) {
500 struct timeouts
*x
= list_entry(ctl
.follow_ups
.next
,
501 struct timeouts
, follow_ups
);
502 list_del(&x
->follow_ups
);
506 if (ct
&& nerrs
== 0)
507 return EXIT_SUCCESS
; /* full success */
509 return EXIT_FAILURE
; /* all failed */
511 return KILL_EXIT_SOMEOK
; /* partial success */