Return to sigsuspend.2 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys

Annotation of 43BSDReno/lib/libc/sys/sigsuspend.2, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1983 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"    @(#)sigsuspend.2        6.1 (Berkeley) 7/1/90
        !            19: .\"
        !            20: .TH SIGSUSPEND 2 "July 1, 1990"
        !            21: .UC 7
        !            22: .SH NAME
        !            23: sigsuspend \- atomically release blocked signals and wait for interrupt
        !            24: .SH SYNOPSIS
        !            25: .B #include <signal.h>
        !            26: .ft B
        !            27: sigsuspend(sigmask)
        !            28: .br
        !            29: sigset_t *sigmask;
        !            30: .ft R
        !            31: .SH DESCRIPTION
        !            32: .I Sigsuspend
        !            33: temporarily changes the blocked signal mask to the set to which
        !            34: .I sigmask
        !            35: points,
        !            36: and then waits for a signal to arrive;
        !            37: on return the previous set of masked signals is restored.
        !            38: The signal mask set
        !            39: is usually empty to indicate that all
        !            40: signals are to be unblocked for the duration of the call.
        !            41: The
        !            42: .I sigsuspend
        !            43: function
        !            44: always terminates by being interrupted, returning \-1 with
        !            45: .I errno
        !            46: set to EINTR.
        !            47: .PP
        !            48: In normal usage, a signal is blocked using
        !            49: .IR sigprocmask (2),
        !            50: to begin a critical section, variables modified on the occurrence
        !            51: of the signal are examined to determine that there is no work
        !            52: to be done, and the process pauses awaiting work by using
        !            53: .I sigsuspend
        !            54: with the previous mask returned by
        !            55: .IR sigprocmask .
        !            56: .SH SEE ALSO
        !            57: sigprocmask(2), sigaction(2), sigsetops(3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.