siginterrupt(3)        C LIBRARY FUNCTIONS        siginterrupt(3)



NAME
     siginterrupt - allow signals to interrupt system calls

SYNOPSIS
     cc [ flag... ] file ... -lucb
     int siginterrupt(sig, flag)
     int sig, flag;

DESCRIPTION
     siginterrupt is used  to  change  the  system  call  restart
     behavior  when a system call is interrupted by the specified
     signal.  If the flag is false (0), then system calls will be
     restarted  if  they  are interrupted by the specified signal
     and no data has been transferred yet.  System  call  restart
     is  the default behavior when the signal(3) routine is used.
     If the flag is true (1), then restarting of system calls  is
     disabled.   If a system call is interrupted by the specified
     signal and no data has been  transferred,  the  system  call
     will  return -1 with errno set to EINTR.  Interrupted system
     calls that have started transferring data  will  return  the
     amount of data actually transferred.  Issuing a siginterrupt
     call during the execution of a signal handler will cause the
     new action to take place on the next signal to be caught.

NOTES
     This library routine uses an extension of the sigvec(2) sys-
     tem  call  that  is not available in 4.2BSD, hence it should
     not be used if backward compatibility is needed.

RETURN VALUE
     A 0 value indicates that the call  succeeded.   A  -1  value
     indicates that an invalid signal number has been supplied.

SEE ALSO
     sigblock(3),  sigpause(3),  sigsetmask(3),  sigvec(3),  sig-
     nal(3).  signal(2) in the Programmer's Reference Manual.



















             Last change: BSD Compatibility Package             1