====== 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%%''(), [[:documentation:development:opera:pf25:ppgfldr:pgsfldr:spr:01spr068#xref37706|FreeSignal]](), [[:documentation:development:opera:pf25:ppgfldr:pgsfldr:spr:01spr070#xref22129|GetCurrentSignals]](), [[:documentation:development:opera:pf25:ppgfldr:pgsfldr:spr:01spr133#xref12306|WaitSignal]]()

======  ======


----