times

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

名前

times - プロセス時間を取得する  

ライブラリ

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

書式

#include <sys/times.h>

clock_t times(struct tms *buf);
 

説明

times() は現在のプロセス時間を buf が指している struct tms に格納します。struct tms<sys/times.h> で以下のように定義されています:

struct tms  {
    clock_t tms_utime;  /* user time */
    clock_t tms_stime;  /* system time */
    clock_t tms_cutime; /* user time of children */
    clock_t tms_cstime; /* system time of children */
};

tms_utime フィールドは、呼び出したプロセスが命令を実行するのに消費した CPU 時間です。tms_stime フィールドは、呼び出したプロセスの代わりに実行されたタスクで、カーネル内で実行に費やされた CPU時間です。

tms_cutime フィールドは、 終了を待っている全ての子プロセスの tms_utimetms_cutime の合計です。 tms_cstime フィールドは、 終了を待っている全ての子プロセスの tms_stimetms_cstime の合計です。

終了する子(及びその子孫)プロセスの時間は wait(2) や waitpid(2) がプロセス ID を返した瞬間に加算されます。つまり、子がまだ終了を待っていない状態では、孫プロセスの時間は決して現れません。

全ての時間はクロック数で返されます。  

返り値

times() は過去のある時点から経過したクロック数 (clock tick) を返します。この戻り値は clock_t 型が取り得る範囲からオーバーフローするかもしれません。エラーの場合、(clock_t) -1 が返され、 errnoは、エラーを表示するために設定されます。  

エラー

EFAULT
tms がプロセスのアドレス空間の外を指しています。
 

バージョン

Linux では、 buf 引数に NULL を指定することができ、その場合は times() は単に関数の結果を返します。しかし、POSIX はこの振る舞いは規定されておらず、 その他のほとんどの UNIX 実装は buf の値として非 NULL の値を要求します。  

標準

POSIX.1-2024.  

履歴

POSIX.1-2001, SVr4, 4.3BSD.

POSIX.1-1996 では、CLK_TCK シンボル (<time.h> で定義されています)は古いものと記述されています。今ではこれは古いものです。

Linux 2.6.9 より前のバージョンでは、 SIGCHLDSIG_IGN に設定すると、終了した子プロセスの時間は自動的に tms_cstimetms_cutime フィールドに含まれます。しかし、POSIX.1-2001 では、この動作は呼び出し元が wait(2) 関数群で子プロセスを待った場合にのみ起きるべきだとしています。標準とは異なるこの動作は Linux 2.6.9 以降で修正されている。

Linux では、 times() の返り値を計算する起点となる「過去の任意の時点」は、カーネルのバージョン により異なります。Linux 2.4 以前では、この時点はシステムが起動した瞬間である。 Linux 2.6 以降では、この時点はシステム起動時刻の (2^32/HZ) - 300 秒前です。このようにカーネルバージョン (や UNIX の実装) により異なることと、 返り値が clock_t の範囲をオーバーフローする可能性があるという事実を考慮すると、 移植性が必要なアプリケーションではこの値を使うのは避けるのが賢明です。経過時間を測りたい場合には、代わりに clock_gettime(2) を使用します。

SVr1-3 では long を返し、構造体のメンバに time_t 型を使っていましたが、紀元からの秒数ではなくクロック数を格納していました。V7 では構造体のメンバに long 型を使っていました。まだ time_t 型がなかったからです。  

注意

一秒あたりのクロック数は以下で得ることができます。

 sysconf(_SC_CLK_TCK);

clock(3) も clock_t 型の値を返しますが、この値は times() で使用されるクロック tick 数ではなく、 CLOCKS_PER_SEC が単位である点に注意してください。  

バグ

いくつかのアーキテクチャ (特に i386) における Linux のシステムコールの慣習の制限により、Linux 2.6 では起動直後は (41秒と) タイムウィンドウが小さく、times() がエラーが起こったことを示す -1 を間違って返すことがあります。戻り値が clock_t が格納可能な最大値を超過した際にも同じ問題が起こり得ます。  

関連項目

time(1), getrusage(2), wait(2), clock(3), sysconf(3), time(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
バージョン
標準
履歴
注意
バグ
関連項目

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