New module sigaction, for mingw.
[pspp] / doc / posix-functions / sigaction.texi
1 @node sigaction
2 @section @code{sigaction}
3 @findex sigaction
4
5 POSIX specification: @url{http://www.opengroup.org/susv3xsh/sigaction.html}
6
7 Gnulib module: sigaction
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 mingw.
14 @end itemize
15
16 Portability problems not fixed by Gnulib:
17 @itemize
18 @item
19 POSIX recommends that when specifying SA_RESETHAND, SA_NODEFER must
20 also be specified.
21
22 @item
23 Support for SA_ONSTACK is missing on some platforms:
24 mingw, cygwin.
25
26 @item
27 Support for SA_SIGINFO is missing on some platforms:
28 mingw, Interix 3.5.
29
30 @item
31 Support for SIGCHLD, and thus for SA_NOCLDSTOP and SA_NOCLDWAIT, is
32 missing on some platforms:
33 mingw.
34
35 @item
36 Support for SA_RESTART is missing on some platforms:
37 mingw.
38
39 @item
40 The symbolic value @code{SIG_IGN} for the @code{SIGCHLD} signal is equivalent
41 to a signal handler
42 @smallexample
43 void handle_child (int sigchld)
44 @{
45   while (waitpid (-1, NULL, WNOHANG) > 0)
46     ;
47 @}
48 @end smallexample
49 except that @code{SIG_IGN} for @code{SIGCHLD} has the effect that the children
50 execution times are not accounted in the @code{times} function.
51 On some platforms (BSD? SystemV? Linux?), you need to use the @code{sigaction}
52 flag @code{SA_NOCLDWAIT} in order to obtain this behavior.
53 @end itemize