SendSignal

Sends a signal to another task.

Synopsis

Err SendSignal( Item task, uint32 sigMask )

Description

This procedure sends one or more signals to the specified task. See the description of AllocSignal() for more information about signals.

It is an error for a user task to send a system signal or a signal that has not been allocated by the receiving task.

Arguments

task
The item number of the task to send signals to. If this parameter is 0, then the signals are sent to the calling task. This is sometimes useful to set initial conditions.
sigMask
The signals to send.

Return Value

The procedure returns 0 if successful or an error code (a negative value) if an error occurs. Possible error codes include:

BADPRIV
The task attempted to send a system signal.
ILLEGALSIGNAL
The task attempted to send a signal to a task that was not allocated by that task, or bit 32 in the sigMask argument (which is reserved by the system software) was set.

Implementation

SWI implemented in kernel folio V20.

Associated Files

task.h
ANSI C Prototype

See Also

AllocSignal(), FreeSignal(), GetCurrentSignals(), WaitSignal()