sys_wait: Implement WSTOPSIG.
[gnulib.git] / lib / sys_wait.in.h
1 /* A POSIX-like <sys/wait.h>.
2    Copyright (C) 2001-2003, 2005-2010 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software Foundation,
16    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
17
18
19 #ifndef _GL_SYS_WAIT_H
20
21 #if __GNUC__ >= 3
22 @PRAGMA_SYSTEM_HEADER@
23 #endif
24
25 /* The include_next requires a split double-inclusion guard.  */
26 #if !((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
27 # @INCLUDE_NEXT@ @NEXT_SYS_WAIT_H@
28 #endif
29
30 #ifndef _GL_SYS_WAIT_H
31 #define _GL_SYS_WAIT_H
32
33 #if !((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
34 /* Unix API.  */
35
36 /* The following macros apply to an argument x, that is a status of a process,
37    as returned by waitpid().
38    On nearly all systems, including Linux/x86, WEXITSTATUS are bits 15..8 and
39    WTERMSIG are bits 7..0, while BeOS uses the opposite.  Therefore programs
40    have to use the abstract macros.  */
41
42 /* For valid x, exactly one of WIFSIGNALED(x), WIFEXITED(x), WIFSTOPPED(x)
43    is true.  */
44 # ifndef WIFSIGNALED
45 #  define WIFSIGNALED(x) (WTERMSIG (x) != 0 && WTERMSIG(x) != 0x7f)
46 # endif
47 # ifndef WIFEXITED
48 #  define WIFEXITED(x) (WTERMSIG (x) == 0)
49 # endif
50 # ifndef WIFSTOPPED
51 #  define WIFSTOPPED(x) (WTERMSIG (x) == 0x7f)
52 # endif
53
54 /* The termination signal. Only to be accessed if WIFSIGNALED(x) is true.  */
55 # ifndef WTERMSIG
56 #  define WTERMSIG(x) ((x) & 0x7f)
57 # endif
58
59 /* The exit status. Only to be accessed if WIFEXITED(x) is true.  */
60 # ifndef WEXITSTATUS
61 #  define WEXITSTATUS(x) (((x) >> 8) & 0xff)
62 # endif
63
64 /* The stopping signal. Only to be accessed if WIFSTOPPED(x) is true.  */
65 # ifndef WSTOPSIG
66 #  define WSTOPSIG(x) (((x) >> 8) & 0x7f)
67 # endif
68
69 /* True if the process dumped core.  Not standardized by POSIX.  */
70 # ifndef WCOREDUMP
71 #  define WCOREDUMP(x) ((x) & 0x80)
72 # endif
73
74 # ifdef __cplusplus
75 extern "C" {
76 # endif
77
78 /* Declarations of functions.  */
79
80 # ifdef __cplusplus
81 }
82 # endif
83
84 #else
85 /* Native Windows API.  */
86
87 # include <process.h> /* for _cwait, WAIT_CHILD */
88 # include <signal.h> /* for SIGTERM */
89
90 # define waitpid(pid,statusp,options) _cwait (statusp, pid, WAIT_CHILD)
91
92 /* The following macros apply to an argument x, that is a status of a process,
93    as returned by waitpid() or, equivalently, _cwait() or GetExitCodeProcess().
94    This value is simply an 'int', not composed of bit fields.  */
95
96 /* When an unhandled fatal signal terminates a process, the exit code is 3.  */
97 # define WIFSIGNALED(x) ((x) == 3)
98 # define WIFEXITED(x) ((x) != 3)
99 # define WIFSTOPPED(x) 0
100
101 /* The signal that terminated a process is not known posthum.  */
102 # define WTERMSIG(x) SIGTERM
103
104 # define WEXITSTATUS(x) (x)
105
106 /* There are no stopping signals.  */
107 # define WSTOPSIG(x) 0
108
109 /* There are no core dumps.  */
110 # define WCOREDUMP(x) 0
111
112 #endif
113
114 #endif /* _GL_SYS_WAIT_H */
115 #endif /* _GL_SYS_WAIT_H */