[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    RAISE(3) manual page Table of Contents

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.

Attributes

Multithreading (see pthreads(7) )

The raise() function is thread-safe.

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 implemented 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.78 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://www.kernel.org/doc/man-pages/.

Table of Contents