OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man2 / getitimer.2
index 3088952..7072a90 100644 (file)
@@ -1,15 +1,31 @@
 .\" Copyright 7/93 by Darren Senn <sinster@scintilla.santa-clara.ca.us>
 .\" Based on a similar page Copyright 1992 by Rick Faith
+.\"
+.\" %%%LICENSE_START(FREELY_REDISTRIBUTABLE)
 .\" May be freely distributed
+.\" %%%LICENSE_END
+.\"
 .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
 .\" 2005-04-06 mtk, Matthias Lang <matthias@corelatus.se>
 .\"    Noted MAX_SEC_IN_JIFFIES ceiling
+.\"
 .\"*******************************************************************
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH GETITIMER 2 2009\-03\-15 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
+.\"         all rights reserved.
+.\" Translated 1997-02-22, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
+.\" Updated 2005-04-23, Kentaro Shirakata <argrath@ub32.org>
+.\" Updated 2005-09-11, Kentaro Shirakata <argrath@ub32.org>
+.\" Updated 2006-07-23, Kentaro Shirakata <argrath@ub32.org>
+.\" Updated 2007-10-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2009-04-13, Akihiro MOTOKI, LDP v3.20
+.\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH GETITIMER 2 2012\-10\-01 Linux "Linux Programmer's Manual"
 .SH 名前
 getitimer, setitimer \- インターバル・タイマーの値を取得または設定する
 .SH 書式
@@ -47,8 +63,8 @@ struct itimerval {
 };
 
 struct timeval {
-    long tv_sec;                /* seconds */
-    long tv_usec;               /* microseconds */
+    time_t      tv_sec;         /* seconds */
+    suseconds_t tv_usec;        /* microseconds */
 };
 .fi
 .in
@@ -92,6 +108,18 @@ POSIX.1\-2001, SVr4, 4.4BSD (このコールは 4.2BSD で始めて現われた)
 
 POSIX.1 では、 \fBsetitimer\fP()  と、 \fBalarm\fP(2), \fBsleep\fP(3), \fBusleep\fP(3)  という 3
 つのインタフェースとの相互の影響については規定していない。
+
+標準では、次の呼び出しの意味については規定されていない。
+
+    setitimer(which, NULL, &old_value);
+
+(Solaris, BSD 系やおそらく他のシステムもそうだが) 多くのシステムでは、
+この呼び出しは以下と等価である。
+
+    getitimer(which, &old_value);
+
+Linux では、この呼び出しは \fInew_value\fP フィールドが 0 の呼び出しと等価なものと扱われる。 つまり、タイマーが無効になる。
+\fILinux のこの間違った機能を使用しないこと\fP。移植性もなく、不必要な機能である。
 .SH バグ
 シグナルの生成と配送は別個のものであり、 前述のシグナルのそれぞれについて一つだけがプロセスのために 待機する。 非常に重い負荷の下では、
 \fBITIMER_REAL\fP タイマーでは、時間切れにより生成された一つ前のシグナルが配送される前に、 次の時間切れが起こる場合がある。
@@ -119,6 +147,6 @@ POSIX.1\-2001 では \fBsetitimer\fP()  は \fItv_usec\fP の値が 0 から 999
 \fBgettimeofday\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBtimer_create\fP(2),
 \fBtimerfd_create\fP(2), \fBtime\fP(7)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。