Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

alarm(3F)

Name

alarm - execute a subroutine after a specified time

Synopsis

integer*4 function alarm (time, sbrtn)
integer*4 time
external sbrtn

Usage

integer*4 time /8/
external sbrtn
nseconds = alarm(time,sbrtn)

Description

This routine arranges for subroutine sbrtn to be called after time seconds. If time is 0, the alarm is turned off, and no routine is called. The returned value is the time remaining on the last alarm.

RESTRICTIONS

A subroutine cannot pass its own name to alarm.

The alarm routine generates signals that could interfere with any I/O. The called routine, sbrtn, must not do any I/O itself.

Calling alarm() from a parallelized or multi-threaded program may have unpredictable results.

Files

libfsu.a

See Also

alarm(2), sleep(3F), signal(3F)