1 This file is kill.def, from which is created kill.c.
2 It implements the builtin "kill" in Bash.
4 Copyright (C) 1987, 1989, 1991 Free Software Foundation, Inc.
6 This file is part of GNU Bash, the Bourne Again SHell.
8 Bash is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 2, or (at your option) any later
13 Bash is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 You should have received a copy of the GNU General Public License along
19 with Bash; see the file COPYING. If not, write to the Free Software
20 Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
25 $FUNCTION kill_builtin
26 $DEPENDS_ON JOB_CONTROL
27 $SHORT_DOC kill [-s sigspec | -n signum | -sigspec] [pid | job]... or kill -l [sigspec]
28 Send the processes named by PID (or JOB) the signal SIGSPEC. If
29 SIGSPEC is not present, then SIGTERM is assumed. An argument of `-l'
30 lists the signal names; if arguments follow `-l' they are assumed to
31 be signal numbers for which names should be listed. Kill is a shell
32 builtin for two reasons: it allows job IDs to be used instead of
33 process IDs, and, if you have reached the limit on processes that
34 you can create, you don't have to start a process to kill another one.
41 #if defined (HAVE_UNISTD_H)
43 # include <sys/types.h>
48 #include "../bashansi.h"
55 /* Not all systems declare ERRNO in errno.h... and some systems #define it! */
60 #if defined (JOB_CONTROL)
61 extern int interactive;
62 extern int job_control;
63 extern int posixly_correct;
65 #if !defined (CONTINUE_AFTER_KILL_ERROR)
66 # define CONTINUE_OR_FAIL return (EXECUTION_FAILURE)
68 # define CONTINUE_OR_FAIL goto continue_killing
69 #endif /* CONTINUE_AFTER_KILL_ERROR */
71 /* Here is the kill builtin. We only have it so that people can type
72 kill -KILL %1? No, if you fill up the process table this way you
73 can still kill some. */
78 int signal, any_succeeded, listing, saw_signal;
85 return (EXECUTION_FAILURE);
88 any_succeeded = listing = saw_signal = 0;
92 /* Process options. */
95 word = list->word->word;
97 if (ISOPTION (word, 'l'))
102 else if (ISOPTION (word, 's') || ISOPTION (word, 'n'))
107 sigspec = list->word->word;
108 if (sigspec[0] == '0' && sigspec[1] == '\0')
111 signal = decode_signal (sigspec);
116 builtin_error ("%s requires an argument", word);
117 return (EXECUTION_FAILURE);
120 else if (ISOPTION (word, '-'))
125 else if (ISOPTION (word, '?'))
128 return (EXECUTION_SUCCESS);
130 /* If this is a signal specification then process it. We only process
131 the first one seen; other arguments may signify process groups (e.g,
132 -num == process group num). */
133 else if ((*word == '-') && !saw_signal)
136 signal = decode_signal (sigspec);
145 return (display_signal_list (list, 0));
147 /* OK, we are killing processes. */
148 if (signal == NO_SIG)
150 builtin_error ("bad signal spec `%s'", sigspec);
151 return (EXECUTION_FAILURE);
157 return (EXECUTION_FAILURE);
162 word = list->word->word;
167 if (*word && all_digits (word))
169 /* Use the entire argument in case of minus sign presence. */
170 pid = (pid_t) atoi (list->word->word);
172 if (kill_pid (pid, signal, 0) < 0)
177 else if (*list->word->word && *list->word->word != '%')
179 builtin_error ("%s: no such pid", list->word->word);
182 else if (*word && (interactive || job_control))
183 /* Posix.2 says you can kill without job control active (4.32.4) */
184 { /* Must be a job spec. Check it out. */
188 BLOCK_CHILD (set, oset);
189 job = get_job_spec (list);
191 if (job < 0 || job >= job_slots || !jobs[job])
194 builtin_error ("%s: no such job", list->word->word);
195 UNBLOCK_CHILD (oset);
199 /* Job spec used. Kill the process group. If the job was started
200 without job control, then its pgrp == shell_pgrp, so we have
201 to be careful. We take the pid of the first job in the pipeline
203 pid = IS_JOBCONTROL (job) ? jobs[job]->pgrp : jobs[job]->pipe->pid;
205 UNBLOCK_CHILD (oset);
207 if (kill_pid (pid, signal, 1) < 0)
211 builtin_error ("(%d) - Not owner", (int)pid);
212 else if (errno == ESRCH)
213 builtin_error ("(%d) - No such pid", (int)pid);
215 builtin_error ("Invalid signal %d", signal);
223 builtin_error ("`%s': not a pid or valid job spec", list->word->word);
230 return (any_succeeded ? EXECUTION_SUCCESS : EXECUTION_FAILURE);
232 #endif /* JOB_CONTROL */