Movatterモバイル変換

sigsuspend(3p) — Linux manual page

PROLOG \|NAME \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|EXAMPLES \|APPLICATION USAGE \|RATIONALE \|FUTURE DIRECTIONS \|SEE ALSO \|COPYRIGHT

SIGSUSPEND(3P)          POSIX Programmer's ManualSIGSUSPEND(3P)

PROLOG top

       This manual page is part of the POSIX Programmer's Manual.  The       Linux implementation of this interface may differ (consult the       corresponding Linux manual page for details of Linux behavior), or       the interface may not be implemented on Linux.

NAME top

       sigsuspend — wait for a signal

SYNOPSIS top

       #include <signal.h>       int sigsuspend(const sigset_t *sigmask);

DESCRIPTION top

       Thesigsuspend() function shall replace the current signal mask of       the calling thread with the set of signals pointed to bysigmask       and then suspend the thread until delivery of a signal whose       action is either to execute a signal-catching function or to       terminate the process. This shall not cause any other signals that       may have been pending on the process to become pending on the       thread.       If the action is to terminate the process thensigsuspend() shall       never return. If the action is to execute a signal-catching       function, thensigsuspend() shall return after the signal-catching       function returns, with the signal mask restored to the set that       existed prior to thesigsuspend() call.       It is not possible to block signals that cannot be ignored. This       is enforced by the system without causing an error to be       indicated.

RETURN VALUE top

       Sincesigsuspend() suspends thread execution indefinitely, there       is no successful completion return value. If a return occurs, -1       shall be returned anderrno set to indicate the error.

ERRORS top

       Thesigsuspend() function shall fail if:EINTRA signal is caught by the calling process and control is              returned from the signal-catching function.The following sections are informative.

EXAMPLES top

       None.

APPLICATION USAGE top

       Normally, at the beginning of a critical code section, a specified       set of signals is blocked using thesigprocmask() function. When       the thread has completed the critical section and needs to wait       for the previously blocked signal(s), it pauses by callingsigsuspend() with the mask that was returned by thesigprocmask()       call.

RATIONALE top

       Code which wants to avoid the ambiguity of the signal mask for       thread cancellation handlers can install an additional       cancellation handler which resets the signal mask to the expected       value.           void cleanup(void *arg)           {               sigset_t *ss = (sigset_t *) arg;               pthread_sigmask(SIG_SETMASK, ss, NULL);           }           int call_sigsuspend(const sigset_t *mask)           {               sigset_t oldmask;               int result;               pthread_sigmask(SIG_SETMASK, NULL, &oldmask);               pthread_cleanup_push(cleanup, &oldmask);               result = sigsuspend(sigmask);               pthread_cleanup_pop(0);               return result;           }

FUTURE DIRECTIONS top

       None.

COPYRIGHT top

       Portions of this text are reprinted and reproduced in electronic       form from IEEE Std 1003.1-2017, Standard for Information       Technology -- Portable Operating System Interface (POSIX), The       Open Group Base Specifications Issue 7, 2018 Edition, Copyright       (C) 2018 by the Institute of Electrical and Electronics Engineers,       Inc and The Open Group.  In the event of any discrepancy between       this version and the original IEEE and The Open Group Standard,       the original IEEE and The Open Group Standard is the referee       document. The original Standard can be obtained online athttp://www.opengroup.org/unix/online.html .       Any typographical or formatting errors that appear in this page       are most likely to have been introduced during the conversion of       the source files to man page format. To report such errors, seehttps://www.kernel.org/doc/man-pages/reporting_bugs.html .IEEE/The Open Group                2017SIGSUSPEND(3P)

Pages that refer to this page:signal.h(0p), pause(3p), pthread_sigmask(3p), sigaction(3p), sigaddset(3p), sigdelset(3p), sigemptyset(3p), sigfillset(3p), sighold(3p), sigismember(3p), siglongjmp(3p), signal(3p), sigsetjmp(3p), sigtimedwait(3p), sigwait(3p)