gsignal

Generates a specified software signal, which invokes the action routine established by a signal, ssignal, or sigvec function.

#include  <signal.h>

int gsignal  (int sig [, int sigcode]);

sig: The signal to be generated.
sigcode: An optional signal code. 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, but 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.

Calling this function has one of the following results:

If gsignal specifies a sig argument that is outside the range defined in the <signal.h> header file, then gsignal returns 0 and sets errno to EINVAL.
If signal, ssignal, or sigvec establishes SIG_DFL (default action) for the signal, then gsignal does 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 gsignal returns its argument, sig.
signal, ssignal, or sigvec must be used to establish an action routine for the signal. That function is called and its return value is returned by gsignal.

See also raise, signal, ssignal, and sigvec in this section.

See Chapter 4 for more information.

0	Indicates a sig argument that is outside the range defined in the <signal.h> header file; errno is set to EINVAL.
sig	Indicates that SIG_IGN (ignore signal) has been established as the action for the signal.
x	Indicates that signal, ssignal, or sigvec has established an action function for the signal. That function is called, and its return value is returned by gsignal.