Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.12.38  Psigreturn                                                TOS

 Name:         »Psigreturn« - Prepare exit from a signal-handler.

 Opcode:       282

 Syntax:       void Psigreturn ( void );

 Description:  The function Psigreturn prepares for the exit from a 
               signal-handler. As this happens automatically when the 
               handler returns, calling Psigreturn is only necessary 
               if the handler executes a non-local jump (perhaps with 
               longjump) rather than using RTS.

               The call has no effect when no signal is being 
               processed at the time.

               In MagiC, the thread of the active signal-handler will 
               become the main thread of the process and then be 
               removed. All other signal processes will be removed as 
               well (nesting). The locked semaphores of the main 
               thread will be released, and the supervisor stack will 
               be reset to the value at process start.

 Return value: The function has no direct result under MiNT/MultiTOS; 
               in MagiC the value EACCDN will be returned if the 
               caller is not a signal-handling routine, or the value 
               E_OK otherwise.

 Availability: As of the first in MultiTOS integrated MiNT version 
               1.04, and MagiC as of Version 4.50.

 Group:        Process functions

 See Also:     Binding   Psignal   Signals   Signal-handler in MagiC