NAME
raise — send a
signal to the executing process
SYNOPSIS
#include
<signal.h>
int raise(int sig);
DESCRIPTION
[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of IEEE Std 1003.1-2001 (“POSIX.1”) defers to the ISO C standard.
The raise () function shall send
the signal sig to the
executing [CX] thread or process. If a signal handler is
called, the raise () function shall not return until
after the signal handler does.
[THR]
If the implementation supports the Threads option, the effect of the
raise () function shall be equivalent to
calling:
pthread_kill(pthread_self(), sig);
[CX] Otherwise, the effect of the
raise () function shall be equivalent to
calling:
kill(getpid(), sig);
RETURN VALUE
Upon successful completion, 0 shall be returned. Otherwise, a non-zero value shall be returned [CX] and errno shall be set to indicate the error.
ERRORS
The raise () function shall fail if:
- [EINVAL]
- [CX] The value of the sig argument is an invalid signal number.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
The term "thread" is an extension to the ISO C standard.
FUTURE DIRECTIONS
None.
SEE ALSO
kill(3) , sigaction(3) , the Base Definitions volume of IEEE Std 1003.1-2001 (“POSIX.1”), <signal.h>, <sys/types.h>
CHANGE HISTORY
First released in Issue 4. Derived from the ANSI C standard.
Issue 5
The DESCRIPTION is updated for alignment with the POSIX Threads Extension.
Issue 6
Extensions beyond the ISO C standard are marked.
The following new requirements on POSIX implementations derive from alignment with the Single UNIX Specification:
- In the RETURN VALUE section, the requirement to set errno on error is added.
- The [EINVAL] error condition is added.
End of informative text. footer end