Annotation of sys/sys/wait.h, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: wait.h,v 1.14 2006/04/27 02:17:21 tedu Exp $ */
2: /* $NetBSD: wait.h,v 1.11 1996/04/09 20:55:51 cgd Exp $ */
3:
4: /*
5: * Copyright (c) 1982, 1986, 1989, 1993, 1994
6: * The Regents of the University of California. All rights reserved.
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. Neither the name of the University nor the names of its contributors
17: * may be used to endorse or promote products derived from this software
18: * without specific prior written permission.
19: *
20: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30: * SUCH DAMAGE.
31: *
32: * @(#)wait.h 8.2 (Berkeley) 7/10/94
33: */
34:
35: #ifndef _SYS_WAIT_H_
36: #define _SYS_WAIT_H_
37:
38: #include <sys/cdefs.h>
39:
40: /*
41: * This file holds definitions relevent to the wait4 system call
42: * and the alternate interfaces that use it (wait, wait3, waitpid).
43: */
44:
45: /*
46: * Macros to test the exit status returned by wait
47: * and extract the relevant values.
48: */
49: #if __BSD_VISIBLE
50: #define _W_INT(w) (*(int *)&(w)) /* convert union wait to int */
51: #else
52: #define _W_INT(i) (i)
53: #endif
54:
55: #define _WSTATUS(x) (_W_INT(x) & 0177)
56: #define _WSTOPPED 0177 /* _WSTATUS if process is stopped */
57: #define _WCONTINUED 0177777 /* process has continued */
58: #define WIFSTOPPED(x) ((_W_INT(x) & 0xff) == _WSTOPPED)
59: #define WSTOPSIG(x) (int)(((unsigned)_W_INT(x) >> 8) & 0xff)
60: #define WIFSIGNALED(x) (_WSTATUS(x) != _WSTOPPED && _WSTATUS(x) != 0)
61: #define WTERMSIG(x) (_WSTATUS(x))
62: #define WIFEXITED(x) (_WSTATUS(x) == 0)
63: #define WEXITSTATUS(x) (int)(((unsigned)_W_INT(x) >> 8) & 0xff)
64: #define WIFCONTINUED(x) ((_W_INT(x) & _WCONTINUED) == _WCONTINUED)
65: #if __XPG_VISIBLE
66: #define WCOREFLAG 0200
67: #define WCOREDUMP(x) (_W_INT(x) & WCOREFLAG)
68:
69: #define W_EXITCODE(ret, sig) ((ret) << 8 | (sig))
70: #define W_STOPCODE(sig) ((sig) << 8 | _WSTOPPED)
71: #endif
72:
73: /*
74: * Option bits for the third argument of wait4. WNOHANG causes the
75: * wait to not hang if there are no stopped or terminated processes, rather
76: * returning an error indication in this case (pid==0). WUNTRACED
77: * indicates that the caller should receive status about untraced children
78: * which stop due to signals. If children are stopped and a wait without
79: * this option is done, it is as though they were still running... nothing
80: * about them is returned.
81: */
82: #define WNOHANG 1 /* don't hang in wait */
83: #define WUNTRACED 2 /* tell about stopped, untraced children */
84: #if __XPG_VISIBLE
85: #define WALTSIG 4 /* wait for child with alternate exit signal */
86: #endif
87: #define WCONTINUED 8 /* report a job control continued process */
88:
89: #if __BSD_VISIBLE
90: /*
91: * Tokens for special values of the "pid" parameter to wait4.
92: */
93: #define WAIT_ANY (-1) /* any process */
94: #define WAIT_MYPGRP 0 /* any process in my process group */
95:
96: #include <sys/types.h>
97:
98: /*
99: * Deprecated:
100: * Structure of the information in the status word returned by wait4.
101: * If w_stopval==WSTOPPED, then the second structure describes
102: * the information returned, else the first.
103: */
104: union wait {
105: int w_status; /* used in syscall */
106: /*
107: * Terminated process status.
108: */
109: struct {
110: #if _BYTE_ORDER == _LITTLE_ENDIAN
111: unsigned int w_Termsig:7, /* termination signal */
112: w_Coredump:1, /* core dump indicator */
113: w_Retcode:8, /* exit code if w_termsig==0 */
114: w_Filler:16; /* upper bits filler */
115: #endif
116: #if _BYTE_ORDER == _BIG_ENDIAN
117: unsigned int w_Filler:16, /* upper bits filler */
118: w_Retcode:8, /* exit code if w_termsig==0 */
119: w_Coredump:1, /* core dump indicator */
120: w_Termsig:7; /* termination signal */
121: #endif
122: } w_T;
123: /*
124: * Stopped process status. Returned
125: * only for traced children unless requested
126: * with the WUNTRACED option bit.
127: */
128: struct {
129: #if _BYTE_ORDER == _LITTLE_ENDIAN
130: unsigned int w_Stopval:8, /* == W_STOPPED if stopped */
131: w_Stopsig:8, /* signal that stopped us */
132: w_Filler:16; /* upper bits filler */
133: #endif
134: #if _BYTE_ORDER == _BIG_ENDIAN
135: unsigned int w_Filler:16, /* upper bits filler */
136: w_Stopsig:8, /* signal that stopped us */
137: w_Stopval:8; /* == W_STOPPED if stopped */
138: #endif
139: } w_S;
140: };
141: #define w_termsig w_T.w_Termsig
142: #define w_coredump w_T.w_Coredump
143: #define w_retcode w_T.w_Retcode
144: #define w_stopval w_S.w_Stopval
145: #define w_stopsig w_S.w_Stopsig
146:
147: #define WSTOPPED _WSTOPPED
148: #endif /* __BSD_VISIBLE */
149:
150: #ifndef _KERNEL
151: #include <sys/types.h>
152:
153: __BEGIN_DECLS
154: struct rusage; /* forward declaration */
155:
156: pid_t wait(int *);
157: pid_t waitpid(pid_t, int *, int);
158: #if __BSD_VISIBLE
159: pid_t wait3(int *, int, struct rusage *);
160: pid_t wait4(pid_t, int *, int, struct rusage *);
161: #endif
162: __END_DECLS
163: #endif
164:
165: #endif /* !_SYS_WAIT_H_ */
CVSweb