raise

Generates a specified software signal. Generating a signal causes the action routine established by the signal, ssignal, or sigvec function to be invoked.

Format

#include  <signal.h>

int raise  (int sig); 
           (ANSI C)

int raise  (int sig[, int sigcode]); (DEC C Extension)

Arguments

sig

The signal to be generated.

sigcode

An optional signal code, available only when not compiling in strict ANSI C mode. For example, signal SIGFPE-the arithmetic trap signal-has 10 different codes, each representing a different type of arithmetic trap.

The signal codes can be represented by mnemonics or numbers. The arithmetic trap codes are represented by the numbers 1 to 10; the SIGILL codes are represented by the numbers 0 to 2. The code values are defined in the <signal.h> header file. See Tables 4-4 and 4-5 for a list of signal mnemonics, codes, and corresponding OpenVMS exceptions.

Description

• If raise specifies a sig argument that is outside the range defined in the <signal.h> header file, then the raise function returns 0, and the errno variable is set to EINVAL.

• If signal, ssignal, or sigvec establishes SIG_DFL (default action) for the signal, then the functions do not return. The image is exited with the OpenVMS error code corresponding to the signal.

• If signal, ssignal, or sigvec establishes SIG_IGN (ignore signal) as the action for the signal, then raise returns its argument, sig.

• signal, ssignal, or sigvec must establish an action function for the signal. That function is called and its return value is returned by raise.

See Chapter 4 for more information on signal processing. See also gsignal, signal, ssignal, and sigvec in this section.

Return Values

0	If successful.
nonzero	If unsuccessful.

---

Previous Page | Next Page | Table of Contents | Index