1*61111Sbostic.\" Copyright (c) 1980, 1991, 1993 2*61111Sbostic.\" The Regents of the University of California. All rights reserved. 320104Smckusick.\" 448352Scael.\" %sccs.include.redist.man% 520104Smckusick.\" 6*61111Sbostic.\" @(#)alarm.3 8.1 (Berkeley) 06/04/93 748352Scael.\" 848352Scael.Dd 948352Scael.Dt ALARM 3 1048352Scael.Os BSD 4 1148352Scael.Sh NAME 1248352Scael.Nm alarm 1348352Scael.Nd set signal timer alarm 1448352Scael.Sh SYNOPSIS 1548352Scael.Fd #include <unistd.h> 1648352Scael.Ft u_int 1748352Scael.Fn alarm "u_int seconds" 1848352Scael.Sh DESCRIPTION 1948352Scael.Bf -symbolic 2028808SkjdThis interface is made obsolete by setitimer(2). 2148352Scael.Ef 2248352Scael.Pp 2348352ScaelThe 2448352Scael.Fn alarm 2548352Scaelfunction 2648352Scaelwaits a count of 2748352Scael.Ar seconds 2848352Scaelbefore asserting the terminating signal 2948352Scael.Dv SIGALRM . 3048352ScaelWhen the signal has successfully been caught, 3148352Scael.Fn alarm 3248352Scaelreturns the amount of time left on the clock. 3348352ScaelThe maximum mumber of 3448352Scael.Ar seconds 3548352Scaelallowed 3648352Scaelis 2147483647. 3748352Scael.Pp 3848352ScaelIf an alarm has been set with 3948352Scael.Fn alarm , 4048352Scaelanother call to 4148352Scael.Fn alarm 4248352Scaelwill superceed the prior call. 4348352ScaelThe request 4448352Scael.Fn alarm "0" 4548352Scaelvoids the current 4648352Scaelalarm. 4748352Scael.Sh SEE ALSO 4848352Scael.Xr sigaction 2 , 4948352Scael.Xr setitimer 2 , 5048352Scael.Xr sigpause 2 , 5148352Scael.Xr sigvec 2 , 5248352Scael.Xr signal 3 , 5348352Scael.Xr sleep 3 , 5448352Scael.Xr ualarm 3 , 5548352Scael.Xr usleep 3 5648352Scael.Sh HISTORY 5748352ScaelAn 5848352Scael.Fn alarm 5948352Scaelfunction appeared in 6048352Scael.At v7 . 61