Home | History | Annotate | Download | only in csh
      1 /*
      2  * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
      3  * Use is subject to license terms.
      4  */
      5 
      6 /*
      7  *
      8  *	Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T
      9  *	  All Rights Reserved
     10  *
     11  * Copyright (c) 1980 Regents of the University of California.
     12  * All rights reserved.  The Berkeley Software License Agreement
     13  * specifies the terms and conditions for redistribution.
     14  */
     15 
     16 #pragma ident	"%Z%%M%	%I%	%E% SMI"
     17 
     18 /*
     19  * This file holds definitions relevant to the wait system call.
     20  * Some of the options here are available only through the ``wait3''
     21  * entry point; the old entry point with one argument has more fixed
     22  * semantics, never returning status of unstopped children, hanging until
     23  * a process terminates if any are outstanding, and never returns
     24  * detailed information about process resource utilization (<vtimes.h>).
     25  */
     26 
     27 #ifndef _sys_wait_h
     28 #define	_sys_wait_h
     29 
     30 #include <sys/isa_defs.h>	/* included for _LITTLE_ENDIAN define	*/
     31 
     32 /*
     33  * Structure of the information in the first word returned by both
     34  * wait and wait3.  If w_stopval==WSTOPPED, then the second structure
     35  * describes the information returned, else the first.  See WUNTRACED below.
     36  */
     37 union wait	{
     38 	int	w_status;		/* used in syscall */
     39 	/*
     40 	 * Terminated process status.
     41 	 */
     42 	struct {
     43 #if	defined(_LITTLE_ENDIAN)
     44 		unsigned short	w_Termsig:7;	/* termination signal */
     45 		unsigned short	w_Coredump:1;	/* core dump indicator */
     46 		unsigned short	w_Retcode:8;	/* exit code if w_termsig==0 */
     47 #elif	defined(_BIG_ENDIAN)
     48 		unsigned short	w_Fill1:16;	/* high 16 bits unused */
     49 		unsigned short	w_Retcode:8;	/* exit code if w_termsig==0 */
     50 		unsigned short	w_Coredump:1;	/* core dump indicator */
     51 		unsigned short	w_Termsig:7;	/* termination signal */
     52 #else
     53 #error	NO ENDIAN defined.
     54 #endif
     55 	} w_T;
     56 	/*
     57 	 * Stopped process status.  Returned
     58 	 * only for traced children unless requested
     59 	 * with the WUNTRACED option bit.
     60 	 */
     61 	struct {
     62 #if	defined(_LITTLE_ENDIAN)
     63 		unsigned short	w_Stopval:8;	/* == W_STOPPED if stopped */
     64 		unsigned short	w_Stopsig:8;	/* signal that stopped us */
     65 #elif	defined(_BIG_ENDIAN)
     66 		unsigned short	w_Fill2:16;	/* high 16 bits unused */
     67 		unsigned short	w_Stopsig:8;	/* signal that stopped us */
     68 		unsigned short	w_Stopval:8;	/* == W_STOPPED if stopped */
     69 #else
     70 #error	NO ENDIAN defined.
     71 #endif
     72 	} w_S;
     73 };
     74 #define	w_termsig	w_T.w_Termsig
     75 #define	w_coredump	w_T.w_Coredump
     76 #define	w_retcode	w_T.w_Retcode
     77 #define	w_stopval	w_S.w_Stopval
     78 #define	w_stopsig	w_S.w_Stopsig
     79 
     80 
     81 #define	WSTOPPED	0177	/* value of s.stopval if process is stopped */
     82 #define	WCONTFLG	0177777	/* value of w.w_status due to SIGCONT, sysV */
     83 
     84 /*
     85  * Option bits for the second argument of wait3.  WNOHANG causes the
     86  * wait to not hang if there are no stopped or terminated processes, rather
     87  * returning an error indication in this case (pid==0).  WUNTRACED
     88  * indicates that the caller should receive status about untraced children
     89  * which stop due to signals.  If children are stopped and a wait without
     90  * this option is done, it is as though they were still running... nothing
     91  * about them is returned.
     92  */
     93 #define	WNOHANG		1	/* dont hang in wait */
     94 #define	WUNTRACED	2	/* tell about stopped, untraced children */
     95 
     96 #define	WIFSTOPPED(x)	((x).w_stopval == WSTOPPED)
     97 #define	WIFSIGNALED(x)	((x).w_stopval != WSTOPPED && (x).w_termsig != 0)
     98 #define	WIFEXITED(x)	((x).w_stopval != WSTOPPED && (x).w_termsig == 0)
     99 
    100 extern pid_t csh_wait3(union wait *w, int options, struct rusage *rp);
    101 extern pid_t csh_wait_noreap(void);
    102 
    103 #endif /* _sys_wait_h */
    104