Movatterモバイル変換

sigpause(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ATTRIBUTES \|VERSIONS \|STANDARDS \|HISTORY \|SEE ALSO \|COLOPHON

sigpause(3)              Library Functions Manualsigpause(3)

NAME top

       sigpause - atomically release blocked signals and wait for       interrupt

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <signal.h>[[deprecated]] int sigpause(intsigmask);  /* BSD (but see VERSIONS) */[[deprecated]] int sigpause(intsig);      /* POSIX.1 / SysV / UNIX 95 */

DESCRIPTION top

       Don't use this function.  Usesigsuspend(2) instead.       The functionsigpause() is designed to wait for some signal.  It       changes the process's signal mask (set of blocked signals), and       then waits for a signal to arrive.  Upon arrival of a signal, the       original signal mask is restored.

RETURN VALUE top

       Ifsigpause() returns, it was interrupted by a signal and the       return value is -1 witherrno set toEINTR.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │sigpause()                           │ Thread safety │ MT-Safe │       └──────────────────────────────────────┴───────────────┴─────────┘

VERSIONS top

       On Linux, this routine is a system call only on the Sparc       (sparc64) architecture.       glibc uses the BSD version if the_BSD_SOURCEfeature test macro       is defined and none of_POSIX_SOURCE,_POSIX_C_SOURCE,_XOPEN_SOURCE,_GNU_SOURCE, or_SVID_SOURCEis defined.       Otherwise, the System V version is used, and feature test macros       must be defined as follows to obtain the declaration:       •  Since glibc 2.26: _XOPEN_SOURCE >= 500       •  glibc 2.25 and earlier: _XOPEN_SOURCE       Since glibc 2.19, only the System V version is exposed by<signal.h>; applications that formerly used the BSDsigpause()       should be amended to usesigsuspend(2).

STANDARDS top

       POSIX.1-2008.

HISTORY top

       POSIX.1-2001.  Obsoleted in POSIX.1-2008.       The classical BSD version of this function appeared in 4.2BSD.  It       sets the process's signal mask tosigmask.  UNIX 95 standardized       the incompatible System V version of this function, which removes       only the specified signalsig from the process's signal mask.  The       unfortunate situation with two incompatible functions with the       same name was solved by thesigsuspend(2) function, that takes asigset_t * argument (instead of anint).

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17sigpause(3)

Pages that refer to this page:sigset(3), sigvec(3), signal-safety(7)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.