+++ /dev/null
-.\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk
-.\" <mtk.manpages@gmail.com>
-.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" Japanese Version Copyright (c) 2012 Akihiro MOTOKI
-.\" all rights reserved.
-.\" Translated 2012-05-03, Akihiro MOTOKI <amotoki@gmail.com>
-.\"
-.TH PTHREAD_GETCPUCLOCKID 3 2014\-05\-23 Linux "Linux Programmer's Manual"
-.SH 名前
-pthread_getcpuclockid \- スレッドの CPU 時間時計の ID を取得する
-.SH 書式
-.nf
-\fB#include <pthread.h>\fP
-\fB#include <time.h>\fP
-
-\fBint pthread_getcpuclockid(pthread_t \fP\fIthread\fP\fB, clockid_t *\fP\fIclock_id\fP\fB);\fP
-.sp
-\fI\-pthread\fP でコンパイルしてリンクする。
-.fi
-.SH 説明
-.\" The clockid is constructed as follows:
-.\" *clockid = CLOCK_THREAD_CPUTIME_ID | (pd->tid << CLOCK_IDFIELD_SIZE)
-.\" where CLOCK_IDFIELD_SIZE is 3.
-\fBpthread_getcpuclockid\fP() 関数は、
-スレッド \fIthread\fP の CPU 時間時計のクロック ID を返す。
-.SH 返り値
-成功すると、この関数は 0 を返す。
-エラーの場合、 0 以外のエラー番号を返す。
-.SH エラー
-.TP
-\fBENOENT\fP
-.\" CLOCK_THREAD_CPUTIME_ID not defined
-.\"
-.\" Looking at nptl/pthread_getcpuclockid.c an ERANGE error would
-.\" be possible if kernel thread IDs took more than 29 bits (which
-.\" they currently cannot).
-スレッド単位の CPU 時間時計はこのシステムではサポートされていない。
-.TP
-\fBESRCH\fP
-ID が \fIthread\fP のスレッドが見つからなかった。
-.SH バージョン
-この関数は glibc バージョン 2.2 以降で利用できる。
-.SH 属性
-.SS "マルチスレッディング (pthreads(7) 参照)"
-\fBpthread_getcpuclockid\fP() 関数はスレッドセーフである。
-.SH 準拠
-POSIX.1\-2001.
-.SH 注意
-\fIthread\fP が呼び出したスレッドを参照している場合、
-クロック ID \fBCLOCK_THREAD_CPUTIME_ID\fP が指定されていれば、
-\fBclock_gettime\fP(2) と \fBclock_settime\fP(2) が操作するのと同じ時計
-を参照する ID が返される。
-.SH 例
-以下のプログラムは、スレッドを作成し、それから
-\fBclock_gettime\fP(2) を使ってプロセス全体の CPU 時間を取得し、
-\fBpthread_getcpuclockid\fP(3) を使って 2 つのスレッドが消費した
-スレッド毎の CPU 時間を取得する。
-下記のシェルのセッションは実行例である。
-
-.in +4n
-.nf
-$ \fB./a.out\fP
-Main thread sleeping
-Subthread starting infinite loop
-Main thread consuming some CPU time...
-Process total CPU time: 1.368
-Main thread CPU time: 0.376
-Subthread CPU time: 0.992
-.fi
-.in
-.SS プログラムのソース
-\&
-.nf
-/* "\-lrt" でリンクする */
-
-#include <time.h>
-#include <stdio.h>
-#include <stdlib.h>
-#include <unistd.h>
-#include <pthread.h>
-#include <string.h>
-#include <errno.h>
-
-#define handle_error(msg) \e
- do { perror(msg); exit(EXIT_FAILURE); } while (0)
-
-#define handle_error_en(en, msg) \e
- do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0)
-
-static void *
-thread_start(void *arg)
-{
- printf("Subthread starting infinite loop\en");
- for (;;)
- continue;
-}
-
-static void
-pclock(char *msg, clockid_t cid)
-{
- struct timespec ts;
-
- printf("%s", msg);
- if (clock_gettime(cid, &ts) == \-1)
- handle_error("clock_gettime");
- printf("%4ld.%03ld\en", ts.tv_sec, ts.tv_nsec / 1000000);
-}
-
-int
-main(int argc, char *argv[])
-{
- pthread_t thread;
- clockid_t cid;
- int j, s;
-
- s = pthread_create(&thread, NULL, thread_start, NULL);
- if (s != 0)
- handle_error_en(s, "pthread_create");
-
- printf("Main thread sleeping\en");
- sleep(1);
-
- printf("Main thread consuming some CPU time...\en");
- for (j = 0; j < 2000000; j++)
- getppid();
-
- pclock("Process total CPU time: ", CLOCK_PROCESS_CPUTIME_ID);
-
- s = pthread_getcpuclockid(pthread_self(), &cid);
- if (s != 0)
- handle_error_en(s, "pthread_getcpuclockid");
- pclock("Main thread CPU time: ", cid);
-
- /* The preceding 4 lines of code could have been replaced by:
- pclock("Main thread CPU time: ", CLOCK_THREAD_CPUTIME_ID); */
-
- s = pthread_getcpuclockid(thread, &cid);
- if (s != 0)
- handle_error_en(s, "pthread_getcpuclockid");
- pclock("Subthread CPU time: 1 ", cid);
-
- exit(EXIT_SUCCESS); /* Terminates both threads */
-}
-.fi
-.SH 関連項目
-\fBclock_gettime\fP(2), \fBclock_settime\fP(2), \fBtimer_create\fP(2),
-\fBclock_getcpuclockid\fP(3), \fBpthread_self\fP(3), \fBpthreads\fP(7), \fBtime\fP(7)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
