名称

alarm — シグナルタイマアラームを設定する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < unistd.h>

unsigned int
alarm( unsigned int seconds);

解説

alarm() 関数は、指定された seconds 秒数後に、呼び出しているプロセスにシグナル SIGALRM を配達するタイマを設定します。アラームが既に alarm() で設定されているが、配信されていないなら、 alarm() への別の呼び出しは、前の呼び出しに優先します。 alarm( 0) の要求は、現在のアラームを無効にし、シグナル SIGALRM は、配信されません。

setitimer(2) の制限のために、許可された seconds 秒数の最大数は、100000000 です。

戻り値

alarm() の返り値は、 alarm() への以前の呼び出しからタイマに残された時間の量です。アラームが現在設定されていないなら、返り値は、0 です。

関連項目

setitimer(2), sigaction(2), sigsuspend(2), signal(3), sleep(3), ualarm(3), usleep(3)

歴史

alarm() 関数は、 Version 7 AT&T UNIX で登場しました。