# 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()`

#