.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 2012, IBM Corporation.
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH __ppc_get_timebase 3 "5 février 2023" "Pages du manuel de Linux 6.03" 
.SH NOM
__ppc_get_timebase, __ppc_get_timebase_freq \- Récupérer la valeur courante
et la fréquence du Registre de Base Temporelle sur l'architecture Power.
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <sys/platform/ppc.h>\fP
.PP
\fBuint64_t __ppc_get_timebase(void);\fP
\fBuint64_t __ppc_get_timebase_freq(void);\fP
.fi
.SH DESCRIPTION
\fB__ppc_get_timebase\fP() lit et renvoie la valeur courante du Registre de
Base Temporelle alors que \fB__ppc_get_timebase_freq\fP() renvoie la fréquence
à laquelle le Registre de Base Temporelle est mis à jour.
.PP
Le Registre de Base Temporelle est un registre de 64\ bits disponibles sur
les processeurs d'architecture Power. Il stocke une valeur incrémentée de
façon monotone et mise à jour à une fréquence qui dépend du système et qui
peut être différente de celle du processeur.
.SH "VALEUR RENVOYÉE"
\fB__ppc_get_timebase\fP() renvoie un entier non signé de 64\ bits qui
représente la valeur courante du Registre de Base Temporelle.
.PP
\fB__ppc_get_timebase_freq\fP() renvoie un entier non signé de 64\ bits qui
représente la fréquence à laquelle le Registre de Base Temporelle est mis à
jour.
.SH VERSIONS
.\" commit d9dc34cd569bcfe714fe8c708e58c028106e8b2e
.\" commit 8ad11b9a9cf1de82bd7771306b42070b91417c11
La prise en charge par la bibliothèque GNU\ C de \fB__ppc_get_timebase\fP() date
de la glibc\ 2.16 et \fB__ppc_get_timebase_freq\fP() est disponible depuis la
glibc\ 2.17.
.SH STANDARDS
Ces fonctions sont des extensions GNU non standard.
.SH EXEMPLES
Le programme suivant calcule le temps en microsecondes passé entre deux
appels à \fB__ppc_get_timebase\fP().
.SS "Source du programme"
.\" SRC BEGIN (__ppc_get_timebase.c)
\&
.EX
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/platform/ppc.h>

/* Valeur maximale du Registre de Base Temporelle : 2\[ha]60 \- 1.
   Source: POWER ISA.  */
#define MAX_TB 0xFFFFFFFFFFFFFFF

int
main(void)
{
    uint64_t tb1, tb2, diff;
    uint64_t freq;

    freq = __ppc_get_timebase_freq();
    printf("Fréquence de la Base Temporelle = %"PRIu64" Hz\en", freq);

    tb1 = __ppc_get_timebase();

    // Faire quelque chose ...

    tb2 = __ppc_get_timebase();

    if (tb2 > tb1) {
        diff = tb2 \- tb1;
    } else {
        /* Traiter le dépassement du Registre de Base Temporelle.  */
        diff = (MAX_TB \- tb2) + tb1;
    }

    printf("Temps écoulé = %1.2f usecs\en",
            (double) diff * 1000000 / freq);

    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "VOIR AUSSI"
\fBtime\fP(2), \fBusleep\fP(3)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.rafin@laposte.net>,
Thierry Vignaud <tvignaud@mandriva.com>,
François Micaux,
Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>,
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>,
David Prévot <david@tilapin.org>
et
Grégoire Scano <gregoire.scano@malloc.fr>
.
.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 .