Home | History | Annotate | Line # | Download | only in sh
jobs.h revision 1.16 
      1 /*	$NetBSD: jobs.h,v 1.16 2002/11/24 22:35:40 christos 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. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *	This product includes software developed by the University of
     21  *	California, Berkeley and its contributors.
     22  * 4. Neither the name of the University nor the names of its contributors
     23  *    may be used to endorse or promote products derived from this software
     24  *    without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     29  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     36  * SUCH DAMAGE.
     37  *
     38  *	@(#)jobs.h	8.2 (Berkeley) 5/4/95
     39  */
     40 
     41 #include "output.h"
     42 
     43 /* Mode argument to forkshell.  Don't change FORK_FG or FORK_BG. */
     44 #define FORK_FG 0
     45 #define FORK_BG 1
     46 #define FORK_NOJOB 2
     47 
     48 /* mode flags for showjob(s) */
     49 #define	SHOW_PGID	0x01	/* only show pgid - for jobs -p */
     50 #define	SHOW_MULTILINE	0x02	/* one line per process */
     51 #define	SHOW_PID	0x04	/* include process pid */
     52 #define	SHOW_CHANGED	0x08	/* only jobs whose state has changed */
     53 #define	SHOW_SIGNALLED	0x10	/* only if stopped/exited on signal */
     54 #define	SHOW_ISSIG	0x20	/* job was signalled */
     55 #define	SHOW_NO_FREE	0x40	/* do not free job */
     56 
     57 
     58 /*
     59  * A job structure contains information about a job.  A job is either a
     60  * single process or a set of processes contained in a pipeline.  In the
     61  * latter case, pidlist will be non-NULL, and will point to a -1 terminated
     62  * array of pids.
     63  */
     64 #ifdef SMALL
     65 #define	MAXCMDTEXT	20
     66 #else
     67 #define	MAXCMDTEXT	200
     68 #endif
     69 
     70 struct procstat {
     71 	pid_t	pid;		/* process id */
     72  	int	status;		/* last process status from wait() */
     73  	char	cmd[MAXCMDTEXT];/* text of command being run */
     74 };
     75 
     76 
     77 /* states */
     78 #define JOBSTOPPED 1		/* all procs are stopped */
     79 #define JOBDONE 2		/* all procs are completed */
     80 
     81 
     82 struct job {
     83 	struct procstat ps0;	/* status of process */
     84 	struct procstat *ps;	/* status or processes when more than one */
     85 	int	nprocs;		/* number of processes */
     86 	pid_t	pgrp;		/* process group of this job */
     87 	char	state;
     88 #define	JOBRUNNING	0	/* at least one proc running */
     89 #define	JOBSTOPPED	1	/* all procs are stopped */
     90 #define	JOBDONE		2	/* all procs are completed */
     91 	char	used;		/* true if this entry is in used */
     92 	char	changed;	/* true if status has changed */
     93 #if JOBS
     94 	char 	jobctl;		/* job running under job control */
     95 	int	prev_job;	/* previous job index */
     96 #endif
     97 };
     98 
     99 extern pid_t backgndpid;	/* pid of last background process */
    100 extern int job_warning;		/* user was warned about stopped jobs */
    101 
    102 void setjobctl(int);
    103 int fgcmd(int, char **);
    104 int bgcmd(int, char **);
    105 int jobscmd(int, char **);
    106 void showjobs(struct output *, int);
    107 int waitcmd(int, char **);
    108 int jobidcmd(int, char **);
    109 struct job *makejob(union node *, int);
    110 int forkshell(struct job *, union node *, int);
    111 void forkchild(struct job *, union node *, int, int);
    112 int forkparent(struct job *, union node *, int, pid_t);
    113 int waitforjob(struct job *);
    114 int stoppedjobs(void);
    115 void commandtext(struct procstat *, union node *);
    116 int getjobpgrp(const char *);
    117 
    118 #if ! JOBS
    119 #define setjobctl(on)	/* do nothing */
    120 #endif
    121