raise(3C)						   Standard C Library Functions 						 raise(3C)

NAME

       raise - send a signal to the executing thread

SYNOPSIS

       #include <signal.h>

       int raise(int sig);

DESCRIPTION

       The  raise() function sends the signal sig to the executing thread. If a signal handler is called, the raise function does not return until
       after the signal handler returns.

       The effect of the raise function is equivalent to calling:

	 pthread_kill(pthread_self(), sig);

       See the pthread_kill(3C) manual page for a detailed list of failure conditions and the signal.h(3HEAD) manual page for a list of signals.

RETURN VALUES

       Upon successful completion, 0 is returned.  Otherwise, -1 is returned and errno is set to indicate the error.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       pthread_kill(3C), pthread_self(3C), signal.h(3HEAD), attributes(5), standards(5)

SunOS 5.11							    23 Mar 2005 							 raise(3C)