alarm

Section: System Calls (2)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

alarm - シグナル配送のためのアラームクロックを設定する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <unistd.h>

unsigned int alarm(unsigned int seconds);
 

説明

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

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

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

返り値

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

標準規格

POSIX.1-2024.  

歴史

4.3BSD, SVr4, POSIX.1-1988.  

注意

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

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

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

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

関連項目


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


 

Index

名前
ライブラリ
書式
説明
返り値
標準規格
歴史
注意
関連項目

This document was created by man2html, using the manual pages.