Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ raise(3) — Tru64 UNIX 5.1b

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

kill(2)

sigaction(2)

standards(5)

raise(3)  —  Subroutines

NAME

raise − Send a signal to the executing process or thread

SYNOPSIS

#include <signal.h>
int raise(
        int signal );

LIBRARY

Standard C Library (libc)

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

raise():  XSH5.0

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);

The behavior of the raise() function 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 signal number. 

SEE ALSO

Functions: kill(2), sigaction(2)

Standards: standards(5)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026