遵循规范

POSIX.1-2001，POSIX.1-2008，SVr4、4.3BSD。

名称

alarm-设置用于传递信号的闹钟

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。

另外参见

gettimeofday(2)，pause(2)，select(2)，setitimer(2)，sigaction(2)，signal(2)，timer_create(2)，timerfd_create(2)，sleep(3)，time(7)

备注

alarm()和setitimer(2)共享同一计时器；调用一个将干扰另一个的使用。

由alarm()创建的警报将在execve(2)中保留，并且不会被通过fork(2)创建的子代继承。

sleep(3)可以使用SIGALRM来实现；混合对alarm()和sleep(3)的调用是一个坏主意。

调度延迟可能像以往一样导致进程执行延迟任意时间。

Linux程序员手册 第2部分
更新日期： 2017-05-03

返回值

alarm()返回剩余的秒数，直到要传递任何先前计划的警报为止；如果没有先前计划的警报，则返回零。

语法

#include <unistd.h>

unsigned int alarm(unsigned int seconds);

说明

alarm()安排在几秒钟内将SIGALRM信号传递到调用过程。

如果秒为零，则取消任何待处理的警报。

无论如何，任何先前设置的alarm()都会被取消。