SIGPAUSE(2) BSD System Calls Manual SIGPAUSE(2)

NAME
     ssiiggppaauussee - atomically release blocked signals and wait for interrupt

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     int
     ssiiggppaauussee(int sig);

DESCRIPTION
     TThhiiss iinntteerrffaaccee iiss mmaaddee oobbssoolleettee bbyy sigsuspend(2).

     SSiiggppaauussee() assigns sig to the set of masked signals and then waits for a
     signal to arrive; on return the set of masked signals is restored.  Sig
     is usually 0, indicating that no signals are to be blocked.  SSiiggppaauussee()
     always terminates by being interrupted, returning -1 with errno set to
     EINTR.

CCOOMMPPAATTIIBBIILLIITTYY
     ssiiggppaauussee() now takes a signal value and not a mask.  This often appears
     as a hang in sigpause$UNIX2003 or with ssiiggppaauussee() returning with errno
     set to EINVAL.  Use ssiiggssuussppeenndd() with signal masks.

SEE ALSO
     kill(2), sigaction(2), sigblock(2), sigprocmask(2), sigsuspend(2),
     sigvec(2)

HISTORY     The ssiiggppaauussee() function call appeared in 4.2BSD and has been deprecated.

BSD                              June 2, 1993                              BSD