Home | History | Annotate | Line # | Download | only in sh
jobs.h revision 1.23 
      1 /*	$NetBSD: jobs.h,v 1.23 2018/09/11 03:30:40 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  *	@(#)jobs.h	8.2 (Berkeley) 5/4/95
     35  */
     36 
     37 #include "output.h"
     38 
     39 /* Mode argument to forkshell.  Don't change FORK_FG or FORK_BG. */
     40 #define FORK_FG 0
     41 #define FORK_BG 1
     42 #define FORK_NOJOB 2
     43 
     44 /* mode flags for showjob(s) */
     45 #define	SHOW_PGID	0x01	/* only show pgid - for jobs -p */
     46 #define	SHOW_MULTILINE	0x02	/* one line per process */
     47 #define	SHOW_PID	0x04	/* include process pid */
     48 #define	SHOW_CHANGED	0x08	/* only jobs whose state has changed */
     49 #define	SHOW_SIGNALLED	0x10	/* only if stopped/exited on signal */
     50 #define	SHOW_ISSIG	0x20	/* job was signalled */
     51 #define	SHOW_NO_FREE	0x40	/* do not free job */
     52 
     53 
     54 /*
     55  * A job structure contains information about a job.  A job is either a
     56  * single process or a set of processes contained in a pipeline.  In the
     57  * latter case, pidlist will be non-NULL, and will point to a -1 terminated
     58  * array of pids.
     59  */
     60 #define	MAXCMDTEXT	200
     61 
     62 struct procstat {
     63 	pid_t	pid;		/* process id */
     64  	int	status;		/* last process status from wait() */
     65  	char	cmd[MAXCMDTEXT];/* text of command being run */
     66 };
     67 
     68 struct job {
     69 	struct procstat ps0;	/* status of process */
     70 	struct procstat *ps;	/* status or processes when more than one */
     71 	void	*ref;		/* temporary reference, used variously */
     72 	int	nprocs;		/* number of processes */
     73 	pid_t	pgrp;		/* process group of this job */
     74 	char	state;
     75 #define	JOBRUNNING	0	/* at least one proc running */
     76 #define	JOBSTOPPED	1	/* all procs are stopped */
     77 #define	JOBDONE		2	/* all procs are completed */
     78 	char	used;		/* true if this entry is in used */
     79 	char	flags;
     80 #define	JOBCHANGED	1	/* set if status has changed */
     81 #define	JOBWANTED	2	/* set if this is a job being sought */
     82 #define	JPIPEFAIL	4	/* set if -o pipefail when job created */
     83 #if JOBS
     84 	char 	jobctl;		/* job running under job control */
     85 	int	prev_job;	/* previous job index */
     86 #endif
     87 };
     88 
     89 extern pid_t backgndpid;	/* pid of last background process */
     90 extern int job_warning;		/* user was warned about stopped jobs */
     91 
     92 void setjobctl(int);
     93 void showjobs(struct output *, int);
     94 struct job *makejob(union node *, int);
     95 int forkshell(struct job *, union node *, int);
     96 void forkchild(struct job *, union node *, int, int);
     97 int forkparent(struct job *, union node *, int, pid_t);
     98 int waitforjob(struct job *);
     99 int stoppedjobs(void);
    100 void commandtext(struct procstat *, union node *);
    101 int getjobpgrp(const char *);
    102 
    103 #if ! JOBS
    104 #define setjobctl(on)	/* do nothing */
    105 #endif
    106