SIGINTERRUPT(2,L)           AIX Technical Reference           SIGINTERRUPT(2,L)



-------------------------------------------------------------------------------
siginterrupt



PURPOSE

Allows signals to interrupt system calls.

LIBRARY

Standard C Library (libc.a)

SYNTAX

#include <sys/signal.h>

int siginterrupt (sig, flag)
int sig, flag;

DESCRIPTION

The siginterrupt routine is used to change the restart behavior when a system
call is interrupted by the specified signal.  The restart behavior is set by
the sigaction system call when a signal handler is installed.  It can also be
modified using the sigaction system call.  The siginterrupt routine is provided
only for compatibility with 4.3BSD systems.

If the flag is 0, then system calls will be restarted if they are interrupted
by the specified signal and no data has been transferred yet.

If the flag is 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 and set errno to EINTR.  Interrupted system
calls that have started transferring data will return the amount of data
actually transferred.

RETURN VALUE

Upon successful completion, siginterrupt returns a value of 0.  Otherwise, -1
is returned and errno is set to indicate the error.

ERROR CONDITIONS

The siginterrupt routine fails if the following is true:

EINVAL  The sig parameter is not a valid signal number.

RELATED INFORMATION

In this book:  "sigaction, sigvec, signal," "sigprocmask, sigsetmask,
sigblock."



Processed November 7, 1990     SIGINTERRUPT(2,L)                              1