pthread_getcpuclockid(3)   Library Functions Manual   pthread_getcpuclockid(3)

NOM
       pthread_getcpuclockid - Recuperer l'identifiant d'horloge de temps CPU
       d'un thread

BIBLIOTHEQUE
       Bibliotheque de threads POSIX (libpthread, -lpthread)

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

       int pthread_getcpuclockid(pthread_t thread, clockid_t *clockid);

DESCRIPTION
       La fonction pthread_getcpuclockid() recupere l'identifiant d'horloge
       pour l'horloge de temps processeur du thread donne dans thread et le
       renvoie a l'emplacement vers lequel pointe clockid.

VALEUR RENVOYEE
       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 fil d'execution avec pour identifiant thread n'a pu etre
              trouve.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |pthread_getcpuclockid()          | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
NORMES
       POSIX.1-2008.

HISTORIQUE
       glibc 2.2.  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.

EXEMPLES
       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
       /* 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 */
       }

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

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Frederic Hantrais <fhantrais@gmail.com> et Jean-
       Philippe MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.18   20 aout 2025          pthread_getcpuclockid(3)