Home | History | Annotate | Line # | Download | only in sh
jobs.h revision 1.5 
      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. All advertising materials mentioning features or use of this software
     17  *    must display the following acknowledgement:
     18  *	This product includes software developed by the University of
     19  *	California, Berkeley and its contributors.
     20  * 4. Neither the name of the University nor the names of its contributors
     21  *    may be used to endorse or promote products derived from this software
     22  *    without specific prior written permission.
     23  *
     24  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     34  * SUCH DAMAGE.
     35  *
     36  *	@(#)jobs.h	8.1 (Berkeley) 5/31/93
     37  */
     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 
     45 /*
     46  * A job structure contains information about a job.  A job is either a
     47  * single process or a set of processes contained in a pipeline.  In the
     48  * latter case, pidlist will be non-NULL, and will point to a -1 terminated
     49  * array of pids.
     50  */
     51 
     52 struct procstat {
     53 	short pid;		/* process id */
     54 	short status;		/* status flags (defined above) */
     55 	char *cmd;		/* text of command being run */
     56 };
     57 
     58 
     59 /* states */
     60 #define JOBSTOPPED 1		/* all procs are stopped */
     61 #define JOBDONE 2		/* all procs are completed */
     62 
     63 
     64 struct job {
     65 	struct procstat ps0;	/* status of process */
     66 	struct procstat *ps;	/* status or processes when more than one */
     67 	short nprocs;		/* number of processes */
     68 	short pgrp;		/* process group of this job */
     69 	char state;		/* true if job is finished */
     70 	char used;		/* true if this entry is in used */
     71 	char changed;		/* true if status has changed */
     72 #if JOBS
     73 	char jobctl;		/* job running under job control */
     74 #endif
     75 };
     76 
     77 extern short backgndpid;	/* pid of last background process */
     78 extern int job_warning;		/* user was warned about stopped jobs */
     79 
     80 
     81 #ifdef __STDC__
     82 void setjobctl(int);
     83 void showjobs(int);
     84 struct job *makejob(union node *, int);
     85 int forkshell(struct job *, union node *, int);
     86 int waitforjob(struct job *);
     87 char *commandtext(union node *);
     88 #else
     89 void setjobctl();
     90 void showjobs();
     91 struct job *makejob();
     92 int forkshell();
     93 int waitforjob();
     94 char *commandtext();
     95 #endif
     96 
     97 #if ! JOBS
     98 #define setjobctl(on)	/* do nothing */
     99 #endif
    100