proc_signal(D3DK) —

NAME

proc_signal − send a signal to a process .IX \f4proc_signal\fP(D3DK)

SYNOPSIS

#include <sys/signal.h>
int proc_signal(void ∗pref, int sig);

ARGUMENTS

prefIdentifier obtained by a previous call to proc_ref(D3DK).

sigSignal number to be sent. Valid signal numbers are listed in signals(D5DK).

DESCRIPTION

The proc_signal function can be used to post a signal to the process represented by pref. This will interrupt any process blocked in SV_WAIT_SIG(D3DK) or SLEEP_LOCK_SIG(D3DK) at the time the signal is posted, causing those functions to return prematurely in most cases. If the process has exited then this function has no effect.

RETURN VALUE

If the process still exists, 0 is returned. Otherwise, −1 is returned to indicate that the process no longer exists.

LEVEL

Base or Interrupt

NOTES

STREAMS drivers and modules should not use this mechanism for signaling processes. Instead, they can send M_SIG or M_PCSIG STREAMS messages to the stream head. proc_signal must not be used to send SIGTSTP to a process. Does not sleep. Driver defined basic locks, read/write locks, and sleep locks may be held across calls to this function.

Museum