Annotation of 43BSDReno/lib/libc/compat-43/sigpause.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: .\"    @(#)sigpause.2  6.5 (Berkeley) 7/1/90
                     19: .\"
                     20: .TH SIGPAUSE 2 "July 1, 1990"
                     21: .UC 4
                     22: .SH NAME
                     23: sigpause \- atomically release blocked signals and wait for interrupt
                     24: .SH SYNOPSIS
                     25: .ft B
                     26: sigpause(sigmask)
                     27: .br
                     28: int sigmask;
                     29: .ft R
                     30: .SH DESCRIPTION
                     31: .B "This interface is made obsolete by sigsuspend(2).
                     32: .LP
                     33: .I Sigpause
                     34: assigns 
                     35: .I sigmask
                     36: to the set of masked signals
                     37: and then waits for a signal to arrive;
                     38: on return the set of masked signals is restored.
                     39: .I Sigmask
                     40: is usually 0 to indicate that no
                     41: signals are now to be blocked.
                     42: .I Sigpause
                     43: always terminates by being interrupted, returning \-1 with
                     44: .I errno
                     45: set to EINTR.
                     46: .PP
                     47: In normal usage, a signal is blocked using
                     48: .IR sigblock (2),
                     49: to begin a critical section, variables modified on the occurrence
                     50: of the signal are examined to determine that there is no work
                     51: to be done, and the process pauses awaiting work by using
                     52: .I sigpause
                     53: with the mask returned by
                     54: .IR sigblock .
                     55: .SH SEE ALSO
                     56: sigsuspend(2), kill(2), sigaction(2), sigprocmask(2),
                     57: sigblock(2), sigvec(2)

unix.superglobalmegacorp.com

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