LAM_KSIGNAL(2) LAM LOCAL LIBRARY LAM_KSIGNAL(2)NAMElam_ksignal - Specify a signal handler for a LAM signal.
SYNOPSIS
#include <lam_ksignal.h>
void (*lam_ksignal (int signum, void (*func)())) ();
DESCRIPTIONlam_ksignal() exchanges a current signal handler for a new signal han‐
dler. When a process is signalled, execution control passes immedi‐
ately to the handler function. Control passes back to the previous
location when the handler function returns. Each signal begins with a
default handler when the process is initialized.
LAM signals are completely separate from the signal facilities of the
host operating system. While the syntax and functionality are similar,
signal(3) cannot affect LAM signals and vice versa.
The following is a list of LAM signals as they appear in <lam_ksig‐
nal.h>.
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 about to die
LAM_SIGSHRINK 10 another node has died
By default, LAM_SIGA and LAM_SIGB are ignored. They are reserved for
application programmers LAM_SIGUDIE causes the signalled process to
exit. LAM_SIGARREST causes the signalled process to indefinitely block
and LAM_SIGRELEASE reschedules it.
LAM_SIGTRACE causes the current contents of the trace buffer to be
flushed to the local trace daemon.
LAM_SIGFUSE and LAM_SIGSHRINK are fault tolerant signals. The former
indicates that the local node and all its processes will terminate
imminently. The process receiving LAM_SIGFUSE should take immediate
action to clean up. By default, LAM_SIGFUSE is ignored. LAM_SIGSHRINK
indicates that another node has died or been forcefully terminated.
The default action is to flush the route cache so that subsequent
remote service calls to the dead node will fail with EBADNODE (in <ter‐
ror.h>). If the application decides to trap this signal, the signal
handler should call the old handler (the default which will be returned
by lam_ksignal()) before returning.
The new signal handler must be the address of a function. The special
value LAM_KSIG_IGN ignores the given signal. (A function that does
nothing is called when the signal occurs.) Another special value,
LAM_KSIG_DFL, returns the signal handler to the default function.
When a signal handler is called, the signal number that caused the
invocation is passed as the sole parameter to the handler.
While an signal handler is running, further signals on the same number
are blocked. Interrupts do not form queues. A second signal will
overwrite the first (thus two appear as one) if the first has not yet
been handled, either due to scheduling or signal blocking.
RETURN VALUE
Upon successful completion, the address of the previously installed
signal handler, which may be reinstated later, is returned. Otherwise,
-1 is returned and the global variable errno is set to indicate the
error.
ERRORS
EINVAL The signal number is invalid or privileged.
SEE ALSOMPIL_Signal(2), lam_ksigblock(2)LAM 7.1.2 March, 2006 LAM_KSIGNAL(2)