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.11.1  Talarm                                                     TOS

 Name:         »Talarm« - Reads/sets a process alarm for the current 
               process.

 Opcode:       288 (0x0120)

 Syntax:       int32_t Talarm ( int32_t time );

 Description:  The function Talarm sends a SIGALRM signal to the 
               calling process after time seconds.

               If no signal-handler was installed for this signal with 
               Psignal, then the process will be terminated 
               immediately (i.e. on receiving the signal).

               By setting the value of time = 0, an earlier set alarm 
               can be cancelled. If time is negative, then the 
               function has no effect and only the return value is 
               delivered.

 Return value: The function returns the time (in seconds) remaining 
               before the SIGALRM signal is triggered (if an alarm has 
               been activated), or otherwise the value 0 if no alarm 
               was scheduled before this call.

 Availability: As of the first in MultiTOS integrated MiNT version 
               1.04.

               The call was introduced in the MiNT version 0.8pl8, but 
               prior to the version 1.12 the code contained a bug that 
               affected its functionality.

 Group:        Date and Time

 See Also:     Binding   Tmalarm   Pause   Psignal   Signale