raise(3c) [sunos man page]

raise(3C)																 raise(3C)

NAME

       raise - send a signal to the executing thread

SYNOPSIS

       #include <signal.h>

       int raise(int sig);

       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.

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

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

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

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

								    23 Mar 2005 							 raise(3C)

raise(3)						     Library Functions Manual							  raise(3)

NAME

       raise - Sends a signal to the executing process or thread

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <signal.h>

       int raise(
	       int signal );

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       raise():  XSH5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Specifies a signal number.

DESCRIPTION

       The raise() function sends the signal specified by the signal parameter to the invoking thread. In single-threaded programs this is equiva-
       lent to:

       kill(getpid(), signal);

       The behavior of the raise() function is equivalent to:

       pthread_kill(pthread_self(), signal);

RETURN VALUES

       Upon successful completion of the raise() function, a value of 0 (zero) is returned. Otherwise, a nonzero value is returned  and  errno	is
       set to indicate the error.

ERRORS

       The  raise() function sets errno to the specified values for the following conditions: The value of the signal parameter is an invalid sig-
       nal number.

RELATED INFORMATION

       Functions: kill(2), sigaction(2)

       Standards: standards(5) delim off

																	  raise(3)