alarm n
Sends a
SIGALRM
signal to the executing Perl program after
n
seconds. On some older systems, alarms go off "at the top of the second," so, for instance, an
alarm 1
may go off anywhere between 0 to 1 seconds from now, depending on when in the current second it is. An
alarm 2
may go off anywhere from 1 to 2 seconds from now. And so on.
Each call disables the previous timer, and an argument of
0
may be supplied to cancel the previous timer without starting a new one. The return value is the number of seconds remaining on the previous timer.