.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pthread_getcpuclockid 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM pthread_getcpuclockid \- Récupérer l'identifiant d'horloge de temps CPU d'un thread .SH BIBLIOTHÈQUE Bibliothèque de threads POSIX (\fIlibpthread\fP, \fI\-lpthread\fP) .SH SYNOPSIS .nf \fB#include \fP \fB#include \fP .PP \fBint pthread_getcpuclockid(pthread_t \fP\fIthread\fP\fB, clockid_t *\fP\fIclockid\fP\fB);\fP .fi .SH DESCRIPTION .\" The clockid is constructed as follows: .\" *clockid = CLOCK_THREAD_CPUTIME_ID | (pd->tid << CLOCK_IDFIELD_SIZE) .\" where CLOCK_IDFIELD_SIZE is 3. La fonction \fBpthread_getcpuclockid\fP() récupère l'identifiant d'horloge pour l'horloge de temps processeur du thread donné dans \fIthread\fP et le renvoie à l'emplacement vers lequel pointe \fIclockid\fP. .SH "VALEUR RENVOYÉE" En cas de réussite, cette fonction renvoie 0\ ; en cas d'erreur, elle renvoie un numéro d'erreur non nul. .SH ERREURS .TP \fBENOENT\fP .\" CLOCK_THREAD_CPUTIME_ID not defined .\" .\" Looking at nptl/pthread_getcpuclockid.c an ERANGE error would .\" be possible if kernel thread IDs took more than 29 bits (which .\" they currently cannot). Les horloges de temps CPU par thread ne sont pas pris en charge par le système. .TP \fBESRCH\fP Aucun fil d’exécution avec pour identifiant \fIthread\fP n'a pu être trouvé. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBpthread_getcpuclockid\fP() T} Sécurité des threads MT\-Safe .TE .sp 1 .SH STANDARDS POSIX.1\-2008. .SH HISTORIQUE glibc 2.2. POSIX.1\-2001. .SH NOTES Quand \fIthread\fP se rapporte au thread appelant, cette fonction renvoie un identifiant qui indique la même horloge que celle manipulée par \fBclock_gettime\fP(2) et \fBclock_settime\fP(2) avec l'identifiant d'horloge \fBCLOCK_THREAD_CPUTIME_ID\fP. .SH EXEMPLES Le programme ci\-dessous crée un thread puis utilise \fBclock_gettime\fP(2) pour récupérer le temps CPU total du processus et le temps CPU utilisé par chacun des deux threads. La session suivante montre un exemple d'exécution\ : .PP .in +4n .EX $ \fB./a.out\fP 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 .EE .in .SS "Source du programme" .\" SRC BEGIN (pthread_getcpuclockid.c) \& .EX /* Lier avec "\-lrt" */ \& #include #include #include #include #include #include #include #include \& #define handle_error(msg) \\e do { perror(msg); exit(EXIT_FAILURE); } while (0) \& #define handle_error_en(en, msg) \e do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0) \& static void * thread_start(void *arg) { printf("Le sous\-thread commence une boucle infinie\en"); 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("%4jd.%03ld\en", (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) handle_error_en(s, "pthread_create"); \& printf("Le thread principal est en sommeil\en"); sleep(1); \& printf("Le thread principal consomme du temps processeur...\en"); for (unsigned int j = 0; j < 2000000; j++) getppid(); \& pclock("Temps total du processeur\ : ", CLOCK_PROCESS_CPUTIME_ID); \& s = pthread_getcpuclockid(pthread_self(), &cid); if (s != 0) handle_error_en(s, "pthread_getcpuclockid"); pclock("Temps processeur du thread principal\ : ", cid); \& /* Les 4 lignes de code précédentes auraient être pu être remplacées par\ : pclock("Temps processeur du thread principal\ : ", CLOCK_THREAD_CPUTIME_ID); */ \& s = pthread_getcpuclockid(thread, &cid); if (s != 0) handle_error_en(s, "pthread_getcpuclockid"); pclock("Temps processeur du sous\-pthread\ : 1 ", cid); \& exit(EXIT_SUCCESS); /* Terminer les deux threads */ } .EE .\" SRC END .SH "VOIR AUSSI" \fBclock_gettime\fP(2), \fBclock_settime\fP(2), \fBtimer_create\fP(2), \fBclock_getcpuclockid\fP(3), \fBpthread_self\fP(3), \fBpthreads\fP(7), \fBtime\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Frédéric Hantrais et Jean-Philippe MENGUAL . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .