man alarm (2): シグナル配送のためのアラームクロックを設定する

書式

#include <unistd.h>

unsigned int alarm(unsigned int seconds);

alarm() は SIGALRM シグナルを seconds 秒後に呼び出したプロセスに配送するように手配する。

seconds がゼロならば、処理待ち (pending) のアラームはすべてキャンセルされる。

今までに設定されていた alarm() は中断される。

alarm() は以前に予定されていたアラームの配送までの残り時間を返す。以前にアラームが予定されていなければゼロを返す。

SVr4, POSIX.1-2001, 4.3BSD.

alarm() と setitimer(2) は同じタイマーを共有している; 片方を呼び出すことはもう一方の使用に影響を与える。

alarm() で作成されたアラームは execve(2) の前後で保持され、 fork(2) で作成された子プロセスには継承されない。

sleep(3) は SIGALRM を利用して実装されているかもしれない。 alarm() と sleep(3) を混ぜて使用してはならない。

スケジューリング(scheduling)の遅延により、プロセスの実行に不定量の遅延が起きる可能性がある。

この man ページは Linux man-pages プロジェクトのリリース 3.65 の一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。