1 /* kill -- send a signal to a process
2 Copyright (C) 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2, or (at your option)
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software Foundation,
16 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
18 /* Written by Paul Eggert. */
23 #include <sys/types.h>
27 # include <sys/wait.h>
30 # define WIFSIGNALED(s) (((s) & 0xFFFF) - 1 < (unsigned int) 0xFF)
33 # define WTERMSIG(s) ((s) & 0x7F)
40 /* The official name of this program (e.g., no `g' prefix). */
41 #define PROGRAM_NAME "kill"
43 #define AUTHORS "Paul Eggert"
45 #if ! (HAVE_DECL_STRSIGNAL || defined strsignal)
46 # if ! (HAVE_DECL_SYS_SIGLIST || defined sys_siglist)
47 # if HAVE_DECL__SYS_SIGLIST || defined _sys_siglist
48 # define sys_siglist _sys_siglist
49 # elif HAVE_DECL___SYS_SIGLIST || defined __sys_siglist
50 # define sys_siglist __sys_siglist
53 # if HAVE_DECL_SYS_SIGLIST || defined sys_siglist
54 # define strsignal(signum) (0 <= (signum) && (signum) <= SIGNUM_BOUND \
55 ? sys_siglist[signum] \
59 # define strsignal(signum) 0
63 /* The name this program was run with, for error messages. */
66 static char const short_options
[] =
67 "0::1::2::3::4::5::6::7::8::9::"
68 "A::B::C::D::E::F::G::H::I::J::K::L::M::"
69 "N::O::P::Q::R::S::T::U::V::W::X::Y::Z::"
72 static struct option
const long_options
[] =
74 {"list", no_argument
, NULL
, 'l'},
75 {"signal", required_argument
, NULL
, 's'},
76 {"table", no_argument
, NULL
, 't'},
77 {GETOPT_HELP_OPTION_DECL
},
78 {GETOPT_VERSION_OPTION_DECL
},
85 if (status
!= EXIT_SUCCESS
)
86 fprintf (stderr
, _("Try `%s --help' for more information.\n"),
91 Usage: %s [-s SIGNAL | -SIGNAL] PID...\n\
92 or: %s -l [SIGNAL]...\n\
93 or: %s -t [SIGNAL]...\n\
95 program_name
, program_name
, program_name
);
97 Send signals to processes, or list signals.\n\
101 Mandatory arguments to long options are mandatory for short options too.\n\
104 -s, --signal=SIGNAL, -SIGNAL\n\
105 specify the name or number of the signal to be sent\n\
106 -l, --list list signal names, or convert signal names to/from numbers\n\
107 -t, --table print a table of signal information\n\
109 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
110 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
112 SIGNAL may be a signal name like `HUP', or a signal number like `1',\n\
113 or an exit status of a process terminated by a signal.\n\
114 PID is an integer; if negative it identifies a process group.\n\
116 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
117 emit_bug_reporting_address ();
122 /* Convert OPERAND to a signal number with printable representation SIGNAME.
123 Return the signal number, or -1 if unsuccessful. */
126 operand2sig (char const *operand
, char *signame
)
130 if (ISDIGIT (*operand
))
133 long int l
= (errno
= 0, strtol (operand
, &endp
, 10));
135 signum
= (operand
== endp
|| *endp
|| errno
|| i
!= l
? -1
136 : WIFSIGNALED (i
) ? WTERMSIG (i
)
141 /* Convert signal to upper case in the C locale, not in the
142 current locale. Don't assume ASCII; it might be EBCDIC. */
143 char *upcased
= xstrdup (operand
);
145 for (p
= upcased
; *p
; p
++)
146 if (strchr ("abcdefghijklmnopqrstuvwxyz", *p
))
149 /* Look for the signal name, possibly prefixed by "SIG",
150 and possibly lowercased. */
151 if (! (str2sig (upcased
, &signum
) == 0
152 || (upcased
[0] == 'S' && upcased
[1] == 'I' && upcased
[2] == 'G'
153 && str2sig (upcased
+ 3, &signum
) == 0)))
159 if (signum
< 0 || sig2str (signum
, signame
) != 0)
161 error (0, 0, _("%s: invalid signal"), operand
);
168 /* Print a row of `kill -t' output. NUM_WIDTH is the maximum signal
169 number width, and SIGNUM is the signal number to print. The
170 maximum name width is NAME_WIDTH, and SIGNAME is the name to print. */
173 print_table_row (unsigned int num_width
, int signum
,
174 unsigned int name_width
, char const *signame
)
176 char const *description
= strsignal (signum
);
177 printf ("%*d %-*s %s\n", num_width
, signum
, name_width
, signame
,
178 description
? description
: "?");
181 /* Print a list of signal names. If TABLE, print a table.
182 Print the names specified by ARGV if nonzero; otherwise,
183 print all known names. Return a suitable exit status. */
186 list_signals (bool table
, char *const *argv
)
189 int status
= EXIT_SUCCESS
;
190 char signame
[SIG2STR_MAX
];
194 unsigned int name_width
= 0;
196 /* Compute the maximum width of a signal number. */
197 unsigned int num_width
= 1;
198 for (signum
= 1; signum
<= SIGNUM_BOUND
/ 10; signum
*= 10)
201 /* Compute the maximum width of a signal name. */
202 for (signum
= 1; signum
<= SIGNUM_BOUND
; signum
++)
203 if (sig2str (signum
, signame
) == 0)
205 size_t len
= strlen (signame
);
206 if (name_width
< len
)
211 for (; *argv
; argv
++)
213 signum
= operand2sig (*argv
, signame
);
215 status
= EXIT_FAILURE
;
217 print_table_row (num_width
, signum
, name_width
, signame
);
220 for (signum
= 1; signum
<= SIGNUM_BOUND
; signum
++)
221 if (sig2str (signum
, signame
) == 0)
222 print_table_row (num_width
, signum
, name_width
, signame
);
227 for (; *argv
; argv
++)
229 signum
= operand2sig (*argv
, signame
);
231 status
= EXIT_FAILURE
;
234 if (ISDIGIT (**argv
))
237 printf ("%d\n", signum
);
241 for (signum
= 1; signum
<= SIGNUM_BOUND
; signum
++)
242 if (sig2str (signum
, signame
) == 0)
249 /* Send signal SIGNUM to all the processes or process groups specified
250 by ARGV. Return a suitable exit status. */
253 send_signals (int signum
, char *const *argv
)
255 int status
= EXIT_SUCCESS
;
256 char const *arg
= *argv
;
261 intmax_t n
= (errno
= 0, strtoimax (arg
, &endp
, 10));
264 if (errno
== ERANGE
|| pid
!= n
|| arg
== endp
|| *endp
)
266 error (0, 0, _("%s: invalid process id"), arg
);
267 status
= EXIT_FAILURE
;
269 else if (kill (pid
, signum
) != 0)
271 error (0, errno
, "%s", arg
);
272 status
= EXIT_FAILURE
;
275 while ((arg
= *++argv
));
281 main (int argc
, char **argv
)
287 char signame
[SIG2STR_MAX
];
289 initialize_main (&argc
, &argv
);
290 program_name
= argv
[0];
291 setlocale (LC_ALL
, "");
292 bindtextdomain (PACKAGE
, LOCALEDIR
);
293 textdomain (PACKAGE
);
295 atexit (close_stdout
);
297 while ((optc
= getopt_long (argc
, argv
, short_options
, long_options
, NULL
))
301 case '0': case '1': case '2': case '3': case '4':
302 case '5': case '6': case '7': case '8': case '9':
305 /* This option is actually a process-id. */
307 goto no_more_options
;
310 case 'A': case 'B': case 'C': case 'D': case 'E':
311 case 'F': case 'G': case 'H': case 'I': case 'J':
312 case 'K': case 'L': case 'M': case 'N': case 'O':
313 case 'P': case 'Q': case 'R': case 'S': case 'T':
314 case 'U': case 'V': case 'W': case 'X': case 'Y':
317 optarg
= argv
[optind
- 1] + strlen (argv
[optind
- 1]);
318 if (optarg
!= argv
[optind
- 1] + 2)
320 error (0, 0, _("invalid option -- %c"), optc
);
321 usage (EXIT_FAILURE
);
325 case 'n': /* -n is not documented, but is for Bash compatibility. */
329 error (0, 0, _("%s: multiple signals specified"), optarg
);
330 usage (EXIT_FAILURE
);
332 signum
= operand2sig (optarg
, signame
);
334 usage (EXIT_FAILURE
);
343 error (0, 0, _("multiple -l or -t options specified"));
344 usage (EXIT_FAILURE
);
349 case_GETOPT_HELP_CHAR
;
350 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
352 usage (EXIT_FAILURE
);
360 error (0, 0, _("cannot combine signal with -l or -t"));
361 usage (EXIT_FAILURE
);
364 if ( ! list
&& argc
<= optind
)
366 error (0, 0, _("no process ID specified"));
367 usage (EXIT_FAILURE
);
371 ? list_signals (table
, optind
< argc
? argv
+ optind
: NULL
)
372 : send_signals (signum
, argv
+ optind
));