.\" Added notes on nonstandard behavior: Linux allows 'buf' to
.\" be NULL, but POSIX.1 doesn't specify this and it's nonportable.
.\"
-.\" Japanese Version Copyright (c) 1996 Satoshi Nozawa
-.\" all rights reserved.
-.\" Translated 1996-06-25, Satoshi I. Nozawa <snozawa@env.sci.ibaraki.ac.jp>
-.\" Modified 1997-12-14, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated 2001-02-16, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2001-04-10, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2001-05-21, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2002-10-21, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2005-02-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2005-04-20, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2008-02-12, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.77
+.\"*******************************************************************
.\"
-.\" WORD: clock ticks クロック数
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH TIMES 2 2008-06-25 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH TIMES 2 2012\-04\-16 Linux "Linux Programmer's Manual"
.SH 名前
-times - プロセス時間を取得する
+times \- プロセス時間を取得する
.SH 書式
-.B #include <sys/times.h>
+\fB#include <sys/times.h>\fP
.sp
-.BI "clock_t times(struct tms *" buf );
+\fBclock_t times(struct tms *\fP\fIbuf\fP\fB);\fP
.SH 説明
-.\"O .BR times ()
-.\"O stores the current process times in the
-.\"O .B "struct tms"
-.\"O that
-.\"O .I buf
-.\"O points to.
-.BR times ()
-は現在のプロセス時間を
-.I buf
-が指している
-.B "struct tms"
-に格納する。
-.\"O The
-.\"O .I struct tms
-.\"O is as defined in
-.\"O .IR <sys/times.h> :
-.I struct tms
-は
-.I <sys/times.h>
-で以下のように定義されている:
+\fBtimes\fP() は現在のプロセス時間を \fIbuf\fP が指している \fBstruct tms\fP に格納する。 \fIstruct tms\fP は
+\fI<sys/times.h>\fP で以下のように定義されている:
.sp
.in +4n
.nf
.fi
.in
.LP
-.\"O The
-.\"O .I tms_utime
-.\"O field contains the CPU time spent executing instructions
-.\"O of the calling process.
-.I tms_utime
-フィールドは、呼び出したプロセスが命令を実行するのに消費した
-CPU 時間である。
-.\"O The
-.\"O .I tms_stime
-.\"O field contains the CPU time spent in the system while
-.\"O executing tasks on behalf of the calling process.
-.I tms_stime
-フィールドは、呼び出したプロセスのために実行されたタスクで、
-システムが消費した CPU 時間である。
-.\"O The
-.\"O .I tms_cutime
-.\"O field contains the sum of the
-.\"O .I tms_utime
-.\"O and
-.\"O .I tms_cutime
-.\"O values for all waited-for terminated children.
-.I tms_cutime
-フィールドは、
-終了を待っている全ての子プロセスの
-.I tms_utime
-と
-.I tms_cutime
-の合計である。
-.\"O The
-.\"O .I tms_cstime
-.\"O field contains the sum of the
-.\"O .I tms_stime
-.\"O and
-.\"O .I tms_cstime
-.\"O values for all waited-for terminated children.
-.I tms_cstime
-フィールドは、
-終了を待っている全ての子プロセスの
-.I tms_stime
-と
-.I tms_cstime
-の合計である。
+\fItms_utime\fP フィールドは、呼び出したプロセスが命令を実行するのに消費した CPU 時間である。 \fItms_stime\fP
+フィールドは、呼び出したプロセスのために実行されたタスクで、 システムが消費した CPU 時間である。 \fItms_cutime\fP フィールドは、
+終了を待っている全ての子プロセスの \fItms_utime\fP と \fItms_cutime\fP の合計である。 \fItms_cstime\fP フィールドは、
+終了を待っている全ての子プロセスの \fItms_stime\fP と \fItms_cstime\fP の合計である。
.LP
-.\"O Times for terminated children (and their descendants)
-.\"O are added in at the moment
-.\"O .BR wait (2)
-.\"O or
-.\"O .BR waitpid (2)
-.\"O returns their process ID.
-.\"O In particular, times of grandchildren
-.\"O that the children did not wait for are never seen.
-終了する子(及びその子孫)プロセスの時間は
-.BR wait (2)
-や
-.BR waitpid (2)
-がプロセス ID を返した瞬間に加算される。
-つまり、子がまだ終了を待っていない状態では
-孫プロセスの時間は決して現れない。
+終了する子(及びその子孫)プロセスの時間は \fBwait\fP(2) や \fBwaitpid\fP(2) がプロセス ID を返した瞬間に加算される。
+つまり、子がまだ終了を待っていない状態では 孫プロセスの時間は決して現れない。
.LP
-.\"O All times reported are in clock ticks.
全ての時間はクロック数で返される。
-.\"O .SH "RETURN VALUE"
.SH 返り値
-.\"O The function
-.\"O .BR times ()
-.\"O returns the number of clock ticks that have elapsed since
-.\"O an arbitrary point in the past.
-.\"O The return value may overflow the possible range of type
-.\"O .IR clock_t .
-.\"O On error, \fI(clock_t)\ \-1\fP is returned, and
-.\"O .I errno
-.\"O is set appropriately.
-.BR times ()
-は過去のある時点から経過したクロック数 (clock tick) を返す。
-この返り値は
-.I clock_t
-型が取り得る範囲からオーバーフローするかもしれない。
-エラーの場合、\fI(clock_t)\ \-1\fP が返され、
-.I errno
-が適切に設定される。
-.\" The only possible error is EFAULT.
-.\"O .SH "CONFORMING TO"
+\fBtimes\fP() は過去のある時点から経過したクロック数 (clock tick) を返す。 この返り値は \fIclock_t\fP
+型が取り得る範囲からオーバーフローするかもしれない。 エラーの場合、\fI(clock_t)\ \-1\fP が返され、 \fIerrno\fP が適切に設定される。
+.SH エラー
+.TP
+\fBEFAULT\fP
+\fItms\fP がプロセスのアドレス空間の外を指している。
.SH 準拠
-SVr4, 4.3BSD, POSIX.1-2001.
-.\"O .SH NOTES
+SVr4, 4.3BSD, POSIX.1\-2001.
.SH 注意
-.\"O The number of clock ticks per second can be obtained using:
-.\"O .in +4n
-.\"O
-.\"O sysconf(_SC_CLK_TCK);
-.\"O .in
-一秒あたりのクロック数は
+一秒あたりのクロック数は以下で得ることができる。
.in +4n
sysconf(_SC_CLK_TCK);
-
.in
-を使って得ることが出来る。
.PP
-.\"O In POSIX.1-1996 the symbol \fBCLK_TCK\fP (defined in
-.\"O .IR <time.h> )
-.\"O is mentioned as obsolescent.
-.\"O It is obsolete now.
-POSIX.1-1996 では、\fBCLK_TCK\fP シンボル
-.RI ( <time.h>
-で定義されている) は古いものであると記述されている。
-今ではこれは古いものである。
+POSIX.1\-1996 では、\fBCLK_TCK\fP シンボル (\fI<time.h>\fP で定義されている)
+は古いものであると記述されている。 今ではこれは古いものである。
.PP
-.\"O In Linux kernel versions before 2.6.9,
-.\"O if the disposition of
-.\"O .B SIGCHLD
-.\"O is set to
-.\"O .B SIG_IGN
-.\"O then the times of terminated children
-.\"O are automatically included in the
-.\"O .I tms_cstime
-.\"O and
-.\"O .I tms_cutime
-.\"O fields, although POSIX.1-2001 says that this should only happen
-.\"O if the calling process
-.\"O .BR wait (2)s
-.\"O on its children.
-.\"O +This nonconformance is rectified in Linux 2.6.9 and later.
-Linux 2.6.9 より前のバージョンでは、
-.B SIGCHLD
-を
-.B SIG_IGN
-に設定すると
-終了した子プロセスの回数は
-自動的に
-.I tms_cstime
-と
-.I tms_cutime
-フィールドに含まれる。
-しかし、POSIX.1-2001 では、この動作は呼び出し元が
-.BR wait (2)
-関数群で子プロセスを待った場合にのみ起きるべきだとしている。
-標準とは異なるこの動作は Linux 2.6.9 以降で修正されている。
-.\"O .\" See the description of times() in XSH, which says:
-.\"O .\" The times of a terminated child process are included... when wait()
-.\"O .\" or waitpid() returns the process ID of this terminated child.
.\" See the description of times() in XSH, which says:
.\" The times of a terminated child process are included... when wait()
.\" or waitpid() returns the process ID of this terminated child.
+Linux 2.6.9 より前のバージョンでは、 \fBSIGCHLD\fP を \fBSIG_IGN\fP に設定すると 終了した子プロセスの回数は 自動的に
+\fItms_cstime\fP と \fItms_cutime\fP フィールドに含まれる。 しかし、POSIX.1\-2001 では、この動作は呼び出し元が
+\fBwait\fP(2) 関数群で子プロセスを待った場合にのみ起きるべきだとしている。 標準とは異なるこの動作は Linux 2.6.9
+以降で修正されている。
-.\"O On Linux, the
-.\"O .I buf
-.\"O argument can be specified as NULL, with the result that
-.\"O .BR times ()
-.\"O just returns a function result.
-Linux では、
-.I buf
-引数に NULL を指定することができ、その場合は
-.BR times ()
-は単に関数の結果を返す。
-.\"O However, POSIX does not specify this behavior, and most
-.\"O other UNIX implementations require a non-NULL value for
-.\"O .IR buf .
-しかし、POSIX はこの振る舞いは規定されておらず、
-その他のほとんどの UNIX 実装は
-.I buf
-の値として非 NULL の値を要求する。
+Linux では、 \fIbuf\fP 引数に NULL を指定することができ、その場合は \fBtimes\fP() は単に関数の結果を返す。
+しかし、POSIX はこの振る舞いは規定されておらず、 その他のほとんどの UNIX 実装は \fIbuf\fP の値として非 NULL の値を要求する。
.LP
-.\"O Note that
-.\"O .BR clock (3)
-.\"O also returns a value of type
-.\"O .IR clock_t ,
-.\"O but this value is measured in units of
-.\"O .BR CLOCKS_PER_SEC ,
-.\"O not the clock ticks used by
-.\"O .BR times ().
-.BR clock (3)
-も
-.I clock_t
-型の値を返すが、この値は
-.BR times ()
-で使用されるクロック tick 数ではなく、
-.B CLOCKS_PER_SEC
-が単位である点に注意すること。
+\fBclock\fP(3) も \fIclock_t\fP 型の値を返すが、この値は \fBtimes\fP() で使用されるクロック tick 数ではなく、
+\fBCLOCKS_PER_SEC\fP が単位である点に注意すること。
-.\"O On Linux, the "arbitrary point in the past" from which the return value of
-.\"O .BR times ()
-.\"O is measured has varied across kernel versions.
-.\"O On Linux 2.4 and earlier this point is the moment the system was booted.
-.\"O Since Linux 2.6, this point is \fI(2^32/HZ) \- 300\fP
-.\"O (i.e., about 429 million) seconds before system boot time.
-.\"O This variability across kernel versions (and across UNIX implementations),
-.\"O combined with the fact that the returned value may overflow the range of
-.\"O .IR clock_t ,
-.\"O means that a portable application would be wise to avoid using this value.
-.\"O To measure changes in elapsed time, use
-.\"O .BR gettimeofday (2)
-.\"O instead.
-Linux では、
-.BR times ()
-の返り値を計算する起点となる「過去の任意の時点」は、カーネルのバージョン
-により異なる。
-Linux 2.4 以前では、この時点はシステムが起動した瞬間である。
-Linux 2.6 以降では、この時点はシステム起動時刻の \fI(2^32/HZ) \- 300\fP
-(および 4億2900万) 秒前である。
-このようにカーネルバージョン (や UNIX の実装) により異なることと、
-返り値が
-.I clock_t
-の範囲をオーバーフローする可能性があるという事実を考慮すると、
-移植性が必要なアプリケーションではこの値を使うのは避けるのが賢明であろう。
-経過時間を測りたい場合には、代わりに
-.BR gettimeofday (2)
-を使用すること。
.\" .PP
-.\"O .\" On older systems the number of clock ticks per second is given
-.\"O .\" by the variable HZ.
-.\" 古いシステムでは一秒あたりのクロック数は HZ 変数で与えられる。
-.\"O .SS "Historical"
+.\" On older systems the number of clock ticks per second is given
+.\" by the variable HZ.
+Linux では、 \fBtimes\fP() の返り値を計算する起点となる「過去の任意の時点」は、カーネルのバージョン により異なる。 Linux 2.4
+以前では、この時点はシステムが起動した瞬間である。 Linux 2.6 以降では、この時点はシステム起動時刻の \fI(2^32/HZ) \- 300\fP
+(および 4億2900万) 秒前である。 このようにカーネルバージョン (や UNIX の実装) により異なることと、 返り値が \fIclock_t\fP
+の範囲をオーバーフローする可能性があるという事実を考慮すると、 移植性が必要なアプリケーションではこの値を使うのは避けるのが賢明であろう。
+経過時間を測りたい場合には、代わりに \fBgettimeofday\fP(2) を使用すること。
.SS 歴史
-.\"O SVr1-3 returns
-.\"O .I long
-.\"O and the struct members are of type
-.\"O .I time_t
-.\"O although they store clock ticks, not seconds since the Epoch.
-.\"O V7 used
-.\"O .I long
-.\"O for the struct members, because it had no type
-.\"O .I time_t
-.\"O yet.
-SVr1-3 では
-.I long
-を返し、構造体のメンバに
-.I time_t
-型を使っていたが、紀元からの秒数ではなくクロック数を格納していた。
-V7 では構造体のメンバに
-.I long
-型を使っていた。まだ
-.I time_t
-型がなかったからである。
-.\"O .SH BUGS
+SVr1\-3 では \fIlong\fP を返し、構造体のメンバに \fItime_t\fP 型を使っていたが、紀元からの秒数ではなくクロック数を格納していた。
+V7 では構造体のメンバに \fIlong\fP 型を使っていた。まだ \fItime_t\fP 型がなかったからである。
.SH バグ
-.\"O A limitation of the Linux system call conventions on some architectures
-.\"O (notably i386) means that on Linux 2.6 there is a small time window
-.\"O (41 seconds) soon after boot when
-.\"O .BR times ()
-.\"O can return \-1, falsely indicating that an error occurred.
-.\"O The same problem can occur when the return value wraps passed
-.\"O the maximum value that can be stored in
-.\"O .BR clockid_t .
-いくつかのアーキテクチャ (特に i386) における Linux のシステムコールの慣習の
-制限により、Linux 2.6 では起動直後は (41秒と) タイムウィンドウが小さく、
-.BR times ()
-がエラーが起こったことを示す \-1 を間違って返すことがある。
-返り値が
-.I clockid_t
-が格納可能な最大値を超過した際にも同じ問題が起こり得る。
.\" The problem is that a syscall return of -4095 to -1
.\" is interpreted by glibc as an error, and the wrapper converts
.\" the return value to -1.
.\" http://marc.info/?l=linux-kernel&m=119447727031225&w=2
.\" "compat_sys_times() bogus until jiffies >= 0"
.\" November 2007
-.\"O .SH "SEE ALSO"
+いくつかのアーキテクチャ (特に i386) における Linux のシステムコールの慣習の
+制限により、Linux 2.6 では起動直後は (41秒と) タイムウィンドウが小さく、
+\fBtimes\fP() がエラーが起こったことを示す \-1 を間違って返すことがある。 返り値
+が \fIclock_t\fP が格納可能な最大値を超過した際にも同じ問題が起こり得る。
.SH 関連項目
-.BR time (1),
-.BR getrusage (2),
-.BR wait (2),
-.BR clock (3),
-.BR sysconf (3),
-.BR time (7)
+\fBtime\fP(1), \fBgetrusage\fP(2), \fBwait\fP(2), \fBclock\fP(3), \fBsysconf\fP(3),
+\fBtime\fP(7)