sigpause() -- System Call (libc)

Pause until a given signal is received
#include <signal.h>
int sigpause (sigtype)
int sigtype;

sigpause() is  a member  of the  sigset() family of  signal-handling system
calls.  It  pauses until  the signal sigtype  is received.  If,  however, a
signal of type sigtype had previously  been ``placed on hold'' by a call to
sighold(), sigpause()  releases the signal  for processing, just  as if you
had invoked the system call sigrelse().

See the Lexicon entry for signal() for a list of recognized signals.

sigpause()  returns zero  if all  went well.  If  something went  wrong, it
returns -1 and sets errno to an appropriate value.

See Also

libc,
sighold(),
sigignore(),
signal(),
sigrelse(),
sigset()

Notes

For  more information  on  the sigset()  family  of signal-handling  system
calls, see the Lexicon entry for sigset().

Note that invoking

    sigpause(SIGCHLD)

with no children pauses forever.

© 2012 by Stephen A. Ness