ntp_gettime(3) Library Functions Manual ntp_gettime(3)
NOM
ntp_gettime, ntp_gettimex - Obtenir des paramètres relatifs au temps
(interface du démon NTP)
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <sys/timex.h>
int ntp_gettime(struct ntptimeval *ntv);
int ntp_gettimex(struct ntptimeval *ntv);
DESCRIPTION
Ces deux fonctions renvoient des informations à l'appelant à l'aide de
l'argument ntv, une structure déclarée comme suit :
struct ntptimeval {
struct timeval time; /* Heure locale */
long maxerror; /* Erreur maximale */
long esterror; /* Erreur estimée */
long tai; /* Décalage TAI*/
/* Les octets de bourrage suivants autorisent une évolution future */
};
Les membres de cette structure sont les suivants :
time L'heure courante exprimée sous la forme d'une structure de type
timeval :
struct timeval {
time_t tv_sec; /* Secondes écoulées depuis l'Epoch */
suseconds_t tv_usec; /* Microsecondes */
};
maxerror
Erreur maximale en microsecondes. Cette valeur peut être initia-
lisée à l'aide de ntp_adjtime(3) et est incrémentée périodique-
ment (chaque seconde sous Linux), mais elle ne peut pas dépasser
une limite supérieure (la constante du noyau NTP_PHASE_MAX dont
la valeur est 16 000).
esterror
Erreur estimée en microsecondes. Cette valeur peut être définie
à l'aide de ntp_adjtime(3) pour contenir une estimation de la
différence entre l'heure de l'horloge système et l'heure exacte.
Cette valeur n'est pas utilisée au sein du noyau.
tai Décalage avec le TAI (Temps Atomique International).
ntp_gettime() renvoie une structure de type ntptimeval dont elle défi-
nit les membres time, maxerror et esterror.
ntp_gettimex() effectue la même tâche que ntp_gettime() mais en plus,
elle définit le membre tai de la structure de type ntptimeval renvoyée.
VALEUR RENVOYÉE
Les valeurs renvoyées par ntp_gettime() et ntp_gettimex() sont iden-
tiques à celles renvoyées par adjtimex(2). Si le pointeur passé comme
argument est correct, ces fonctions s'exécutent toujours avec succès.
VERSIONS
La fonction ntp_gettime() est disponible dans la glibc depuis la ver-
sion 2.1. La fonction ntp_gettimex() est disponible dans la glibc de-
puis la version 2.12.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌─────────────────────────────────────┬──────────────────────┬─────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────────────────┼──────────────────────┼─────────┤
│ntp_gettime(), ntp_gettimex() │ Sécurité des threads │ MT-Safe │
└─────────────────────────────────────┴──────────────────────┴─────────┘
STANDARDS
La fonction ntp_gettime() est décrite dans l'interface de programmation
d'application du noyau NTP. ntp_gettimex() est une extension GNU.
VOIR AUSSI
adjtimex(2), ntp_adjtime(3), time(7)
NTP "Kernel Application Program Interface"
⟨http://www.slac.stanford.edu/comp/unix/package/rtems/src/ssrlApps/
ntpNanoclock/api.htm⟩
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Lucien Gentis <lu-
cien.gentis@waika9.com>
Cette traduction est une documentation libre ; veuillez vous reporter à
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 RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 15 décembre 2022 ntp_gettime(3)
Generated by dwww version 1.15 on Sat Jun 29 01:45:32 CEST 2024.