master xplshn/aruu / cmd / posix / sh / jobs.h
 1/*-
 2 * SPDX-License-Identifier: BSD-3-Clause
 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/* Mode argument to forkshell.  Don't change FORK_FG or FORK_BG. */
36#define FORK_FG 0
37#define FORK_BG 1
38#define FORK_NOJOB 2
39
40#include <signal.h>		/* for sig_atomic_t */
41
42struct job;
43
44enum {
45	SHOWJOBS_DEFAULT,	/* job number, status, command */
46	SHOWJOBS_VERBOSE,	/* job number, PID, status, command */
47	SHOWJOBS_PIDS,		/* PID only */
48	SHOWJOBS_PGIDS		/* PID of the group leader only */
49};
50
51extern int job_warning;		/* user was warned about stopped jobs */
52
53void setjobctl(int);
54void showjobs(int, int);
55struct job *makejob(union node *, int);
56pid_t forkshell(struct job *, union node *, int);
57pid_t vforkexecshell(struct job *, char **, char **, const char *, int, int [2]);
58int waitforjob(struct job *, int *);
59int stoppedjobs(void);
60int backgndpidset(void);
61pid_t backgndpidval(void);
62char *commandtext(union node *);
63
64#if ! JOBS
65#define setjobctl(on)	/* do nothing */
66#endif