Return to siginterrupt.3 CVS log

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

Annotation of 43BSDReno/lib/libc/gen/siginterrupt.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1985 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)siginterrupt.3      6.1 (Berkeley) 5/15/85
                      6: .\"
                      7: .TH SIGINTERRUPT 3 "May 15, 1985"
                      8: .UC 6
                      9: .SH NAME
                     10: siginterrupt \- allow signals to interrupt system calls
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .B siginterrupt(sig, flag);
                     14: .B int sig, flag;
                     15: .SH DESCRIPTION
                     16: .I Siginterrupt
                     17: is used to change the system call restart
                     18: behavior when a system call is interrupted by the specified signal.
                     19: If the flag is false (0), then system calls will be restarted if
                     20: they are interrupted by the specified signal
                     21: and no data has been transferred yet.
                     22: System call restart is the default behavior on 4.2 BSD.
                     23: .PP
                     24: If the flag is true (1), then restarting of system calls is disabled.
                     25: If a system call is interrupted by the specified signal
                     26: and no data has been transferred,
                     27: the system call will return -1 with errno set to EINTR.
                     28: Interrupted system calls that have started transferring
                     29: data will return the amount of data actually transferred.
                     30: System call interrupt is the signal behavior found on 4.1 BSD
                     31: and AT&T System V UNIX systems.
                     32: .PP
                     33: Note that the new 4.2 BSD signal handling semantics are not
                     34: altered in any other way.
                     35: Most notably, signal handlers always remain installed until
                     36: explicitly changed by a subsequent
                     37: .IR sigvec (2)
                     38: call, and the signal mask operates as documented in
                     39: .IR sigvec (2).
                     40: Programs may switch between restartable and interruptible
                     41: system call operation as often as desired in the execution of a program.
                     42: .PP
                     43: Issuing a
                     44: .IR siginterrupt (3)
                     45: call during the execution of a signal handler will cause
                     46: the new action to take place on the next signal to be caught.
                     47: .SH NOTES
                     48: This library routine uses an extension of the
                     49: .IR sigvec (2)
                     50: system call that is not available in 4.2BSD,
                     51: hence it should not be used if backward compatibility is needed.
                     52: .SH "RETURN VALUE
                     53: A 0 value indicates that the call succeeded.
                     54: A -1 value indicates that an invalid signal number has been supplied.
                     55: .SH "SEE ALSO"
                     56: sigvec(2), sigblock(2), sigpause(2), sigsetmask(2).

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