jobs.c revision 1.123 1 /* $NetBSD: jobs.c,v 1.123 2024/10/09 13:43:32 kre Exp $ */
2
3 /*-
4 * Copyright (c) 1991, 1993
5 * The Regents of the University of California. All rights reserved.
6 *
7 * This code is derived from software contributed to Berkeley by
8 * Kenneth Almquist.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. Neither the name of the University nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 * SUCH DAMAGE.
33 */
34
35 #include <sys/cdefs.h>
36 #ifndef lint
37 #if 0
38 static char sccsid[] = "@(#)jobs.c 8.5 (Berkeley) 5/4/95";
39 #else
40 __RCSID("$NetBSD: jobs.c,v 1.123 2024/10/09 13:43:32 kre Exp $");
41 #endif
42 #endif /* not lint */
43
44 #include <stdio.h>
45 #include <fcntl.h>
46 #include <signal.h>
47 #include <errno.h>
48 #include <unistd.h>
49 #include <stdlib.h>
50 #include <paths.h>
51 #include <sys/types.h>
52 #include <sys/param.h>
53 #ifdef BSD
54 #include <sys/wait.h>
55 #include <sys/time.h>
56 #include <sys/resource.h>
57 #endif
58 #include <sys/ioctl.h>
59
60 #include "shell.h"
61 #if JOBS
62 #if OLD_TTY_DRIVER
63 #include "sgtty.h"
64 #else
65 #include <termios.h>
66 #endif
67 #undef CEOF /* syntax.h redefines this */
68 #endif
69 #include "redir.h"
70 #include "show.h"
71 #include "main.h"
72 #include "parser.h"
73 #include "nodes.h"
74 #include "jobs.h"
75 #include "var.h"
76 #include "options.h"
77 #include "builtins.h"
78 #include "trap.h"
79 #include "syntax.h"
80 #include "input.h"
81 #include "output.h"
82 #include "memalloc.h"
83 #include "error.h"
84 #include "mystring.h"
85
86
87 #ifndef WCONTINUED
88 #define WCONTINUED 0 /* So we can compile on old systems */
89 #endif
90 #ifndef WIFCONTINUED
91 #define WIFCONTINUED(x) (0) /* ditto */
92 #endif
93
94
95 static struct job *jobtab; /* array of jobs */
96 static int njobs; /* size of array */
97 static int jobs_invalid; /* set in child */
98 MKINIT pid_t backgndpid = -1; /* pid of last background process */
99 #if JOBS
100 int initialpgrp; /* pgrp of shell on invocation */
101 static int curjob = -1; /* current job */
102 #endif
103 static int ttyfd = -1;
104
105 STATIC void restartjob(struct job *);
106 STATIC void freejob(struct job *);
107 STATIC struct job *getjob(const char *, int);
108 STATIC int dowait(int, struct job *, struct job **);
109 #define WBLOCK 1
110 #define WNOFREE 2
111 #define WSILENT 4
112 STATIC int jobstatus(const struct job *, int);
113 STATIC int waitproc(int, struct job *, int *);
114 STATIC int cmdtxt(union node *, int);
115 STATIC void cmdlist(union node *, int);
116 STATIC void cmdputs(const char *);
117 inline static void cmdputi(int);
118
119 #define JNUM(j) ((int)((j) != NULL ? ((j) - jobtab) + 1 : 0))
120
121 #ifdef SYSV
122 STATIC int onsigchild(void);
123 #endif
124
125 #ifdef OLD_TTY_DRIVER
126 static pid_t tcgetpgrp(int fd);
127 static int tcsetpgrp(int fd, pid_t pgrp);
128
129 static pid_t
130 tcgetpgrp(int fd)
131 {
132 pid_t pgrp;
133 if (ioctl(fd, TIOCGPGRP, (char *)&pgrp) == -1)
134 return -1;
135 else
136 return pgrp;
137 }
138
139 static int
140 tcsetpgrp(int fd, pid_tpgrp)
141 {
142 return ioctl(fd, TIOCSPGRP, (char *)&pgrp);
143 }
144 #endif
145
146 static void
147 ttyfd_change(int from, int to)
148 {
149 if (ttyfd == from)
150 ttyfd = to;
151 }
152
153 /*
154 * Turn job control on and off.
155 *
156 * Note: This code assumes that the third arg to ioctl is a character
157 * pointer, which is true on Berkeley systems but not System V. Since
158 * System V doesn't have job control yet, this isn't a problem now.
159 */
160
161 MKINIT int jobctl;
162
163 void
164 setjobctl(int on)
165 {
166 #ifdef OLD_TTY_DRIVER
167 int ldisc;
168 #endif
169
170 if (on == jobctl || rootshell == 0)
171 return;
172 if (on) {
173 #if defined(FIOCLEX) || defined(FD_CLOEXEC)
174 int i;
175
176 if (ttyfd != -1)
177 sh_close(ttyfd);
178 if ((ttyfd = open("/dev/tty", O_RDWR)) == -1) {
179 for (i = 0; i < 3; i++) {
180 if (isatty(i) && (ttyfd = dup(i)) != -1)
181 break;
182 }
183 if (i == 3)
184 goto out;
185 }
186 ttyfd = to_upper_fd(ttyfd); /* Move to a high fd */
187 register_sh_fd(ttyfd, ttyfd_change);
188 #else
189 out2str("sh: Need FIOCLEX or FD_CLOEXEC to support job control");
190 goto out;
191 #endif
192 if ((initialpgrp = tcgetpgrp(ttyfd)) < 0) {
193 out:
194 out2str("sh: can't access tty; job control turned off\n");
195 mflag = 0;
196 return;
197 }
198 if (initialpgrp == -1)
199 initialpgrp = getpgrp();
200 else if (initialpgrp != getpgrp())
201 killpg(0, SIGTTIN);
202
203 #ifdef OLD_TTY_DRIVER
204 if (ioctl(ttyfd, TIOCGETD, (char *)&ldisc) < 0
205 || ldisc != NTTYDISC) {
206 out2str("sh: need new tty driver to run job control; job control turned off\n");
207 mflag = 0;
208 return;
209 }
210 #endif
211 setsignal(SIGTSTP, 0);
212 setsignal(SIGTTOU, 0);
213 setsignal(SIGTTIN, 0);
214 if (getpgrp() != rootpid && setpgid(0, rootpid) == -1)
215 error("Cannot set process group (%s) at %d",
216 strerror(errno), __LINE__);
217 if (tcsetpgrp(ttyfd, rootpid) == -1)
218 error("Cannot set tty process group (%s) at %d",
219 strerror(errno), __LINE__);
220 } else { /* turning job control off */
221 if (getpgrp() != initialpgrp && setpgid(0, initialpgrp) == -1)
222 error("Cannot set process group (%s) at %d",
223 strerror(errno), __LINE__);
224 if (tcsetpgrp(ttyfd, initialpgrp) == -1)
225 error("Cannot set tty process group (%s) at %d",
226 strerror(errno), __LINE__);
227 sh_close(ttyfd);
228 ttyfd = -1;
229 setsignal(SIGTSTP, 0);
230 setsignal(SIGTTOU, 0);
231 setsignal(SIGTTIN, 0);
232 }
233 jobctl = on;
234 }
235
236
237 #ifdef mkinit
238 INCLUDE <stdlib.h>
239
240 SHELLPROC {
241 backgndpid = -1;
242 #if JOBS
243 jobctl = 0;
244 #endif
245 }
246
247 #endif
248
249
250
251 #if JOBS
252 static int
253 do_fgcmd(const char *arg_ptr)
254 {
255 struct job *jp;
256 int i;
257 int status;
258
259 if (jobs_invalid)
260 error("No current jobs");
261 jp = getjob(arg_ptr, 0);
262 if (jp->jobctl == 0)
263 error("job not created under job control");
264 out1fmt("%s", jp->ps[0].cmd);
265 for (i = 1; i < jp->nprocs; i++)
266 out1fmt(" | %s", jp->ps[i].cmd );
267 out1c('\n');
268 flushall();
269
270 if (tcsetpgrp(ttyfd, jp->pgrp) == -1) {
271 error("Cannot set tty process group (%s) at %d",
272 strerror(errno), __LINE__);
273 }
274 INTOFF;
275 restartjob(jp);
276 status = waitforjob(jp);
277 INTON;
278 return status;
279 }
280
281 int
282 fgcmd(int argc, char **argv)
283 {
284 nextopt("");
285 return do_fgcmd(*argptr);
286 }
287
288 int
289 fgcmd_percent(int argc, char **argv)
290 {
291 nextopt("");
292 return do_fgcmd(*argv);
293 }
294
295 static void
296 set_curjob(struct job *jp, int mode)
297 {
298 struct job *jp1, *jp2;
299 int i, ji;
300
301 ji = jp - jobtab;
302
303 /* first remove from list */
304 if (ji == curjob)
305 curjob = jp->prev_job;
306 else {
307 for (i = 0; i < njobs; i++) {
308 if (jobtab[i].prev_job != ji)
309 continue;
310 jobtab[i].prev_job = jp->prev_job;
311 break;
312 }
313 }
314
315 /* Then re-insert in correct position */
316 switch (mode) {
317 case 0: /* job being deleted */
318 jp->prev_job = -1;
319 break;
320 case 1: /* newly created job or backgrounded job,
321 put after all stopped jobs. */
322 if (curjob != -1 && jobtab[curjob].state == JOBSTOPPED) {
323 for (jp1 = jobtab + curjob; ; jp1 = jp2) {
324 if (jp1->prev_job == -1)
325 break;
326 jp2 = jobtab + jp1->prev_job;
327 if (jp2->state != JOBSTOPPED)
328 break;
329 }
330 jp->prev_job = jp1->prev_job;
331 jp1->prev_job = ji;
332 break;
333 }
334 /* FALLTHROUGH */
335 case 2: /* newly stopped job - becomes curjob */
336 jp->prev_job = curjob;
337 curjob = ji;
338 break;
339 }
340 }
341
342 int
343 bgcmd(int argc, char **argv)
344 {
345 struct job *jp;
346 int i;
347
348 nextopt("");
349 if (jobs_invalid)
350 error("No current jobs");
351 do {
352 jp = getjob(*argptr, 0);
353 if (jp->jobctl == 0)
354 error("job not created under job control");
355 set_curjob(jp, 1);
356 out1fmt("[%d] %s", JNUM(jp), jp->ps[0].cmd);
357 for (i = 1; i < jp->nprocs; i++)
358 out1fmt(" | %s", jp->ps[i].cmd );
359 out1c('\n');
360 flushall();
361 restartjob(jp);
362 } while (*argptr && *++argptr);
363 return 0;
364 }
365
366
367 STATIC void
368 restartjob(struct job *jp)
369 {
370 struct procstat *ps;
371 int i, e;
372
373 if (jp->state == JOBDONE)
374 return;
375 if (jp->pgrp == 0)
376 error("Job [%d] does not have a process group", JNUM(jp));
377
378 INTOFF;
379 for (e = i = 0; i < jp->nprocs; i++) {
380 /*
381 * Don't touch a process we already waited for and collected
382 * exit status, that pid may have been reused for something
383 * else - even another of our jobs
384 */
385 if (jp->ps[i].status != -1 && !WIFSTOPPED(jp->ps[i].status))
386 continue;
387
388 /*
389 * Otherwise tell it to continue, if it worked, we're done
390 * (we signal the whole process group)
391 */
392 if (killpg(jp->pgrp, SIGCONT) != -1)
393 break;
394 e = errno;
395 break; /* no point trying again */
396 }
397
398 if (e != 0)
399 error("Cannot continue job (%s)", strerror(e));
400 else if (i >= jp->nprocs)
401 error("Job [%d] has no stopped processes", JNUM(jp));
402
403 /*
404 * Now change state of all stopped processes in the job to running
405 * If there were any, the job is now running as well.
406 */
407 for (ps = jp->ps, i = jp->nprocs ; --i >= 0 ; ps++) {
408 if (WIFSTOPPED(ps->status)) {
409 VTRACE(DBG_JOBS, (
410 "restartjob: [%d] pid %d status change"
411 " from %#x (stopped) to -1 (running)\n",
412 JNUM(jp), ps->pid, ps->status));
413 ps->status = -1;
414 jp->state = JOBRUNNING;
415 }
416 }
417 INTON;
418 }
419 #endif
420
421 inline static void
422 cmdputi(int n)
423 {
424 char str[20];
425
426 fmtstr(str, sizeof str, "%d", n);
427 cmdputs(str);
428 }
429
430 static void
431 showjob(struct output *out, struct job *jp, int mode)
432 {
433 int procno;
434 int st;
435 struct procstat *ps;
436 int col;
437 char s[64];
438
439 #if JOBS
440 if (mode & SHOW_PGID) {
441 /* output only the process group ID (lead process ID) */
442 outfmt(out, "%ld\n",
443 jp->pgrp != 0 ? (long)jp->pgrp : (long)jp->ps->pid);
444 return;
445 }
446 #endif
447
448 procno = jp->nprocs;
449 if (!procno)
450 return;
451
452 if (mode & SHOW_PID)
453 mode |= SHOW_MULTILINE;
454
455 if ((procno > 1 && !(mode & SHOW_MULTILINE))
456 || (mode & SHOW_SIGNALLED)) {
457 /* See if we have more than one status to report */
458 ps = jp->ps;
459 st = ps->status;
460 do {
461 int st1 = ps->status;
462 if (st1 != st)
463 /* yes - need multi-line output */
464 mode |= SHOW_MULTILINE;
465 if (st1 == -1 || !(mode & SHOW_SIGNALLED) || WIFEXITED(st1))
466 continue;
467 if (WIFSTOPPED(st1) || ((st1 = WTERMSIG(st1) & 0x7f)
468 && st1 != SIGINT && st1 != SIGPIPE))
469 mode |= SHOW_ISSIG;
470
471 } while (ps++, --procno);
472 procno = jp->nprocs;
473 }
474
475 if (mode & SHOW_SIGNALLED && !(mode & SHOW_ISSIG)) {
476 if (jp->state == JOBDONE && !(mode & SHOW_NO_FREE)) {
477 VTRACE(DBG_JOBS, ("showjob: freeing job %d\n",
478 JNUM(jp)));
479 freejob(jp);
480 }
481 return;
482 }
483
484 for (ps = jp->ps; --procno >= 0; ps++) { /* for each process */
485 if (ps == jp->ps)
486 fmtstr(s, 16, "[%d] %c ",
487 JNUM(jp),
488 #if JOBS
489 jp - jobtab == curjob ?
490 '+' :
491 curjob != -1 &&
492 jp - jobtab == jobtab[curjob].prev_job ?
493 '-' :
494 #endif
495 ' ');
496 else
497 fmtstr(s, 16, " " );
498 col = strlen(s);
499 if (mode & SHOW_PID) {
500 fmtstr(s + col, 16, "%ld ", (long)ps->pid);
501 col += strlen(s + col);
502 }
503 if (ps->status == -1) {
504 scopy("Running", s + col);
505 } else if (WIFEXITED(ps->status)) {
506 st = WEXITSTATUS(ps->status);
507 if (st)
508 fmtstr(s + col, 16, "Done(%d)", st);
509 else
510 fmtstr(s + col, 16, "Done");
511 } else {
512 #if JOBS
513 if (WIFSTOPPED(ps->status))
514 st = WSTOPSIG(ps->status);
515 else /* WIFSIGNALED(ps->status) */
516 #endif
517 st = WTERMSIG(ps->status);
518 scopyn(strsignal(st), s + col, 32);
519 if (WCOREDUMP(ps->status)) {
520 col += strlen(s + col);
521 scopyn(" (core dumped)", s + col, 64 - col);
522 }
523 }
524 col += strlen(s + col);
525 outstr(s, out);
526 do {
527 outc(' ', out);
528 col++;
529 } while (col < 30);
530 outstr(ps->cmd, out);
531 if (mode & SHOW_MULTILINE) {
532 if (procno > 0) {
533 outc(' ', out);
534 outc('|', out);
535 }
536 } else {
537 while (--procno >= 0)
538 outfmt(out, " | %s", (++ps)->cmd );
539 }
540 outc('\n', out);
541 }
542 flushout(out);
543 jp->flags &= ~JOBCHANGED;
544 if (jp->state == JOBDONE && !(mode & SHOW_NO_FREE))
545 freejob(jp);
546 }
547
548 int
549 jobscmd(int argc, char **argv)
550 {
551 int mode, m;
552
553 mode = 0;
554 while ((m = nextopt("lpZ")))
555 switch (m) {
556 case 'l':
557 mode = SHOW_PID;
558 break;
559 case 'p':
560 mode = SHOW_PGID;
561 break;
562 case 'Z':
563 mode = SHOW_PROCTITLE;
564 break;
565 }
566
567 if (mode == SHOW_PROCTITLE) {
568 if (*argptr && **argptr)
569 setproctitle("%s", *argptr);
570 else
571 setproctitle(NULL);
572 return 0;
573 }
574
575 if (!iflag && !posix)
576 mode |= SHOW_NO_FREE;
577
578 if (*argptr) {
579 do
580 showjob(out1, getjob(*argptr,0), mode);
581 while (*++argptr);
582 } else
583 showjobs(out1, mode);
584 return 0;
585 }
586
587
588 /*
589 * Print a list of jobs. If "change" is nonzero, only print jobs whose
590 * statuses have changed since the last call to showjobs.
591 *
592 * If the shell is interrupted in the process of creating a job, the
593 * result may be a job structure containing zero processes. Such structures
594 * will be freed here.
595 */
596
597 void
598 showjobs(struct output *out, int mode)
599 {
600 int jobno;
601 struct job *jp;
602 int silent = 0, gotpid;
603
604 CTRACE(DBG_JOBS, ("showjobs(%x) called\n", mode));
605
606 /* Collect everything pending in the kernel */
607 if ((gotpid = dowait(WSILENT, NULL, NULL)) > 0)
608 while (dowait(WSILENT, NULL, NULL) > 0)
609 continue;
610 #ifdef JOBS
611 /*
612 * Check if we are not in our foreground group, and if not
613 * put us in it.
614 */
615 if (mflag && gotpid != -1 && tcgetpgrp(ttyfd) != getpid()) {
616 if (tcsetpgrp(ttyfd, getpid()) == -1)
617 error("Cannot set tty process group (%s) at %d",
618 strerror(errno), __LINE__);
619 VTRACE(DBG_JOBS|DBG_INPUT, ("repaired tty process group\n"));
620 silent = 1;
621 }
622 #endif
623
624 for (jobno = 1, jp = jobtab ; jobno <= njobs ; jobno++, jp++) {
625 if (!jp->used)
626 continue;
627 if (jp->nprocs == 0) {
628 if (!jobs_invalid)
629 freejob(jp);
630 continue;
631 }
632 if ((mode & SHOW_CHANGED) && !(jp->flags & JOBCHANGED))
633 continue;
634 if (silent && (jp->flags & JOBCHANGED)) {
635 jp->flags &= ~JOBCHANGED;
636 continue;
637 }
638 showjob(out, jp, mode);
639 }
640 }
641
642 /*
643 * Mark a job structure as unused.
644 */
645
646 STATIC void
647 freejob(struct job *jp)
648 {
649 INTOFF;
650 if (jp->ps != &jp->ps0) {
651 ckfree(jp->ps);
652 jp->ps = &jp->ps0;
653 }
654 jp->nprocs = 0;
655 jp->used = 0;
656 #if JOBS
657 set_curjob(jp, 0);
658 #endif
659 INTON;
660 }
661
662 /*
663 * Extract the status of a completed job (for $?)
664 */
665 STATIC int
666 jobstatus(const struct job *jp, int raw)
667 {
668 int status = 0;
669 int retval;
670
671 if ((jp->flags & JPIPEFAIL) && jp->nprocs) {
672 int i;
673
674 for (i = 0; i < jp->nprocs; i++)
675 if (jp->ps[i].status != 0)
676 status = jp->ps[i].status;
677 } else
678 status = jp->ps[jp->nprocs ? jp->nprocs - 1 : 0].status;
679
680 if (raw)
681 return status;
682
683 if (WIFEXITED(status))
684 retval = WEXITSTATUS(status);
685 #if JOBS
686 else if (WIFSTOPPED(status))
687 retval = WSTOPSIG(status) + 128;
688 #endif
689 else {
690 /* XXX: limits number of signals */
691 retval = WTERMSIG(status) + 128;
692 }
693
694 return retval;
695 }
696
697
698
699 int
700 waitcmd(int argc, char **argv)
701 {
702 struct job *job, *last;
703 int retval;
704 struct job *jp;
705 int i;
706 int any = 0;
707 int found;
708 int oldwait = 0;
709 char *pid = NULL, *fpid;
710 char **arg;
711 char idstring[20];
712
713 while ((i = nextopt("np:")) != '\0') {
714 switch (i) {
715 case 'n':
716 any = 1;
717 break;
718 case 'p':
719 if (pid)
720 error("more than one -p unsupported");
721 pid = optionarg;
722 break;
723 }
724 }
725
726 if (!any && *argptr == 0)
727 oldwait = 1;
728
729 if (pid != NULL) {
730 if (!validname(pid, '\0', NULL))
731 error("invalid name: -p '%s'", pid);
732 if (unsetvar(pid, 0))
733 error("%s readonly", pid);
734 }
735
736 /*
737 * If we have forked, and not yet created any new jobs, then
738 * we have no children, whatever jobtab claims,
739 * so simply return in that case.
740 *
741 * The return code is 127 if we had any pid args (none are found)
742 * or if we had -n (nothing exited), but 0 for plain old "wait".
743 */
744 if (jobs_invalid) {
745 CTRACE(DBG_WAIT, ("builtin wait%s%s in child, invalid jobtab\n",
746 any ? " -n" : "", *argptr ? " pid..." : ""));
747 return oldwait ? 0 : 127;
748 }
749
750 /*
751 * clear stray flags left from previous waitcmd
752 * or set them instead if anything will do ("wait -n")
753 */
754 for (jp = jobtab, i = njobs ; --i >= 0 ; jp++) {
755 if (any && *argptr == NULL)
756 jp->flags |= JOBWANTED;
757 else
758 jp->flags &= ~JOBWANTED;
759 jp->ref = NULL;
760 }
761
762 CTRACE(DBG_WAIT,
763 ("builtin wait%s%s\n", any ? " -n" : "", *argptr ? " pid..." : ""));
764
765 /*
766 * First, validate the jobnum args, count how many refer to
767 * (different) running jobs, and if we had -n, and found that one has
768 * already finished, we return that one. Otherwise remember
769 * which ones we are looking for (JOBWANTED).
770 */
771 found = 0;
772 last = NULL;
773 for (arg = argptr; *arg; arg++) {
774 last = jp = getjob(*arg, 1);
775 if (!jp)
776 continue;
777 if (jp->ref == NULL)
778 jp->ref = *arg;
779 if (any && jp->state == JOBDONE) {
780 /*
781 * We just want any of them, and this one is
782 * ready for consumption, bon apetit ...
783 */
784 retval = jobstatus(jp, 0);
785 if (pid)
786 setvar(pid, *arg, 0);
787 if (!iflag)
788 freejob(jp);
789 CTRACE(DBG_WAIT, ("wait -n found %s already done: %d\n", *arg, retval));
790 return retval;
791 }
792 if (!(jp->flags & JOBWANTED)) {
793 /*
794 * It is possible to list the same job several
795 * times - the obvious "wait 1 1 1" or
796 * "wait %% %2 102" where job 2 is current and pid 102
797 * However many times it is requested, it is found once.
798 */
799 found++;
800 jp->flags |= JOBWANTED;
801 }
802 job = jp;
803 }
804
805 VTRACE(DBG_WAIT, ("wait %s%s%sfound %d candidates (last %s)\n",
806 any ? "-n " : "", *argptr ? *argptr : "",
807 argptr[0] && argptr[1] ? "... " : " ", found,
808 job && job->used ? (job->ref ? job->ref : "<no-arg>") : "none"));
809
810 /*
811 * If we were given a list of jobnums:
812 * and none of those exist, then we're done.
813 */
814 if (*argptr && found == 0)
815 return 127;
816
817 /*
818 * Otherwise we need to wait for something to complete
819 * When it does, we check and see if it is one of the
820 * jobs we're waiting on, and if so, we clean it up.
821 * If we had -n, then we're done, otherwise we do it all again
822 * until all we had listed are done, of if there were no
823 * jobnum args, all are done.
824 */
825
826 retval = any || *argptr ? 127 : 0;
827 fpid = NULL;
828 for (;;) {
829 VTRACE(DBG_WAIT, ("wait waiting (%d remain): ", found));
830 job = NULL;
831 for (jp = jobtab, i = njobs; --i >= 0; jp++) {
832 if (jp->used && jp->flags & JOBWANTED &&
833 jp->state == JOBDONE) {
834 job = jp;
835 break;
836 }
837 if (jp->used && jp->state == JOBRUNNING)
838 job = jp;
839 }
840 if (i < 0 && job == NULL) {
841 CTRACE(DBG_WAIT, ("nothing running (ret: %d) fpid %s\n",
842 retval, fpid ? fpid : "unset"));
843 if (pid && fpid)
844 setvar(pid, fpid, 0);
845 return retval;
846 }
847 jp = job;
848 VTRACE(DBG_WAIT, ("found @%d/%d state: %d\n", njobs-i, njobs,
849 jp->state));
850
851 /*
852 * There is at least 1 job running, so we can
853 * safely wait() (blocking) for something to exit.
854 */
855 if (jp->state == JOBRUNNING) {
856 job = NULL;
857 if ((i = dowait(WBLOCK|WNOFREE, NULL, &job)) == -1)
858 return 128 + lastsig();
859
860 /*
861 * This happens if an interloper has died
862 * (eg: a child of the executable that exec'd us)
863 * Simply go back and start all over again
864 * (this is rare).
865 */
866 if (job == NULL)
867 continue;
868
869 /*
870 * one of the reported job's processes exited,
871 * but there are more still running, back for more
872 */
873 if (job->state == JOBRUNNING)
874 continue;
875 } else
876 job = jp; /* we want this, and it is done */
877
878 if (job->flags & JOBWANTED) {
879 int rv;
880
881 job->flags &= ~JOBWANTED; /* got it */
882 rv = jobstatus(job, 0);
883 VTRACE(DBG_WAIT, (
884 "wanted %d (%s) done: st=%d", i,
885 job->ref ? job->ref : "", rv));
886 if (any || job == last) {
887 retval = rv;
888 fpid = job->ref;
889
890 VTRACE(DBG_WAIT, (" save"));
891 if (pid) {
892 /*
893 * don't need fpid unless we are going
894 * to return it.
895 */
896 if (fpid == NULL) {
897 /*
898 * this only happens with "wait -n"
899 * (that is, no pid args)
900 */
901 snprintf(idstring, sizeof idstring,
902 "%d", job->ps[ job->nprocs ?
903 job->nprocs-1 : 0 ].pid);
904 fpid = idstring;
905 }
906 VTRACE(DBG_WAIT, (" (for %s)", fpid));
907 }
908 }
909
910 if (job->state == JOBDONE) {
911 VTRACE(DBG_WAIT, (" free"));
912 freejob(job);
913 }
914
915 if (any || (found > 0 && --found == 0)) {
916 if (pid && fpid)
917 setvar(pid, fpid, 0);
918 VTRACE(DBG_WAIT, (" return %d\n", retval));
919 return retval;
920 }
921 VTRACE(DBG_WAIT, ("\n"));
922 continue;
923 }
924
925 /* this is to handle "wait" (no args) */
926 if (oldwait && job->state == JOBDONE) {
927 VTRACE(DBG_JOBS|DBG_WAIT, ("Cleanup: %d\n", i));
928 freejob(job);
929 }
930 }
931 }
932
933
934 int
935 jobidcmd(int argc, char **argv)
936 {
937 struct job *jp;
938 int i;
939 int pg = 0, onep = 0, job = 0;
940
941 while ((i = nextopt("gjp"))) {
942 switch (i) {
943 case 'g': pg = 1; break;
944 case 'j': job = 1; break;
945 case 'p': onep = 1; break;
946 }
947 }
948 CTRACE(DBG_JOBS, ("jobidcmd%s%s%s%s %s\n", pg ? " -g" : "",
949 onep ? " -p" : "", job ? " -j" : "", jobs_invalid ? " [inv]" : "",
950 *argptr ? *argptr : "<implicit %%>"));
951 if (pg + onep + job > 1)
952 error("-g -j and -p options cannot be combined");
953
954 if (argptr[0] && argptr[1])
955 error("usage: jobid [-g|-p|-r] jobid");
956
957 jp = getjob(*argptr, 0);
958 if (job) {
959 out1fmt("%%%d\n", JNUM(jp));
960 return 0;
961 }
962 if (pg) {
963 if (jp->pgrp != 0) {
964 out1fmt("%ld\n", (long)jp->pgrp);
965 return 0;
966 }
967 return 1;
968 }
969 if (onep) {
970 i = jp->nprocs - 1;
971 if (i < 0)
972 return 1;
973 out1fmt("%ld\n", (long)jp->ps[i].pid);
974 return 0;
975 }
976 for (i = 0 ; i < jp->nprocs ; ) {
977 out1fmt("%ld", (long)jp->ps[i].pid);
978 out1c(++i < jp->nprocs ? ' ' : '\n');
979 }
980 return 0;
981 }
982
983 #if JOBS
984 #ifndef SMALL
985
986 static int
987 stop_me(int sig, int force, int pgrp, pid_t pid)
988 {
989 if (force || (!loginsh && mflag && rootshell)) {
990 struct sigaction sig_dfl, sig_was;
991
992 sig_dfl.sa_handler = SIG_DFL;
993 sig_dfl.sa_flags = 0;
994 sigemptyset(&sig_dfl.sa_mask);
995
996 (void)sigaction(sig, &sig_dfl, &sig_was);
997
998 if (kill(pgrp ? 0 : pid, sig) == -1) {
999 sh_warn("suspend myself");
1000 (void)sigaction(sig, &sig_was, NULL);
1001 error(NULL);
1002 }
1003
1004 (void)sigaction(sig, &sig_was, NULL);
1005
1006 return 0;
1007 }
1008
1009 if (!rootshell)
1010 sh_warnx("subshell environment");
1011 else if (!mflag)
1012 sh_warnx("job control disabled");
1013 else if (loginsh)
1014 sh_warnx("login shell");
1015 else
1016 sh_warnx("not possible??");
1017
1018 return 1;
1019 }
1020
1021 int
1022 suspendcmd(int argc, char **argv)
1023 {
1024 int sig = SIGTSTP;
1025 int force = 0;
1026 int pgrp = 0;
1027 int status = 0;
1028 char *target;
1029 int c;
1030
1031 while ((c = nextopt("fgs:")) != 0) {
1032 switch (c) {
1033 case 'f':
1034 force = 1;
1035 break;
1036 case 'g':
1037 pgrp = 1;
1038 break;
1039 case 's':
1040 sig = signame_to_signum(optionarg);
1041
1042 if (sig != SIGSTOP && sig != SIGTSTP &&
1043 sig != SIGTTIN && sig != SIGTTOU)
1044 error("bad signal '%s'", optionarg);
1045 break;
1046 }
1047 }
1048
1049 if (!*argptr) /* suspend myself */
1050 return stop_me(sig, force, pgrp, getpid());
1051
1052 while ((target = *argptr++) != NULL)
1053 {
1054 int pid;
1055
1056 if (is_number(target)) {
1057 if ((pid = number(target)) == 0) {
1058 sh_warnx("Cannot (yet) suspend kernel (%s)",
1059 target);
1060 status = 1;
1061 continue;
1062 }
1063 } else if ((pid = getjobpgrp(target)) == 0) {
1064 sh_warnx("Unknown job: %s", target);
1065 status = 1;
1066 continue;
1067 }
1068
1069 if (pid == rootpid || pid == getpid()) {
1070 status |= stop_me(sig, force, pgrp, pid);
1071 continue;
1072 }
1073
1074 if (pid == 1 || pid == -1) {
1075 sh_warnx("Don't be funny");
1076 status = 1;
1077 continue;
1078 }
1079
1080 if (pid > 0 && pgrp)
1081 pid = -pid;
1082
1083 if (kill(pid, sig) == -1) {
1084 sh_warn("failed to suspend %s", target);
1085 status = 1;
1086 }
1087 }
1088
1089 return status;
1090 }
1091 #endif /* SMALL */
1092 #endif /* JOBS */
1093
1094 int
1095 getjobpgrp(const char *name)
1096 {
1097 struct job *jp;
1098
1099 if (jobs_invalid)
1100 return 0;
1101 jp = getjob(name, 1);
1102 if (jp == 0)
1103 return 0;
1104 return -jp->pgrp;
1105 }
1106
1107 /*
1108 * Convert a job name to a job structure.
1109 */
1110
1111 STATIC struct job *
1112 getjob(const char *name, int noerror)
1113 {
1114 int jobno = -1;
1115 struct job *jp;
1116 int pid;
1117 int i;
1118 const char *err_msg = "No such job: %s";
1119
1120 if (name == NULL) {
1121 #if JOBS
1122 jobno = curjob;
1123 #endif
1124 err_msg = "No current job";
1125 } else if (name[0] == '%') {
1126 if (is_number(name + 1)) {
1127 jobno = number(name + 1) - 1;
1128 } else if (!name[1] || !name[2]) {
1129 switch (name[1]) {
1130 #if JOBS
1131 case 0:
1132 case '+':
1133 case '%':
1134 jobno = curjob;
1135 err_msg = "No current job";
1136 break;
1137 case '-':
1138 jobno = curjob;
1139 if (jobno != -1)
1140 jobno = jobtab[jobno].prev_job;
1141 err_msg = "No previous job";
1142 break;
1143 #endif
1144 default:
1145 goto check_pattern;
1146 }
1147 } else {
1148 struct job *found;
1149 check_pattern:
1150 found = NULL;
1151 for (jp = jobtab, i = njobs ; --i >= 0 ; jp++) {
1152 if (!jp->used || jp->nprocs <= 0)
1153 continue;
1154 if ((name[1] == '?'
1155 && strstr(jp->ps[0].cmd, name + 2))
1156 || prefix(name + 1, jp->ps[0].cmd)) {
1157 if (found) {
1158 err_msg = "%s: ambiguous";
1159 found = 0;
1160 break;
1161 }
1162 found = jp;
1163 }
1164 }
1165 if (found)
1166 return found;
1167 }
1168
1169 } else if (is_number(name)) {
1170 pid = number(name);
1171 for (jp = jobtab, i = njobs ; --i >= 0 ; jp++) {
1172 if (jp->used && jp->nprocs > 0
1173 && jp->ps[jp->nprocs - 1].pid == pid)
1174 return jp;
1175 }
1176 }
1177
1178 if (jobno >= 0 && jobno < njobs) {
1179 jp = jobtab + jobno;
1180 if (jp->used)
1181 return jp;
1182 }
1183 if (!noerror)
1184 error(err_msg, name);
1185 return 0;
1186 }
1187
1188
1189 /*
1190 * Find out if there are any running (that is, unwaited upon)
1191 * background children of the current shell.
1192 *
1193 * Return 1/0 (yes, no).
1194 *
1195 * Needed as we cannot optimise away sub-shell creation if
1196 * we have such a child, or a "wait" in that sub-shell would
1197 * observe the already existing job.
1198 */
1199 int
1200 anyjobs(void)
1201 {
1202 struct job *jp;
1203 int i;
1204
1205 if (jobs_invalid)
1206 return 0;
1207
1208 for (i = njobs, jp = jobtab ; --i >= 0 ; jp++) {
1209 if (jp->used)
1210 return 1;
1211 }
1212
1213 return 0;
1214 }
1215
1216 /*
1217 * Output the (new) POSIX required "[%d] %d" string whenever an
1218 * async (ie: background) job is started in an interactive shell.
1219 * Note that a subshell environment is not regarded as interactive.
1220 */
1221 void
1222 jobstarted(struct job *jp)
1223 {
1224 if (!iflag || !rootshell)
1225 return;
1226
1227 outfmt(out2, "[%d] %ld\n", JNUM(jp),
1228 jp->pgrp != 0 ? (long)jp->pgrp : (long)jp->ps->pid);
1229 }
1230
1231 /*
1232 * Return a new job structure,
1233 */
1234
1235 struct job *
1236 makejob(union node *node, int nprocs)
1237 {
1238 int i;
1239 struct job *jp;
1240
1241 if (jobs_invalid) {
1242 VTRACE(DBG_JOBS, ("makejob(%p, %d) clearing jobtab (%d)\n",
1243 (void *)node, nprocs, njobs));
1244 for (i = njobs, jp = jobtab ; --i >= 0 ; jp++) {
1245 if (jp->used)
1246 freejob(jp);
1247 }
1248 jobs_invalid = 0;
1249 }
1250
1251 for (i = njobs, jp = jobtab ; ; jp++) {
1252 if (--i < 0) {
1253 INTOFF;
1254 if (njobs == 0) {
1255 jobtab = ckmalloc(4 * sizeof jobtab[0]);
1256 } else {
1257 jp = ckmalloc((njobs + 4) * sizeof jobtab[0]);
1258 memcpy(jp, jobtab, njobs * sizeof jp[0]);
1259 /* Relocate `ps' pointers */
1260 for (i = 0; i < njobs; i++)
1261 if (jp[i].ps == &jobtab[i].ps0)
1262 jp[i].ps = &jp[i].ps0;
1263 ckfree(jobtab);
1264 jobtab = jp;
1265 }
1266 jp = jobtab + njobs;
1267 for (i = 4 ; --i >= 0 ; njobs++) {
1268 jobtab[njobs].used = 0;
1269 jobtab[njobs].prev_job = -1;
1270 }
1271 INTON;
1272 break;
1273 }
1274 if (jp->used == 0)
1275 break;
1276 }
1277 INTOFF;
1278 jp->state = JOBRUNNING;
1279 jp->used = 1;
1280 jp->flags = pipefail ? JPIPEFAIL : 0;
1281 jp->nprocs = 0;
1282 jp->pgrp = 0;
1283 #if JOBS
1284 jp->jobctl = jobctl;
1285 set_curjob(jp, 1);
1286 #endif
1287 if (nprocs > 1) {
1288 jp->ps = ckmalloc(nprocs * sizeof (struct procstat));
1289 } else {
1290 jp->ps = &jp->ps0;
1291 }
1292 INTON;
1293 VTRACE(DBG_JOBS, ("makejob(%p, %d)%s returns %%%d\n", (void *)node,
1294 nprocs, (jp->flags & JPIPEFAIL) ? " PF" : "", JNUM(jp)));
1295 return jp;
1296 }
1297
1298
1299 /*
1300 * Fork off a subshell. If we are doing job control, give the subshell its
1301 * own process group. Jp is a job structure that the job is to be added to.
1302 * N is the command that will be evaluated by the child. Both jp and n may
1303 * be NULL. The mode parameter can be one of the following:
1304 * FORK_FG - Fork off a foreground process.
1305 * FORK_BG - Fork off a background process.
1306 * FORK_NOJOB - Like FORK_FG, but don't give the process its own
1307 * process group even if job control is on.
1308 *
1309 * When job control is turned off, background processes have their standard
1310 * input redirected to /dev/null (except for the second and later processes
1311 * in a pipeline).
1312 */
1313
1314 int
1315 forkshell(struct job *jp, union node *n, int mode)
1316 {
1317 pid_t pid;
1318 int serrno;
1319
1320 CTRACE(DBG_JOBS, ("forkshell(%%%d, %p, %d) called\n",
1321 JNUM(jp), n, mode));
1322
1323 switch ((pid = fork())) {
1324 case -1:
1325 serrno = errno;
1326 VTRACE(DBG_JOBS, ("Fork failed, errno=%d\n", serrno));
1327 error("Cannot fork (%s)", strerror(serrno));
1328 break;
1329 case 0:
1330 SHELL_FORKED();
1331 forkchild(jp, n, mode, 0);
1332 return 0;
1333 default:
1334 return forkparent(jp, n, mode, pid);
1335 }
1336 }
1337
1338 int
1339 forkparent(struct job *jp, union node *n, int mode, pid_t pid)
1340 {
1341 int pgrp = 0;
1342
1343 if (rootshell && mode != FORK_NOJOB && mflag) {
1344 /*
1345 * The process group ID must always be that of the
1346 * first process created for the job. If this proc
1347 * is the first, that's us, otherwise the pgrp has
1348 * already been determined.
1349 */
1350 if (jp == NULL || jp->nprocs == 0)
1351 pgrp = pid;
1352 else
1353 pgrp = jp->pgrp;
1354 /* This can fail because we are doing it in the child also */
1355 (void)setpgid(pid, pgrp);
1356 }
1357 if (mode == FORK_BG)
1358 backgndpid = pid; /* set $! */
1359 if (jp) {
1360 struct procstat *ps = &jp->ps[jp->nprocs++];
1361 ps->pid = pid;
1362 ps->status = -1;
1363 ps->cmd[0] = 0;
1364 jp->pgrp = pgrp; /* 0 if !mflag */
1365 if (/* iflag && rootshell && */ n)
1366 commandtext(ps, n);
1367 }
1368 CTRACE(DBG_JOBS, ("In parent shell: child = %d (mode %d)\n",pid,mode));
1369 return pid;
1370 }
1371
1372 void
1373 forkchild(struct job *jp, union node *n, int mode, int vforked)
1374 {
1375 int wasroot;
1376 int pgrp;
1377 const char *devnull = _PATH_DEVNULL;
1378 const char *nullerr = "Can't open %s";
1379
1380 wasroot = rootshell;
1381 CTRACE(DBG_JOBS, ("Child shell %d %sforked from %d (mode %d)\n",
1382 getpid(), vforked?"v":"", getppid(), mode));
1383
1384 if (!vforked) {
1385 rootshell = 0;
1386 handler = &main_handler;
1387 }
1388
1389 closescript(vforked);
1390 clear_traps(vforked);
1391 #if JOBS
1392 if (!vforked)
1393 jobctl = 0; /* do job control only in root shell */
1394 if (wasroot && mode != FORK_NOJOB && mflag) {
1395 if (jp == NULL || jp->nprocs == 0)
1396 pgrp = getpid();
1397 else
1398 pgrp = jp->ps[0].pid;
1399 /* This can fail because we are doing it in the parent also */
1400 (void)setpgid(0, pgrp);
1401 if (mode == FORK_FG) {
1402 if (tcsetpgrp(ttyfd, pgrp) == -1)
1403 error("Cannot set tty process group (%s) at %d",
1404 strerror(errno), __LINE__);
1405 }
1406 setsignal(SIGTSTP, vforked);
1407 setsignal(SIGTTOU, vforked);
1408 } else if (mode == FORK_BG) {
1409 ignoresig(SIGINT, vforked);
1410 ignoresig(SIGQUIT, vforked);
1411 if ((jp == NULL || jp->nprocs == 0) &&
1412 ! fd0_redirected_p ()) {
1413 close(0);
1414 if (open(devnull, O_RDONLY) != 0)
1415 error(nullerr, devnull);
1416 }
1417 }
1418 #else
1419 if (mode == FORK_BG) {
1420 ignoresig(SIGINT, vforked);
1421 ignoresig(SIGQUIT, vforked);
1422 if ((jp == NULL || jp->nprocs == 0) &&
1423 ! fd0_redirected_p ()) {
1424 close(0);
1425 if (open(devnull, O_RDONLY) != 0)
1426 error(nullerr, devnull);
1427 }
1428 }
1429 #endif
1430 if (wasroot && iflag) {
1431 setsignal(SIGINT, vforked);
1432 setsignal(SIGQUIT, vforked);
1433 setsignal(SIGTERM, vforked);
1434 }
1435
1436 if (!vforked)
1437 jobs_invalid = 1;
1438 }
1439
1440 /*
1441 * Wait for job to finish.
1442 *
1443 * Under job control we have the problem that while a child process is
1444 * running interrupts generated by the user are sent to the child but not
1445 * to the shell. This means that an infinite loop started by an inter-
1446 * active user may be hard to kill. With job control turned off, an
1447 * interactive user may place an interactive program inside a loop. If
1448 * the interactive program catches interrupts, the user doesn't want
1449 * these interrupts to also abort the loop. The approach we take here
1450 * is to have the shell ignore interrupt signals while waiting for a
1451 * foreground process to terminate, and then send itself an interrupt
1452 * signal if the child process was terminated by an interrupt signal.
1453 * Unfortunately, some programs want to do a bit of cleanup and then
1454 * exit on interrupt; unless these processes terminate themselves by
1455 * sending a signal to themselves (instead of calling exit) they will
1456 * confuse this approach.
1457 */
1458
1459 int
1460 waitforjob(struct job *jp)
1461 {
1462 #if JOBS
1463 int mypgrp = getpgrp();
1464 #endif
1465 int status;
1466 int st;
1467
1468 INTOFF;
1469 VTRACE(DBG_JOBS, ("waitforjob(%%%d) called\n", JNUM(jp)));
1470 while (jp->state == JOBRUNNING) {
1471 dowait(WBLOCK, jp, NULL);
1472 }
1473 #if JOBS
1474 if (jp->jobctl) {
1475 if (tcsetpgrp(ttyfd, mypgrp) == -1)
1476 error("Cannot set tty process group (%s) at %d",
1477 strerror(errno), __LINE__);
1478 }
1479 if (jp->state == JOBSTOPPED && curjob != jp - jobtab)
1480 set_curjob(jp, 2);
1481 #endif
1482 status = jobstatus(jp, 1);
1483
1484 /* convert to 8 bits */
1485 if (WIFEXITED(status))
1486 st = WEXITSTATUS(status);
1487 #if JOBS
1488 else if (WIFSTOPPED(status))
1489 st = WSTOPSIG(status) + 128;
1490 #endif
1491 else
1492 st = WTERMSIG(status) + 128;
1493
1494 VTRACE(DBG_JOBS, ("waitforjob: job %d, nproc %d, status %d, st %x\n",
1495 JNUM(jp), jp->nprocs, status, st));
1496 #if JOBS
1497 if (jp->jobctl) {
1498 /*
1499 * This is truly gross.
1500 * If we're doing job control, then we did a TIOCSPGRP which
1501 * caused us (the shell) to no longer be in the controlling
1502 * session -- so we wouldn't have seen any ^C/SIGINT. So, we
1503 * intuit from the subprocess exit status whether a SIGINT
1504 * occurred, and if so interrupt ourselves. Yuck. - mycroft
1505 */
1506 if (WIFSIGNALED(status) && WTERMSIG(status) == SIGINT)
1507 raise(SIGINT);
1508 }
1509 #endif
1510 if (! JOBS || jp->state == JOBDONE)
1511 freejob(jp);
1512 INTON;
1513 return st;
1514 }
1515
1516
1517
1518 /*
1519 * Wait for a process (any process) to terminate.
1520 *
1521 * If "job" is given (not NULL), then its jobcontrol status (and mflag)
1522 * are used to determine if we wait for stopping/continuing processes or
1523 * only terminating ones, and the decision whether to report to stdout
1524 * or not varies depending what happened, and whether the affected job
1525 * is the one that was requested or not.
1526 *
1527 * If "changed" is not NULL, then the job which changed because a
1528 * process terminated/stopped will be reported by setting *changed,
1529 * if there is any such job, otherwise we set *changed = NULL.
1530 */
1531
1532 STATIC int
1533 dowait(int flags, struct job *job, struct job **changed)
1534 {
1535 int pid;
1536 int status;
1537 struct procstat *sp;
1538 struct job *jp;
1539 struct job *thisjob;
1540 int done;
1541 int stopped;
1542 int err;
1543
1544 VTRACE(DBG_JOBS|DBG_PROCS, ("dowait(%x) called for job %d%s\n",
1545 flags, JNUM(job), changed ? " [report change]" : ""));
1546
1547 if (changed != NULL)
1548 *changed = NULL;
1549
1550 /*
1551 * First deal with the kernel, collect info on any (one) of our
1552 * children that has changed state since we last asked.
1553 * (loop if we're interrupted by a signal that we aren't processing)
1554 */
1555 do {
1556 err = 0;
1557 pid = waitproc(flags & WBLOCK, job, &status);
1558 if (pid == -1)
1559 err = errno;
1560 VTRACE(DBG_JOBS|DBG_PROCS,
1561 ("wait returns pid %d (e:%d), status %#x (ps=%d)\n",
1562 pid, err, status, pendingsigs));
1563 } while (pid == -1 && err == EINTR && pendingsigs == 0);
1564
1565 /*
1566 * if nothing exited/stopped/..., we have nothing else to do
1567 */
1568 if (pid <= 0)
1569 return pid;
1570
1571 /*
1572 * Otherwise, try to find the process, somewhere in our job table
1573 */
1574 INTOFF;
1575 thisjob = NULL;
1576 for (jp = jobtab ; jp < jobtab + njobs ; jp++) {
1577 if (jp->used) {
1578 /*
1579 * For each job that is in use (this is one)
1580 */
1581 done = 1; /* assume it is finished */
1582 stopped = 1; /* and has stopped */
1583
1584 /*
1585 * Now scan all our child processes of the job
1586 */
1587 for (sp = jp->ps ; sp < jp->ps + jp->nprocs ; sp++) {
1588 if (sp->pid == -1)
1589 continue;
1590 /*
1591 * If the process that changed is the one
1592 * we're looking at, and it was previously
1593 * running (-1) or was stopped (anything else
1594 * and it must have already finished earlier,
1595 * so cannot be the process that just changed)
1596 * then we update its status
1597 */
1598 if (sp->pid == pid &&
1599 (sp->status==-1 || WIFSTOPPED(sp->status))) {
1600 VTRACE(DBG_JOBS | DBG_PROCS,
1601 ("Job %d: changing status of proc %d from %#x to ",
1602 JNUM(jp), pid, sp->status));
1603
1604 /*
1605 * If the process continued,
1606 * then update its status to running
1607 * and mark the job running as well.
1608 *
1609 * If it was anything but running
1610 * before, flag it as a change for
1611 * reporting purposes later
1612 */
1613 if (WIFCONTINUED(status)) {
1614 if (sp->status != -1)
1615 jp->flags |= JOBCHANGED;
1616 sp->status = -1;
1617 jp->state = JOBRUNNING;
1618 VTRACE(DBG_JOBS|DBG_PROCS,
1619 ("running\n"));
1620 } else {
1621 /* otherwise update status */
1622 sp->status = status;
1623 VTRACE(DBG_JOBS|DBG_PROCS,
1624 ("%#x\n", status));
1625 }
1626
1627 /*
1628 * We now know the affected job
1629 */
1630 thisjob = jp;
1631 if (changed != NULL)
1632 *changed = jp;
1633 }
1634 /*
1635 * After any update that might have just
1636 * happened, if this process is running,
1637 * the job is not stopped, or if the process
1638 * simply stopped (not terminated) then the
1639 * job is certainly not completed (done).
1640 */
1641 if (sp->status == -1)
1642 stopped = 0;
1643 else if (WIFSTOPPED(sp->status))
1644 done = 0;
1645 }
1646
1647 /*
1648 * Once we have examined all processes for the
1649 * job, if we still show it as stopped, then...
1650 */
1651 if (stopped) { /* stopped or done */
1652 /*
1653 * it might be stopped, or finished, decide:
1654 */
1655 int state = done ? JOBDONE : JOBSTOPPED;
1656
1657 /*
1658 * If that wasn't the same as it was before
1659 * then update its state, and if it just
1660 * completed, make it be the current job (%%)
1661 */
1662 if (jp->state != state) {
1663 VTRACE(DBG_JOBS,
1664 ("Job %d: changing state from %d to %d\n",
1665 JNUM(jp), jp->state, state));
1666 jp->state = state;
1667 #if JOBS
1668 if (done)
1669 set_curjob(jp, 0);
1670 #endif
1671 }
1672 }
1673 }
1674 }
1675
1676 /*
1677 * Now we have scanned all jobs. If we found the job that
1678 * the process that changed state belonged to (we occasionally
1679 * fork processes without associating them with a job, when one
1680 * of those finishes, we simply ignore it, the zombie has been
1681 * cleaned up, which is all that matters) then we need to
1682 * determine if we should say something about it to stdout
1683 */
1684
1685 if (thisjob &&
1686 (thisjob->state != JOBRUNNING || thisjob->flags & JOBCHANGED)) {
1687 int mode = 0;
1688
1689 if (!rootshell || !iflag)
1690 mode = SHOW_SIGNALLED;
1691 if ((job == thisjob && (flags & WNOFREE) == 0) ||
1692 job != thisjob)
1693 mode = SHOW_SIGNALLED | SHOW_NO_FREE;
1694 if (mode && (flags & WSILENT) == 0)
1695 showjob(out2, thisjob, mode);
1696 else {
1697 VTRACE(DBG_JOBS,
1698 ("Not printing status for %p [%d], "
1699 "mode=%#x rootshell=%d, job=%p [%d]\n",
1700 thisjob, JNUM(thisjob), mode, rootshell,
1701 job, JNUM(job)));
1702 thisjob->flags |= JOBCHANGED;
1703 }
1704 }
1705
1706 INTON;
1707 /*
1708 * Finally tell our caller that something happened (in general all
1709 * anyone tests for is <= 0 (or >0) so the actual pid value here
1710 * doesn't matter much, but we know pid is >0 so we may as well
1711 * give back something meaningful
1712 */
1713 return pid;
1714 }
1715
1716
1717
1718 /*
1719 * Do a wait system call. If job control is compiled in, we accept
1720 * stopped processes. If block is zero, we return a value of zero
1721 * rather than blocking.
1722 *
1723 * System V doesn't have a non-blocking wait system call. It does
1724 * have a SIGCLD signal that is sent to a process when one of its
1725 * children dies. The obvious way to use SIGCLD would be to install
1726 * a handler for SIGCLD which simply bumped a counter when a SIGCLD
1727 * was received, and have waitproc bump another counter when it got
1728 * the status of a process. Waitproc would then know that a wait
1729 * system call would not block if the two counters were different.
1730 * This approach doesn't work because if a process has children that
1731 * have not been waited for, System V will send it a SIGCLD when it
1732 * installs a signal handler for SIGCLD. What this means is that when
1733 * a child exits, the shell will be sent SIGCLD signals continuously
1734 * until is runs out of stack space, unless it does a wait call before
1735 * restoring the signal handler. The code below takes advantage of
1736 * this (mis)feature by installing a signal handler for SIGCLD and
1737 * then checking to see whether it was called. If there are any
1738 * children to be waited for, it will be.
1739 *
1740 * If neither SYSV nor BSD is defined, we don't implement nonblocking
1741 * waits at all. In this case, the user will not be informed when
1742 * a background process ends until the next time she runs a real program
1743 * (as opposed to running a builtin command or just typing return),
1744 * and the jobs command may give out of date information.
1745 */
1746
1747 #ifdef SYSV
1748 STATIC int gotsigchild;
1749
1750 STATIC int onsigchild() {
1751 gotsigchild = 1;
1752 }
1753 #endif
1754
1755
1756 STATIC int
1757 waitproc(int block, struct job *jp, int *status)
1758 {
1759 #ifdef BSD
1760 int flags = 0;
1761
1762 #if JOBS
1763 if (mflag || (jp != NULL && jp->jobctl))
1764 flags |= WUNTRACED | WCONTINUED;
1765 #endif
1766 if (block == 0)
1767 flags |= WNOHANG;
1768 VTRACE(DBG_WAIT, ("waitproc: doing waitpid(flags=%#x)\n", flags));
1769 return waitpid(-1, status, flags);
1770 #else
1771 #ifdef SYSV
1772 int (*save)();
1773
1774 if (block == 0) {
1775 gotsigchild = 0;
1776 save = signal(SIGCLD, onsigchild);
1777 signal(SIGCLD, save);
1778 if (gotsigchild == 0)
1779 return 0;
1780 }
1781 return wait(status);
1782 #else
1783 if (block == 0)
1784 return 0;
1785 return wait(status);
1786 #endif
1787 #endif
1788 }
1789
1790 /*
1791 * return 1 if there are stopped jobs, otherwise 0
1792 */
1793 int job_warning = 0;
1794 int
1795 stoppedjobs(void)
1796 {
1797 int jobno;
1798 struct job *jp;
1799
1800 if (job_warning || jobs_invalid)
1801 return (0);
1802 for (jobno = 1, jp = jobtab; jobno <= njobs; jobno++, jp++) {
1803 if (jp->used == 0)
1804 continue;
1805 if (jp->state == JOBSTOPPED) {
1806 out2str("You have stopped jobs.\n");
1807 job_warning = 2;
1808 return (1);
1809 }
1810 }
1811
1812 return (0);
1813 }
1814
1815 /*
1816 * Return a string identifying a command (to be printed by the
1817 * jobs command).
1818 */
1819
1820 STATIC char *cmdnextc;
1821 STATIC int cmdnleft;
1822
1823 void
1824 commandtext(struct procstat *ps, union node *n)
1825 {
1826 int len;
1827
1828 cmdnextc = ps->cmd;
1829 if (iflag || mflag || sizeof(ps->cmd) <= 60)
1830 len = sizeof(ps->cmd);
1831 else if (sizeof ps->cmd <= 400)
1832 len = 50;
1833 else if (sizeof ps->cmd <= 800)
1834 len = 80;
1835 else
1836 len = sizeof(ps->cmd) / 10;
1837 cmdnleft = len;
1838 (void)cmdtxt(n, 1);
1839 if (cmdnleft <= 0) {
1840 char *p = ps->cmd + len - 4;
1841 p[0] = '.';
1842 p[1] = '.';
1843 p[2] = '.';
1844 p[3] = 0;
1845 } else
1846 *cmdnextc = '\0';
1847
1848 VTRACE(DBG_JOBS,
1849 ("commandtext: ps->cmd %p, end %p, left %d\n\t\"%s\"\n",
1850 ps->cmd, cmdnextc, cmdnleft, ps->cmd));
1851 }
1852
1853
1854 /*
1855 * Generate a string describing tree node n & its descendants (recursive calls)
1856 *
1857 * Return true (non-zero) if the output is complete (ends with an operator)
1858 * so no ';' need be added before the following command. Return false (zero)
1859 * if a ';' is needed to terminate the output if it is followed by something
1860 * which is not an operator.
1861 */
1862 STATIC int
1863 cmdtxt(union node *n, int top)
1864 {
1865 union node *np;
1866 struct nodelist *lp;
1867 const char *p;
1868 int i;
1869
1870 if (n == NULL || cmdnleft <= 0)
1871 return 1;
1872 switch (n->type) {
1873 case NSEMI:
1874 if (!cmdtxt(n->nbinary.ch1, 0))
1875 cmdputs(";");
1876 cmdputs(" ");
1877 return cmdtxt(n->nbinary.ch2, 0);
1878 case NAND:
1879 (void)cmdtxt(n->nbinary.ch1, 0);
1880 cmdputs(" && ");
1881 return cmdtxt(n->nbinary.ch2, 0);
1882 case NOR:
1883 (void) cmdtxt(n->nbinary.ch1, 0);
1884 cmdputs(" || ");
1885 return cmdtxt(n->nbinary.ch2, 0);
1886 case NDNOT:
1887 cmdputs("! ");
1888 /* FALLTHROUGH */
1889 case NNOT:
1890 cmdputs("! ");
1891 return cmdtxt(n->nnot.com, 0);
1892 break;
1893 case NPIPE:
1894 for (lp = n->npipe.cmdlist ; lp ; lp = lp->next) {
1895 (void) cmdtxt(lp->n, 0);
1896 if (lp->next)
1897 cmdputs(" | ");
1898 }
1899 if (!top && n->npipe.backgnd) {
1900 cmdputs(" &");
1901 return 1;
1902 }
1903 return 0;
1904 case NSUBSHELL:
1905 cmdputs("(");
1906 (void) cmdtxt(n->nredir.n, 0);
1907 cmdputs(")");
1908 return 0;
1909 case NREDIR:
1910 case NBACKGND:
1911 return cmdtxt(n->nredir.n, top);
1912 case NIF:
1913 cmdputs("if ");
1914 if (!cmdtxt(n->nif.test, 0))
1915 cmdputs(";");
1916 cmdputs(" then ");
1917 i = cmdtxt(n->nif.ifpart, 0);
1918 if (n->nif.elsepart) {
1919 if (i == 0)
1920 cmdputs(";");
1921 cmdputs(" else ");
1922 i = cmdtxt(n->nif.elsepart, 0);
1923 }
1924 if (i == 0)
1925 cmdputs(";");
1926 cmdputs(" fi");
1927 return 0;
1928 case NWHILE:
1929 cmdputs("while ");
1930 goto until;
1931 case NUNTIL:
1932 cmdputs("until ");
1933 until:
1934 if (!cmdtxt(n->nbinary.ch1, 0))
1935 cmdputs(";");
1936 cmdputs(" do ");
1937 if (!cmdtxt(n->nbinary.ch2, 0))
1938 cmdputs(";");
1939 cmdputs(" done");
1940 return 0;
1941 case NFOR:
1942 cmdputs("for ");
1943 cmdputs(n->nfor.var);
1944 cmdputs(" in ");
1945 cmdlist(n->nfor.args, 1);
1946 cmdputs("; do ");
1947 if (!cmdtxt(n->nfor.body, 0))
1948 cmdputs(";");
1949 cmdputs(" done");
1950 return 0;
1951 case NCASE:
1952 cmdputs("case ");
1953 cmdputs(n->ncase.expr->narg.text);
1954 cmdputs(" in ");
1955 for (np = n->ncase.cases; np; np = np->nclist.next) {
1956 (void) cmdtxt(np->nclist.pattern, 0);
1957 cmdputs(") ");
1958 (void) cmdtxt(np->nclist.body, 0);
1959 switch (n->type) { /* switch (not if) for later */
1960 case NCLISTCONT:
1961 cmdputs(" ;& ");
1962 break;
1963 default:
1964 cmdputs(" ;; ");
1965 break;
1966 }
1967 }
1968 cmdputs("esac");
1969 return 0;
1970 case NDEFUN:
1971 cmdputs(n->narg.text);
1972 cmdputs("() { ... }");
1973 return 0;
1974 case NCMD:
1975 cmdlist(n->ncmd.args, 1);
1976 cmdlist(n->ncmd.redirect, 0);
1977 if (!top && n->ncmd.backgnd) {
1978 cmdputs(" &");
1979 return 1;
1980 }
1981 return 0;
1982 case NARG:
1983 cmdputs(n->narg.text);
1984 return 0;
1985 case NTO:
1986 p = ">"; i = 1; goto redir;
1987 case NCLOBBER:
1988 p = ">|"; i = 1; goto redir;
1989 case NAPPEND:
1990 p = ">>"; i = 1; goto redir;
1991 case NTOFD:
1992 p = ">&"; i = 1; goto redir;
1993 case NFROM:
1994 p = "<"; i = 0; goto redir;
1995 case NFROMFD:
1996 p = "<&"; i = 0; goto redir;
1997 case NFROMTO:
1998 p = "<>"; i = 0; goto redir;
1999 redir:
2000 if (n->nfile.fd != i)
2001 cmdputi(n->nfile.fd);
2002 cmdputs(p);
2003 if (n->type == NTOFD || n->type == NFROMFD) {
2004 if (n->ndup.dupfd < 0)
2005 cmdputs("-");
2006 else
2007 cmdputi(n->ndup.dupfd);
2008 } else {
2009 (void) cmdtxt(n->nfile.fname, 0);
2010 }
2011 return 0;
2012 case NHERE:
2013 case NXHERE:
2014 cmdputs("<<...");
2015 return 0;
2016 default:
2017 cmdputs("???");
2018 return 0;
2019 }
2020 return 0;
2021 }
2022
2023 STATIC void
2024 cmdlist(union node *np, int sep)
2025 {
2026 for (; np; np = np->narg.next) {
2027 if (!sep)
2028 cmdputs(" ");
2029 (void) cmdtxt(np, 0);
2030 if (sep && np->narg.next)
2031 cmdputs(" ");
2032 }
2033 }
2034
2035
2036 STATIC void
2037 cmdputs(const char *s)
2038 {
2039 const char *p, *str = 0;
2040 char c, cc[2] = " ";
2041 char *nextc;
2042 int nleft;
2043 int subtype = 0;
2044 int quoted = 0;
2045 static char vstype[16][4] = { "", "}", "-", "+", "?", "=",
2046 "#", "##", "%", "%%", "}" };
2047
2048 p = s;
2049 nextc = cmdnextc;
2050 nleft = cmdnleft;
2051 while (nleft > 0 && (c = *p++) != 0) {
2052 switch (c) {
2053 case CTLNONL:
2054 c = '\0';
2055 break;
2056 case CTLESC:
2057 c = *p++;
2058 break;
2059 case CTLVAR:
2060 subtype = *p++;
2061 if (subtype & VSLINENO) { /* undo LINENO hack */
2062 if ((subtype & VSTYPE) == VSLENGTH)
2063 str = "${#LINENO"; /*}*/
2064 else
2065 str = "${LINENO"; /*}*/
2066 while (is_digit(*p))
2067 p++;
2068 } else if ((subtype & VSTYPE) == VSLENGTH)
2069 str = "${#"; /*}*/
2070 else
2071 str = "${"; /*}*/
2072 if (!(subtype & VSQUOTE) != !(quoted & 1)) {
2073 quoted ^= 1;
2074 c = '"';
2075 } else {
2076 c = *str++;
2077 }
2078 break;
2079 case CTLENDVAR: /*{*/
2080 c = '}';
2081 if (quoted & 1)
2082 str = "\"";
2083 quoted >>= 1;
2084 subtype = 0;
2085 break;
2086 case CTLBACKQ:
2087 c = '$';
2088 str = "(...)";
2089 break;
2090 case CTLBACKQ+CTLQUOTE:
2091 c = '"';
2092 str = "$(...)\"";
2093 break;
2094 case CTLARI:
2095 c = '$';
2096 if (*p == ' ')
2097 p++;
2098 str = "(("; /*))*/
2099 break;
2100 case CTLENDARI: /*((*/
2101 c = ')';
2102 str = ")";
2103 break;
2104 case CTLQUOTEMARK:
2105 quoted ^= 1;
2106 c = '"';
2107 break;
2108 case CTLQUOTEEND:
2109 quoted >>= 1;
2110 c = '"';
2111 break;
2112 case '=':
2113 if (subtype == 0)
2114 break;
2115 str = vstype[subtype & VSTYPE];
2116 if (subtype & VSNUL)
2117 c = ':';
2118 else
2119 c = *str++; /*{*/
2120 if (c != '}')
2121 quoted <<= 1;
2122 else if (*p == CTLENDVAR)
2123 c = *str++;
2124 subtype = 0;
2125 break;
2126 case '\'':
2127 case '\\':
2128 case '"':
2129 case '$':
2130 /* These can only happen inside quotes */
2131 cc[0] = c;
2132 str = cc;
2133 c = '\\';
2134 break;
2135 default:
2136 break;
2137 }
2138 if (c != '\0') do { /* c == 0 implies nothing in str */
2139 *nextc++ = c;
2140 } while (--nleft > 0 && str && (c = *str++));
2141 str = 0;
2142 }
2143 if ((quoted & 1) && nleft) {
2144 *nextc++ = '"';
2145 nleft--;
2146 }
2147 cmdnleft = nleft;
2148 cmdnextc = nextc;
2149 }
2150