proc_signal(D3) 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.
Copyright 1994 Novell, Inc. Page 1
proc_signal(D3) proc_signal(D3)
REFERENCES
proc_ref(D3), proc_unref(D3), proc_valid(D3), signals(D5)
NOTICES
Portability
All processors
Applicability
ddi: 3, 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2