日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
TIMER_CREATE(2) FreeBSD システムコールマニュアル TIMER_CREATE(2)
名称
timer_create -- プロセス毎のタイマを作成する (リアルタイム)
ライブラリ
POSIX リアルタイムライブラリ (librt, -lrt)
書式
#include <time.h>
#include <signal.h>
int
timer_create(clockid_t clockid, struct sigevent *restrict evp,
timer_t *restrict timerid);
解説
timer_create() システムコールは、タイミングベースとして指定されたクロッ
ク、clock_id を使用してプロセス毎に 1 つのタイマを作成します。
timer_create() システムコールは、タイマ要求でタイマを特定するために使用さ
れるタイプ timer_t のタイマ ID、timerid によって参照される位置で返りま
す。このタイマ ID は、タイマが削除されるまで、呼び出しプロセスの中でユ
ニークです。特定のクロック clock_id は、<time.h> で定義されています。ID
が返されるタイマは、timer_create() から返るとき、武装を解除した状態で返り
ます。訳注: arm 武装する、disarm 武装を解除する、の適切な訳が思い付きませ
ん。
evp 引数は、NULL でなければ、sigevent 構造体を指します。この構造体は、タ
イマの期限が切れる場合に生じる、非同期な通知を定義するアプリケーションに
よって割り付けられます。
evp->sigev_notify が SIGEV_SIGNO または SIGEV_THREAD_ID であるなら、
evp->sigev_signo で指定されたシグナルは、呼び出しているプロセス
(SIGEV_SIGNO) または LWP ID が evp->sigev_notify_thread_id
(SIGEV_THREAD_ID) であるスレッドにに送られるます。キューに入れられたシグ
ナルのための情報は、次を含んでいます:
メンバ 値
si_code SI_TIMER
si_value evp->sigev_value に格納される値
si_timerid タイマ ID
si_overrun タイマオーバランカウント
si_errno タイマのオーバランが {DELAYTIMER_MAX} であるなら、<errno.h>
に定義されたエラーコード
evp 引数が NULL であるなら、効果は、あたかも evp 引数が値 SIGEV_SIGNAL が
ある sigev_notify メンバ、デフォルトのシグナル番号 (SIGALRM) がある
sigev_signo、とタイマ ID の値がある sigev_value メンバで sigevent 構造体
を指すかのようです。
この実装は、CLOCK_REALTIME または CLOCK_MONOTONIC の clock_id をサポート
します。
evp->sigev_notify が SIGEV_THREAD であり、sev->sigev_notify_attributes が
NULL でないなら、sev->sigev_notify_attributes によって指された属性が
pthread_attr_setstack() または pthread_attr_setstackaddr() への呼び出しに
よって指定されたスレッドスタックアドレスがあるなら、シグナルが何度も生成
されるなら、結果は、不特定です。
戻り値
呼び出しが成功するなら、timer_create() は、0 を返して、timerid によって参
照される位置をプロセス毎のタイマ呼び出しに渡すことができる timer_t に更新
します。エラーが発生するなら、システムコールは、-1 の値を返し、グローバル
変数 errno にエラーを示す値が設定されます。エラーが発生するなら、timerid
の値は、未定義です。
エラー
timer_create() システムコールは、次の場合に失敗します:
[EAGAIN] 呼び出しプロセスには、この実装によって許されているすべ
てのタイマが既に作成されています。
[EINVAL] 指定されたクロック ID が、サポートされていません。
[EINVAL] 指定された非同期の通知方法が、サポートされていません。
[EFAULT] 任意の引数が、割り付けられたアドレス空間の外を指してい
るか、またはメモリプロテクションフォルトがあります。
関連項目
clock_getres(2), timer_delete(2), timer_getoverrun(2), sigevent(3),
siginfo(3)
規格
timer_create() システムコールは、IEEE Std 1003.1-2004 (``POSIX.1'') に適
合しています。
歴史
POSIX のプロセス毎のタイマのサポートは、FreeBSD 7.0 ではじめて登場しまし
た。
FreeBSD 11.4 July 15, 2016 FreeBSD 11.4