proc_signal(D3)

NAME
     proc_signal - send a signal to a process

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

   Arguments
     pref      Identifier obtained by a previous call to proc_ref(D3).

     sig       Signal number to be sent.

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(D3) or SLEEP_LOCK_SIG(D3) 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 Values
     If the process still exists, 0 is returned.  Otherwise, -1 is returned to
     indicate that the process no longer exists.

USAGE
     Valid signal numbers are listed in signals(D5).

     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.

   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, and sleep locks may be held
     across calls to this function.

REFERENCES
     proc_ref(D3), proc_unref(D3), signals(D5)