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 "shell.h"
41#include <signal.h> /* for sig_atomic_t */
42
43struct job;
44
45enum {
46  SHOWJOBS_DEFAULT, /* job number, status, command */
47  SHOWJOBS_VERBOSE, /* job number, PID, status, command */
48  SHOWJOBS_PIDS,    /* PID only */
49  SHOWJOBS_PGIDS    /* PID of the group leader only */
50};
51
52extern int job_warning; /* user was warned about stopped jobs */
53
54void        setjobctl(int);
55void        showjobs(int, int);
56struct job *makejob(union node *, int);
57pid_t       forkshell(struct job *, union node *, int);
58pid_t       vforkexecshell(struct job *, char **, char **, const char *, int, int[2]);
59int         waitforjob(struct job *, int *);
60int         stoppedjobs(void);
61int         backgndpidset(void);
62pid_t       backgndpidval(void);
63char       *commandtext(union node *);
64
65#if !JOBS
66#define setjobctl(on) /* do nothing */
67#endif