pthread_getcpuclockid
Section: C Library Functions (3)
Updated: 2025-08-20
Index
JM Home Page
roff page
名前
pthread_getcpuclockid - スレッドの CPU 時間時計の ID を取得する
ライブラリ
POSIX スレッドライブラリ (libpthread,~-lpthread)
書式
#include <pthread.h>
#include <time.h>
int pthread_getcpuclockid(pthread_t thread, clockid_t *clockid);
説明
The pthread_getcpuclockid() function obtains the ID of the CPU-time
clock of the thread whose ID is given in thread, and returns it in the
location pointed to by clockid.
返り値
成功すると、この関数は 0 を返す。
エラーの場合、 0 以外のエラー番号を返す。
エラー
- ENOENT
-
スレッド単位の CPU 時間時計はこのシステムではサポートされていない。
- ESRCH
-
ID が thread のスレッドが見つからなかった。
属性
この節で使用されている用語の説明については、 attributes(7) を参照。
| インターフェース | 属性 | 値
|
|
pthread_getcpuclockid()
| Thread safety | MT-Safe
|
標準規格
POSIX.1-2008.
歴史
glibc 2.2. POSIX.1-2001.
注意
thread が呼び出したスレッドを参照している場合、
クロック ID CLOCK_THREAD_CPUTIME_ID が指定されていれば、
clock_gettime(2) と clock_settime(2) が操作するのと同じ時計
を参照する ID が返される。
例
以下のプログラムは、スレッドを作成し、それから
clock_gettime(2) を使ってプロセス全体の CPU 時間を取得し、
pthread_getcpuclockid(3) を使って 2 つのスレッドが消費した
スレッド毎の CPU 時間を取得する。
下記のシェルのセッションは実行例である。
$ ./a.out;
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
プログラムのソース
/* Link with "-lrt" */
#include <err.h>
#include <errno.h>
#include <pthread.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/time.h>
#include <time.h>
#include <unistd.h>
static void *
thread_start(void *arg)
{
printf("Subthread starting infinite loop\n");
for (;;)
continue;
}
static void
pclock(char *msg, clockid_t cid)
{
struct timespec ts;
printf("%s", msg);
if (clock_gettime(cid, &ts) == -1)
err(EXIT_FAILURE, "clock_gettime");
printf("%4jd.%03ld\n", (intmax_t) ts.tv_sec, ts.tv_nsec / 1000000);
}
int
main(void)
{
pthread_t thread;
clockid_t cid;
int s;
s = pthread_create(&thread, NULL, thread_start, NULL);
if (s != 0)
errc(EXIT_FAILURE, s, "pthread_create");
printf("Main thread sleeping\n");
sleep(1);
printf("Main thread consuming some CPU time...\n");
for (unsigned int j = 0; j < 2000000; j++)
getppid();
pclock("Process total CPU time: ", CLOCK_PROCESS_CPUTIME_ID);
s = pthread_getcpuclockid(pthread_self(), &cid);
if (s != 0)
errc(EXIT_FAILURE, 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)
errc(EXIT_FAILURE, s, "pthread_getcpuclockid");
pclock("Subthread CPU time: 1 ", cid);
exit(EXIT_SUCCESS); /* Terminates both threads */
}
関連項目
clock_gettime(2), clock_settime(2), timer_create(2),
clock_getcpuclockid(3), pthread_self(3), pthreads(7), time(7)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 属性
-
- 標準規格
-
- 歴史
-
- 注意
-
- 例
-
- プログラムのソース
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.