siginterrupt(3C)					   Standard C Library Functions 					  siginterrupt(3C)

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 siginter-
       rupt(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  writ-
       ten 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 TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.11							    1 Sep 2003							  siginterrupt(3C)