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

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

SEE ALSO

api_intro

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

PTC MKS Toolkit 10.5 Documentation Build 40.