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.33  Psigblock                                                 TOS

 Name:         »Psigblock« - Alter signal mask.

 Opcode:       278

 Syntax:       int32_t Psigblock ( int32_t mask );

 Description:  The function Psigblock blocks selected signals from 
               delivery. It adds the signals specified in mask to the 
               set of currently blocking signals. For this, each bit 
               of the parameter mask represents one signal. If bit n 
               in mask is set, it means that the signal with the 
               number n will be blocked.

               One should note that some signals (e.g. SIGKILL) can 
               not be blocked. The kernel will delete these signals 
               from mask before any change of the signal set is 
               performed.

               Furthermore it should be pointed out that blocked 
               signals also remain blocked via Pfork/Pvfork calls. 
               After a Pexec call the child always starts with an 
               empty set of signals to be blocked, irrespective of 
               which signals were blocked by its parent.

               Warning: This function is optional, hence a call may be 
               answered with EINVFN.

 Return value: The function returns the set of blocked signals that 
               were valid before the call. So with a Psigsetmask call 
               the old set can be recovered again.

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

 Group:        Process functions

 See also:     Binding   Psigsetmask   Signals