release/man2/getitimer.2

   1 .\" Copyright 7/93 by Darren Senn <sinster@scintilla.santa-clara.ca.us>
   2 .\" Based on a similar page Copyright 1992 by Rick Faith
   3 .\" May be freely distributed
   4 .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
   5 .\" 2005-04-06 mtk, Matthias Lang <matthias@corelatus.se>
   6 .\"     Noted MAX_SEC_IN_JIFFIES ceiling
   7 .\"*******************************************************************
   8 .\"
   9 .\" This file was generated with po4a. Translate the source file.
  10 .\"
  11 .\"*******************************************************************
  12 .TH GETITIMER 2 2009\-03\-15 Linux "Linux Programmer's Manual"
  13 .SH 名前
  14 getitimer, setitimer \- インターバル・タイマーの値を取得または設定する
  15 .SH 書式
  16 .nf
  17 \fB#include <sys/time.h>\fP
  18 .sp
  19 \fBint getitimer(int \fP\fIwhich\fP\fB, struct itimerval *\fP\fIcurr_value\fP\fB);\fP
  20 .br
  21 \fBint setitimer(int \fP\fIwhich\fP\fB, const struct itimerval *\fP\fInew_value\fP\fB,\fP
  22 \fB              struct itimerval *\fP\fIold_value\fP\fB);\fP
  23 .fi
  24 .SH 説明
  25 システムは 1 個のプロセスにつき 3 個のインターバル・タイマーを提供する。 それぞれのタイマーは別々の時間領域で減少する。
  26 どのタイマーも満了するとプロセスにシグナルが送られ、 タイマーは (設定によっては) 再び開始される。
  27 .TP  1.5i
  28 \fBITIMER_REAL\fP
  29 実時間 (real time) で減少し、満了すると \fBSIGALRM\fP が送られる。
  30 .TP
  31 \fBITIMER_VIRTUAL\fP
  32 プロセスが実行されている間のみ減少し、満了すると \fBSIGVTALRM\fP が送られる。
  33 .TP
  34 \fBITIMER_PROF\fP
  35 プロセスが実行されていて、 かつシステムがそのプロセスのために処理を行なっている間に減少する。 多くの場合、このタイマーは
  36 \fBITIMER_VIRTUAL\fP と組み合わされて、アプリケーションがカーネル空間とユーザー空間で
  37 どれだけの時間を過ごしたかをプロファイルするのに使用される。 満了すると \fBSIGPROF\fP が送られる。
  38 .LP
  39 タイマーの値は以下の構造体によって定義される:
  40 .PD 0
  41 .in +4n
  42 .nf
  43
  44 struct itimerval {
  45     struct timeval it_interval; /* next value */
  46     struct timeval it_value;    /* current value */
  47 };
  48
  49 struct timeval {
  50     long tv_sec;                /* seconds */
  51     long tv_usec;               /* microseconds */
  52 };
  53 .fi
  54 .in
  55 .PD
  56 .LP
  57 \fBgetitimer\fP()  関数は、 \fIwhich\fP で指定されたタイマー (\fBITIMER_REAL\fP, \fBITIMER_VIRTUAL\fP,
  58 \fBITIMER_PROF\fP のどれか) の現在の設定を、 \fIcurr_value\fP で指定された構造体に格納する。 \fIit_value\fP
  59 要素にはタイマーの残り時間が設定される。タイマーがオフの場合は ゼロが設定される。同様に \fIit_interval\fP には初期値が設定される。
  60
  61 \fBsetitimer\fP()  関数は指定されたタイマーに \fInew_value\fP の値を設定する。 \fIold_value\fP が NULL
  62 以外の場合、タイマーの古い値が \fIold_value\fP に格納される。
  63 .LP
  64 タイマーは \fIit_value\fP からゼロへ向けて減っていき、シグナルを生成し、 \fIit_interval\fP に初期化される。
  65 タイマーがゼロに設定された場合 (\fIit_value\fP がゼロか、タイマーが満了した時に \fIit_interval\fP がゼロの場合) は停止する。
  66 .LP
  67 タイマーの期間は \fItv_sec\fP と \fItv_usec\fP の両方により決定される。
  68 .LP
  69 要求した時間がくる前にタイマーが満了することはないが、 逆にある (短い) 時間だけ満了が遅れることはある。
  70 どれだけ遅れるかはシステムの時間分解能とシステムの負荷に依存する (\fBtime\fP(7)  参照; 但し、バグの項も参照のこと)。
  71 タイマーが満了するとシグナルが生成され、タイマーは初期化される。 プロセスがアクティブな時 (\fBITIMER_VIRTUAL\fP
  72 の場合には常にそうである) にタイマーが満了した場合、生成されたシグナルは すぐに配送される。それ以外の場合は、システムの負荷により少しの時間だけ
  73 遅れて配送される。
  74 .SH 返り値
  75 成功した場合、0 が返される。エラーが発生した場合、\-1 が返され、 \fIerrno\fP が適切に設定される。
  76 .SH エラー
  77 .TP
  78 \fBEFAULT\fP
  79 \fInew_value\fP, \fIold_value\fP, \fIcurr_value\fP が有効なポインタではない。
  80 .TP
  81 \fBEINVAL\fP
  82 \fIwhich\fP が \fBITIMER_REAL\fP, \fBITIMER_VIRTUAL\fP, \fBITIMER_PROF\fP のどれでもない。 または
  83 (Linux 2.6.22 以降で)  \fInew_value\fP で指定された構造体の \fItv_usec\fP フィールドの一つが 0 以上 999999
  84 以下の範囲に入らない値である。
  85 .SH 準拠
  86 POSIX.1\-2001, SVr4, 4.4BSD (このコールは 4.2BSD で始めて現われた).  POSIX.1\-2008 では、
  87 \fBgetitimer\fP()  と \fBsetitimer\fP()  は廃止予定とされており、 代わりに POSIX タイマー API
  88 (\fBtimer_gettime\fP(2), \fBtimer_settime\fP(2)  など) を使うことが推奨されている。
  89 .SH 注意
  90 \fBfork\fP(2)  で作成された子プロセスは、 親プロセスのインターバル・タイマーを継承しない。 \fBexecve\fP(2)
  91 の前後ではインターバル・タイマーは保存される。
  92
  93 POSIX.1 では、 \fBsetitimer\fP()  と、 \fBalarm\fP(2), \fBsleep\fP(3), \fBusleep\fP(3)  という 3
  94 つのインタフェースとの相互の影響については規定していない。
  95 .SH バグ
  96 シグナルの生成と配送は別個のものであり、 前述のシグナルのそれぞれについて一つだけがプロセスのために 待機する。 非常に重い負荷の下では、
  97 \fBITIMER_REAL\fP タイマーでは、時間切れにより生成された一つ前のシグナルが配送される前に、 次の時間切れが起こる場合がある。
  98 そのような場合、 2 個めのイベントに対するシグナルは失われてしまう。
  99
 100 バージョン 2.6.16 より前の Linux カーネルでは、 タイマーの値は jiffy で表現される。 要求が jiffy 表現で
 101 (\fIinclude/linux/jiffies.h\fP で定義されている)  \fBMAX_SEC_IN_JIFFIES\fP
 102 を越える値をタイマーに設定しようとするものの場合、 タイマーは暗黙にこの上限値に切り詰められる。 Linux/i386 の場合 (Linux
 103 2.6.13 以降では jiffy は 0.004 秒) の場合、 これはタイマーの上限値がおよそ 99.42 日になることを意味する。 Linux
 104 2.6.16 以降では、カーネルは時間に関する内部表現として 異なる表現を使うようになっており、この上限はなくなった。
 105
 106 .\" 4 Jul 2005: It looks like this bug may remain in 2.4.x.
 107 .\"     http://lkml.org/lkml/2005/7/1/165
 108 (i386 を含む) いくつかのシステムでは、 バージョン 2.6.12 以前の Linux カーネルは ある種の状況では 1 jiffy
 109 早くタイマーが終了してしまうというバグがあった。 このバグはカーネル 2.6.12 で修正された。
 110
 111 .\" Bugzilla report 25 Apr 2006:
 112 .\" http://bugzilla.kernel.org/show_bug.cgi?id=6443
 113 .\" "setitimer() should reject noncanonical arguments"
 114 POSIX.1\-2001 では \fBsetitimer\fP()  は \fItv_usec\fP の値が 0 から 999999
 115 の範囲外である場合には失敗するべきだとしている。 しかし、2.6.21 以前のカーネルの Linux ではエラーにならず、
 116 対応する秒数の分だけそのタイマーの秒の値が暗黙に調整される。 カーネル 2.6.22 以降では、この標準非準拠の動作は修正され、 \fItv_usec\fP
 117 の値が不適切な場合には \fBEINVAL\fP エラーとなる。
 118 .SH 関連項目
 119 \fBgettimeofday\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBtimer_create\fP(2),
 120 \fBtimerfd_create\fP(2), \fBtime\fP(7)
 121 .SH この文書について
 122 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
 123 である。プロジェクトの説明とバグ報告に関する情報は
 124 http://www.kernel.org/doc/man\-pages/ に書かれている。