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.2 Documentation Build 28.