Content-type: text/html Man page of siginterrupt

siginterrupt

Section: Standard C Library Functions (3C)
Updated: 1 Sep 2003
Index Return to Main Contents
 

NAME

siginterrupt - allow signals to interrupt functions  

SYNOPSIS

#include <signal.h>

int siginterrupt(int sig, int flag);  

DESCRIPTION

The siginterrupt() function changes the restart behavior 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 VALUES

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.

 

USAGE

The siginterrupt() function supports programs written to historical system interfaces. A standard-conforming application, when being written or rewritten, should use sigaction(2) with the SA_RESTART flag instead of siginterrupt().  

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-LevelMT-Safe

 

SEE ALSO

sigaction(2), signal.h(3HEAD), attributes(5), standards(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
USAGE
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:18 GMT, October 02, 2010