Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       clock_getcpuclockid  -  Obtenir  l'identifiant  de  l'horloge  CPU d'un
       processus

SYNOPSIS

       #include <time.h>

       int clock_getcpuclockid(pid_t pid, clockid_t *clock_id);

       Effectuez l'edition des liens avec l'option -lrt.

   Exigences de macros de test de fonctionnalites pour la glibc (consultez
   feature_test_macros(7)) :

       clock_getcpuclockid() :
           _XOPEN_SOURCE >= 600 || _POSIX_C_SOURCE >= 200112L

DESCRIPTION

       La  fonction  clock_getcpuclockid()  obtient l'identifiant de l'horloge
       CPU du  processus  dont  l'identifiant  est  pid  et  le  renvoie  dans
       l'emplacement  pointe par clock_id. Si pid est nul, alors l'identifiant
       de l'horloge CPU du processus appelant est renvoye.

VALEUR RENVOY'EE

       En cas de reussite, clock_getcpuclockid() renvoie 0. En  cas  d'erreur,
       elle renvoie un numero d'erreur positif liste dans ERRORS.

ERREURS

       ENOSYS Le  noyau  ne  permet  pas  d'obtenir  l'horloge  CPU d'un autre
              processus et pid ne correspond pas au processus appelant.

       EPERM  L'appelant n'a pas les permissions pour acceder a l'horloge  CPU
              du  processus  indique  par  pid.  (Specifiee  comme  une erreur
              optionnelle dans POSIX.1-2001 ; elle  ne  se  produit  pas  sous
              Linux  a  moins que le noyau ne permette pas d'obtenir l'horloge
              CPU d'un autre processus)

       ESRCH  Il n'y a pas de processus ayant pour identifiant pid

VERSIONS

       La fonction clock_getcpuclockid() est disponible dans la  glibc  depuis
       la version 2.2.

CONFORMIT'E

       POSIX.1-2001.

NOTES

       Un  appel a clock_gettime(2) avec l'identifiant d'horloge obtenu par un
       appel a clock_getcpuclockid() avec un  pid  de  0  revient  a  utiliser
       l'identifiant d'horloge CLOCK_PROCESS_CPUTIME_ID.

EXEMPLE

       Le  programme  d'exemple  ci-dessous obtient l'identifiant de l'horloge
       CPU du  processus  dont  l'identifiant  est  fourni  sur  la  ligne  de
       commande,  puis  utilise clock_gettime(2) pour obtenir l'heure de cette
       horloge. Un exemple d'execution suit :

           $ ./a.out 1                 # Show CPU clock of init process
           CPU-time clock for PID 1 is 2.213466748 seconds

   Source du programme

       #define _XOPEN_SOURCE 600
       #include <stdio.h>
       #include <unistd.h>
       #include <stdlib.h>
       #include <time.h>

       int
       main(int argc, char *argv[])
       {
           clockid_t clockid;
           struct timespec ts;

           if (argc != 2) {
               fprintf(stderr, "%s <process-ID>\n", argv[0]);
            exit(EXIT_FAILURE);
           }

           if (clock_getcpuclockid(atoi(argv[1]), &clockid) != 0) {
            perror("clock_getcpuclockid");
            exit(EXIT_FAILURE);
           }

           if (clock_gettime(clockid, &ts) == -1) {
            perror("clock_gettime");
            exit(EXIT_FAILURE);
           }

           printf("CPU-time clock for PID %s is %ld.%09ld seconds\n",
                argv[1], (long) ts.tv_sec, (long) ts.tv_nsec);
           exit(EXIT_SUCCESS);
       }

VOIR AUSSI

       clock_getres(2), timer_create(2), pthread_getcpuclockid(3), 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/>.

       Alain Portal <URL:http://manpagesfr.free.fr/> (2008).

       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> >>.