kdoom

Langue: en

Version: 58954 (mandriva - 22/10/07)

Section: 2 (Appels système)

NAME

kdoom - Deliver a signal to a LAM process.

SYNOPSIS

#include <lam_ksignal.h>

int kdoom (int pid, int signum);

DESCRIPTION

The function kdoom() enables one LAM process to deliver an asynchronous signal to another LAM process on the local node, including itself.

The pid argument is the identifier of the process to which the signal will be delivered. Process identifiers refer to other LAM processes, except for the special identifier 0, which refers to the caller.

The signum argument identifies the signal to be delivered. These signals are completely apart from the signals provided by the native operating system. LAM signals, defined in <lam_ksignal.h>, are listed below.

 
 LAM_SIGTRACE   1    unload trace data
 LAM_SIGUDIE    4    terminate
 LAM_SIGARREST  5    suspend execution
 LAM_SIGRELEASE 6    continue execution
 LAM_SIGA       7    user defined
 LAM_SIGB       8    user defined
 LAM_SIGFUSE    9    node is about to die
 LAM_SIGSHRINK  10   another node has died
 

ERRORS

ENOTPROCESS
The process whose process identifier was passed to kdoom() is not a LAM process.
EINVAL
The signal number is invalid.
ENOTATTACHED
The calling process is not a LAM process.

SEE ALSO

lam_ksignal(2), lam_ksigblock(2)