xref: /freebsd/bin/sh/jobs.h (revision 1719886f6d08408b834d270c59ffcfd821c8f63a)
1 /*-
2  * Copyright (c) 1991, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * This code is derived from software contributed to Berkeley by
6  * Kenneth Almquist.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. Neither the name of the University nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  */
32 
33 /* Mode argument to forkshell.  Don't change FORK_FG or FORK_BG. */
34 #define FORK_FG 0
35 #define FORK_BG 1
36 #define FORK_NOJOB 2
37 
38 #include <signal.h>		/* for sig_atomic_t */
39 
40 struct job;
41 
42 enum {
43 	SHOWJOBS_DEFAULT,	/* job number, status, command */
44 	SHOWJOBS_VERBOSE,	/* job number, PID, status, command */
45 	SHOWJOBS_PIDS,		/* PID only */
46 	SHOWJOBS_PGIDS		/* PID of the group leader only */
47 };
48 
49 extern int job_warning;		/* user was warned about stopped jobs */
50 
51 void setjobctl(int);
52 void showjobs(int, int);
53 struct job *makejob(union node *, int);
54 pid_t forkshell(struct job *, union node *, int);
55 pid_t vforkexecshell(struct job *, char **, char **, const char *, int, int [2]);
56 int waitforjob(struct job *, int *);
57 int stoppedjobs(void);
58 int backgndpidset(void);
59 pid_t backgndpidval(void);
60 char *commandtext(union node *);
61 
62 #if ! JOBS
63 #define setjobctl(on)	/* do nothing */
64 #endif
65