Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (n - r) raise(3)
NAME
raise - Sends a signal to the calling process
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series and J-series native Guardian processes: implicit libraries
H-series and J-series OSS processes: implicit libraries
SYNOPSIS
#include <signal.h>
int raise(
int signal);
PARAMETERS
signal Specifies a signal number.
DESCRIPTION
The raise( ) function sends the signal specified by the signal parameter to the executing program.
Calling this function is equivalent to the following:
error = kill(getpid( ), signal);
Use From the Guardian Environment
If called in a code module compiled in the Guardian environment and called from a TNS or
accelerated Guardian process (main( ) was compiled with systype guardian), the signal-
catching function found in the Guardian registry is entered. The default signal-catching function
is identified by the SIG_DFL value for signal action.
If called in a code module compiled in the Guardian environment and called from a G-series TNS
or accelerated OSS process (main( ) was compiled with systype oss), the signal-catching
function found in the Guardian registry is entered. The default signal-catching function is
identified by the SIG_DFL value for signal action.
If called in a code module compiled in the OSS environment and called from a TNS or
accelerated Guardian process (main( ) was compiled with systype guardian), the value -1 is
returned and errno is set to [ENOTOSS].
RETURN VALUES
Upon successful completion, the raise( ) function returns the value 0 (zero). Otherwise, the value
-1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the raise( ) function sets errno to the corresponding
value:
[EINVAL] The value of the signal parameter is an invalid or unsupported signal number.
[ENOTOSS] The calling process is not an OSS process or a native Guardian process. Refer to
Use From the Guardian Environment for permitted uses.
RELATED INFORMATION
Commands: kill(1).
Functions: kill(2), sigaction(2), signal(3).
Files: signal(4).
527187-017 Hewlett-Packard Company 5−131