(Process Signal Mask): Document that pthread_sigmask, not sigprocmask, must be
authordrepper <drepper>
Tue, 29 Jan 2002 08:57:47 +0000 (08:57 +0000)
committerdrepper <drepper>
Tue, 29 Jan 2002 08:57:47 +0000 (08:57 +0000)
used in MT programs.

manual/signal.texi

index 5909402..903062f 100644 (file)
@@ -2561,6 +2561,12 @@ by modifying the signal mask.
 The prototype for the @code{sigprocmask} function is in @file{signal.h}.
 @pindex signal.h
 
+Note that you must not use @code{sigprocmask} in multi-threaded processes,
+because each thread has its own signal mask and there is no single process
+signal mask. According to POSIX, the behavior of @code{sigprocmask} in a
+multi-threaded process is ``unspeficied''. Instead, use 
+@code{pthread_sigmask} (@pxref{Threads and Signal Handling}).
+
 @comment signal.h
 @comment POSIX.1
 @deftypefun int sigprocmask (int @var{how}, const sigset_t *restrict @var{set}, sigset_t *restrict @var{oldset})