1 This file is wait.def, from which is created wait.c.
2 It implements the builtin "wait" 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.
23 $FUNCTION wait_builtin
24 $DEPENDS_ON JOB_CONTROL
27 Wait for the specified process and report its termination status. If
28 N is not given, all currently active child processes are waited for,
29 and the return code is zero. N may be a process ID or a job
30 specification; if a job spec is given, all processes in the job's
31 pipeline are waited for.
35 $FUNCTION wait_builtin
36 $DEPENDS_ON !JOB_CONTROL
38 Wait for the specified process and report its termination status. If
39 N is not given, all currently active child processes are waited for,
40 and the return code is zero. N is a process ID; if it is not given,
41 all child processes of the shell are waited for.
46 #include "../bashtypes.h"
49 #if defined (HAVE_UNISTD_H)
53 #include <chartypes.h>
55 #include "../bashansi.h"
60 #include "bashgetopt.h"
62 extern int interrupt_immediately;
64 procenv_t wait_intr_buf;
66 /* Wait for the pid in LIST to stop or die. If no arguments are given, then
67 wait for all of the active background processes of the shell and return
68 0. If a list of pids or job specs are given, return the exit status of
69 the last one waited for. */
71 #define WAIT_RETURN(s) \
74 interrupt_immediately = old_interrupt_immediately;\
84 volatile int old_interrupt_immediately;
88 if (no_options (list))
93 old_interrupt_immediately = interrupt_immediately;
94 interrupt_immediately++;
96 /* POSIX.2 says: When the shell is waiting (by means of the wait utility)
97 for asynchronous commands to complete, the reception of a signal for
98 which a trap has been set shall cause the wait utility to return
99 immediately with an exit status greater than 128, after which the trap
100 associated with the signal shall be taken.
102 We handle SIGINT here; it's the only one that needs to be treated
103 specially (I think), since it's handled specially in {no,}jobs.c. */
104 code = setjmp (wait_intr_buf);
107 status = 128 + SIGINT;
108 WAIT_RETURN (status);
111 /* We support jobs or pids.
112 wait <pid-or-job> [pid-or-job ...] */
114 /* But wait without any arguments means to wait for all of the shell's
115 currently active background processes. */
118 wait_for_background_pids ();
119 WAIT_RETURN (EXECUTION_SUCCESS);
122 status = EXECUTION_SUCCESS;
129 w = list->word->word;
132 if (legal_number (w, &pid_value) && pid_value == (pid_t)pid_value)
134 pid = (pid_t)pid_value;
135 status = wait_for_single_pid (pid);
139 builtin_error ("`%s' is not a pid or valid job spec", w);
140 WAIT_RETURN (EXECUTION_FAILURE);
143 #if defined (JOB_CONTROL)
144 else if (job_control && *w)
145 /* Must be a job spec. Check it out. */
150 BLOCK_CHILD (set, oset);
151 job = get_job_spec (list);
153 if (job < 0 || job >= job_slots || !jobs[job])
156 builtin_error ("%s: no such job", list->word->word);
157 UNBLOCK_CHILD (oset);
158 status = 127; /* As per Posix.2, section 4.70.2 */
163 /* Job spec used. Wait for the last pid in the pipeline. */
164 UNBLOCK_CHILD (oset);
165 status = wait_for_job (job);
167 else if (job_control == 0 && *w == '%')
169 /* can't use jobspecs as arguments if job control is not active. */
170 builtin_error ("job control not enabled");
171 status = EXECUTION_FAILURE;
173 #endif /* JOB_CONTROL */
176 builtin_error ("`%s' is not a pid or valid job spec", w);
177 status = EXECUTION_FAILURE;
182 WAIT_RETURN (status);