 |
Index for Section 3 |
|
 |
Alphabetical listing for R |
|
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(): POSIX.1c, XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
signal 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 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)