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

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.