raise()

send signal to executing program 

Function

SYNOPSIS

#include <signal.h>

int raise (int sig);

DESCRIPTION

The raise() function sends the signal sig to the executing thread. The call raise(sig) is equivalent to pthread_kill(pthread_self(),sig).

PARAMETERS

sig 

Indicates the signal number.

RETURN VALUES

On success, a zero is returned. On error, -1 is returned, and errno is set to one of the following values:

EINVAL 

sig is not a valid signal number.

CONFORMANCE

ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

raise() uses the Win32 function RaiseException() to deliver the signal, where sig is used as the exception code. Any exception filters used with user-written _try/_except blocks must therefore return EXCEPTION_CONTINUE_SEARCH when these exceptions are raised in order for signals to be properly delivered.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

api_intro

Functions:
getpid(), kill(), sigaction(), signal()

MKS Toolkit 9.2 Documentation Build 16.