Manpages

名 前

pthread_getcpuclockid − ス レ ッ ド の CPU 時 間 時 計 の ID を 取 得 す る

書 式

#include <pthread.h>
#include <time.h>

int pthread_getcpuclockid(pthread_t thread, clockid_t *clock_id);

−pthread で コ ン パ イ ル し て リ ン ク す る 。

説 明

pthread_getcpuclockid() 関 数 は 、 ス レ ッ ド thread の CPU 時 間 時 計 の ク ロ ッ ク ID を 返 す 。

返 り 値

成 功 す る と 、 こ の 関 数 は 0 を 返 す 。 エ ラ ー の 場 合 、 0 以 外 の エ ラ ー 番 号 を 返 す 。

エ ラ ー

い 。

バ ー ジ ョ ン

こ の 関 数 は glibc バ ー ジ ョ ン 2.2 以 降 で 利 用 で き る 。

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )

pthread_getcpuclockid() 関 数 は ス レ ッ ド セ ー フ で あ る 。

準 拠

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 プ ロ グ ラ ム の ソ ー ス

/* "−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) \
do { perror(msg); exit(EXIT_FAILURE); } while (0)

#define handle_error_en(en, msg) \
do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0)

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)
handle_error("clock_gettime");
printf("%4ld.%03ld\n", 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\n");
sleep(1);

printf("Main thread consuming some CPU time...\n");
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 */ }

関 連 項 目

clock_gettime(2), clock_settime(2), timer_create(2), clock_getcpuclockid(3), pthread_self(3), pthreads(7), time(7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。