Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
pthread_getcpuclockid - Recuperer l'identifiant d'horloge de temps CPU
d'un thread
SYNOPSIS
#include <pthread.h>
#include <time.h>
int pthread_getcpuclockid(pthread_t thread, clockid_t *clock_id);
Compilez et effectuez l'edition des liens avec l'option -pthread.
DESCRIPTION
La fonction pthread_getcpuclockid() renvoie l'identifiant d'horloge
pour l'horloge de temps CPU du thread thread.
VALEUR RENVOY'EE
En cas de reussite, cette fonction renvoie 0 ; en cas d'erreur, elle
renvoie un numero d'erreur non nul.
ERREURS
ENOENT Les horloges de temps CPU par thread ne sont pas pris en charge
par le systeme.
ESRCH Aucun thread avec pour identifiant thread n'a pu etre trouve.
VERSIONS
Cette fonction est disponible dans la glibc depuis la version 2.2.
CONFORMIT'E
POSIX.1-2001.
NOTES
Quand thread se rapporte au thread appelant, cette fonction renvoie un
identifiant qui indique la meme horloge que celle manipulee par
clock_gettime(2) et clock_settime(2) avec l'identifiant d'horloge
CLOCK_THREAD_CPUTIME_ID.
EXEMPLE
Le programme ci-dessous cree un thread puis utilise clock_gettime(2)
pour recuperer le temps CPU total du processus et le temps CPU utilise
par chacun des deux threads. La session suivante montre un exemple
d'execution :
$ ./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
Source du programme
/* Effectuez l'edition des liens avec l'option "-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 */
}
VOIR AUSSI
clock_gettime(2), clock_settime(2), timer_create(2),
clock_getcpuclockid(3), pthread_self(3), pthreads(7), time(7)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Nicolas Francois et l'equipe francophone de traduction de
Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
Linux 8 fevrier 2009 PTHREAD_GETCPUCLOCKID(3)