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():  POSIX.1c, XPG4, XPG4−UNIX

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

PARAMETERS

signalSpecifies 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 equivalent to:

kill(getpid(), signal);

[POSIX]  When the pthread library is present, the behavior 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:

[EINVAL]The value of the signal parameter is an invalid or unsupported signal number. 

RELATED INFORMATION

Functions: kill(2), sigaction(2)

Standards: standards(5)