raise(3) [centos man page]

RAISE(3)						     Linux Programmer's Manual							  RAISE(3)

NAME

       raise - send a signal to the caller

SYNOPSIS

       #include <signal.h>

       int raise(int sig);

DESCRIPTION

       The raise() function sends a signal to the calling process or thread.  In a single-threaded program it is equivalent to

	   kill(getpid(), sig);

       In a multithreaded program it is equivalent to

	   pthread_kill(pthread_self(), sig);

       If the signal causes a handler to be called, raise() will return only after the signal handler has returned.

RETURN VALUE

       raise() returns 0 on success, and nonzero for failure.

CONFORMING TO

       C89, C99, POSIX.1-2001.

NOTES

       Since  version  2.3.3, glibc implements raise() by calling tgkill(2), if the kernel supports that system call.  Older glibc versions imple-
       mented raise() using kill(2).

SEE ALSO

       getpid(2), kill(2), sigaction(2), signal(2), pthread_kill(3), signal(7)

COLOPHON

       This page is part of release 3.53 of the Linux man-pages project.  A description of the project, and information about reporting bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

GNU
								    2012-04-20								  RAISE(3)

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)