HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man2/!!!intro.2
________________________________________________________________
___ ___
s
siginterrupt(2) siginterrupt(2)
NAME
siginterrupt - allow signalsto interrupt functions
SYNOPSIS
#include <signal.h>
int siginterrupt(int sig, int flag);
DESCRIPTION
The siginterrupt() function is used to change the restart behaviour when a function is interrupted by
the specified signal. The function siginterrupt (sig, flag) has an effect as if implemented as:
siginterrupt(int sig, int flag) {
int ret;
struct sigaction act;
(void) sigaction(sig, NULL, &act);
if (flag)
act.sa_flags &= ˜SA_RESTART;
else
act.sa_flags |= SA_RESTART;
ret = sigaction(sig, &act, NULL);
return ret;
}
RETURN VALUE
Upon successful completion, siginterrupt()
returns 0. Otherwise −1 is returned and errno is set to
indicate the error.
ERRORS
The
siginterrupt() function will fail if:
[EINVAL] The sig argument is not a valid signal number.
APPLICATION USAGE
The
siginterrupt() function supports programs written to historical system interfaces. A portable
application, when being written or rewritten, should use
sigaction() with the SA_RESTART flag
instead of siginterrupt().
Threads Considerations
System call restart is a process attribute. Therefore, changing the restart behavior affects all threads in
the process.
SEE ALSO
sigaction(2), <signal.h>.
CHANGE HISTORY
First released in Issue 4, Version 2.
Section 2−−346 − 1 − HP-UX Release 11i: December 2000
___
___