ssiiggppaauussee() -- System Call (libc)

Pause until a given signal is received
#iinncclluuddee <ssiiggnnaall.hh>
iinntt ssiiggppaauussee (_s_i_g_t_y_p_e)
iinntt _s_i_g_t_y_p_e;

ssiiggppaauussee() is  a member  of the  ssiiggsseett() family of  signal-handling system
calls.  It  pauses until  the signal _s_i_g_t_y_p_e  is received.  If,  however, a
signal of type _s_i_g_t_y_p_e had previously  been ``placed on hold'' by a call to
ssiigghhoolldd(), ssiiggppaauussee()  releases the signal  for processing, just  as if you
had invoked the system call ssiiggrreellssee().

See the Lexicon entry for ssiiggnnaall() for a list of recognized signals.

ssiiggppaauussee()  returns zero  if all  went well.  If  something went  wrong, it
returns -1 and sets eerrrrnnoo to an appropriate value.

_S_e_e _A_l_s_o
lliibbcc, ssiigghhoolldd(), ssiiggiiggnnoorree(), ssiiggnnaall(), ssiiggrreellssee(), ssiiggsseett()

_N_o_t_e_s
For  more information  on  the ssiiggsseett()  family  of signal-handling  system
calls, see the Lexicon entry for ssiiggsseett().

Note that invoking

    sigpause(SIGCHLD)

with no children pauses forever.
