ALARM(3) BSD Programmer's Manual ALARM(3) NNAAMMEE aallaarrmm - set signal timer alarm SSYYNNOOPPSSIISS ##iinncclluuddee <<uunniissttdd..hh>> _u___i_n_t aallaarrmm(_u___i_n_t _s_e_c_o_n_d_s); DDEESSCCRRIIPPTTIIOONN TThhiiss iinntteerrffaaccee iiss mmaaddee oobbssoolleettee bbyy sseettiittiimmeerr((22)).. The aallaarrmm() function waits a count of _s_e_c_o_n_d_s before asserting the termi- nating signal SIGALRM. When the signal has successfully been caught, aallaarrmm() returns the amount of time left on the clock. The maximum mumber of _s_e_c_o_n_d_s allowed is 2147483647. If an alarm has been set with aallaarrmm(), another call to aallaarrmm() will su- perceed the prior call. The request aallaarrmm(_0) voids the current alarm. SSEEEE AALLSSOO sigaction(2), setitimer(2), sigpause(2), sigvec(2), signal(3), sleep(3), ualarm(3), usleep(3) HHIISSTTOORRYY An aallaarrmm() function appeared in Version 7 AT&T UNIX. 4th Berkeley Distribution June 4, 1993 1