clock_getcpuclockid(3)     Library Functions Manual     clock_getcpuclockid(3)

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

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc), depuis la glibc 2.17

       Avant la glibc 2.17, bibliotheque de temps reel (librt, -lrt)

SYNOPSIS
       #include <time.h>

       int clock_getcpuclockid(pid_t pid, clockid_t *clockid);

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

       clock_getcpuclockid() :
           _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 clockid. Si pid est nul, alors l'identifiant
       de l'horloge CPU du processus appelant est renvoye.

VALEUR RENVOYEE
       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

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

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

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

EXEMPLES
       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                 # Montrer l'horloge CPU du processus init
           CPU-time clock for PID 1 is 2.213466748 seconds

   Source du programme
       #define _XOPEN_SOURCE 600
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <time.h>
       #include <unistd.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 %jd.%09ld seconds\n",
                  argv[1], (intmax_t) ts.tv_sec, ts.tv_nsec);
           exit(EXIT_SUCCESS);
       }

VOIR AUSSI
       clock_getres(2), timer_create(2), pthread_getcpuclockid(3), 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> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       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.06   31 octobre 2023         clock_getcpuclockid(3)