.TH ALARM 2 .UC 4 .SH NAME alarm \- alarm .SH SYNOPSIS .nf .B #include .B int alarm(long seconds); .fi .SH DESCRIPTION .B alarm() sets a .B SIGALARM to go off in .I seconds seconds, if seconds is non-zero. The time until the pending alarm signal, in seconds, is returned. .SH FILES linux/kernel/sched.c, /usr/include/linux/sys.h, /usr/include/unistd.h .SH SEE ALSO pause(2), signal(2), sleep(3)