Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
adjtimex - Regler l'horloge du noyau (kernel clock)
SYNOPSIS
#include <sys/timex.h>
int adjtimex(struct timex *buf);
DESCRIPTION
Linux utilise l'algorithme d'ajustement d'horloge de David L. Mills
(RFC 1305). L'appel systeme adjtimex() lit, et ecrit eventuellement les
parametres d'ajustement pour cet algorithme. Il utilise un pointeur sur
une structure timex pour mettre a jour les parametres du noyau avec les
valeurs de ses champs, et renvoyer la meme structure avec les valeurs
actuelles du noyau. La structure est declaree comme suit :
struct timex {
int modes; /* choix du mode */
long offset; /* decalage temporel (usec) */
long freq; /* difference de frequence (scaled ppm) */
long maxerror; /* erreur maximale (usec) */
long esterror; /* erreur estimee (usec) */
int status; /* commande/etat de l'horloge */
long constant; /* constante de temps pll */
long precision; /* precision de l'horloge (usec)
(lecture seule) */
long tolerance; /* tolerance sur la frequence de
l'horloge (ppm) (lecture seule)
struct timeval time; /* heure actuelle (lecture seule) */
long tick; /* microsecondes entre les tops
de l'horloge */
};
Le champ modes determine les parametres eventuels a ecrire. Il contient
un OU binaire << | >> entre les valeurs suivantes :
#define ADJ_OFFSET 0x0001 /* decalage d'heure */
#define ADJ_FREQUENCY 0x0002 /* decalage de frequence */
#define ADJ_MAXERROR 0x0004 /* erreur temporelle maximale */
#define ADJ_ESTERROR 0x0008 /* erreur temporelle estimee */
#define ADJ_STATUS 0x0010 /* etat de l'horloge */
#define ADJ_TIMECONST 0x0020 /* constante de temps pll */
#define ADJ_TICK 0x4000 /* valeur du top */
#define ADJ_OFFSET_SINGLESHOT 0x8001 /* ancien adjtime() */
Les utilisateurs normaux sont limites a une valeur de mode nulle, seul
le superutilisateur peut ecrire les parametres.
VALEUR RENVOY'EE
S'il reussit, adjtimex() renvoie l'etat de l'horloge :
#define TIME_OK 0 /* horloge synchronisee */
#define TIME_INS 1 /* ajout d'une seconde */
#define TIME_DEL 2 /* suppression d'une seconde */
#define TIME_OOP 3 /* seconde d'ajustement en cours */
#define TIME_WAIT 4 /* seconde d'ajustement terminee */
#define TIME_BAD 5 /* horloge non synchronisee */
En cas d'echec adjtimex() renvoie -1 et remplit errno.
ERREURS
EFAULT buf pointe en dehors de l'espace d'adressage accessible en
ecriture.
EINVAL Une tentative est faite de remplir buf.offset en dehors de
l'intervalle -131071 a +131071, ou de mettre buf.status a une
valeur autre que celles listees ci-dessus, ou buf.tick en dehors
de l'intervalle 900000/HZ a 1100000/HZ, ou HZ est la frequence
d'interruption de l'horloge systeme.
EPERM buf.mode est non nul, et l'appelant n'a pas suffisamment de
privileges. Sous Linux, la capacite CAP_SYS_TIME est necessaire.
CONFORMIT'E
adjtimex() est specifique a Linux, et ne doit pas etre employe dans des
programmes destines a etre portes sur d'autres systemes. Consultez
adjtime(3) pour une methode plus portable, mais moins flexible, de
configurer l'horloge systeme.
VOIR AUSSI
settimeofday(2), adjtime(3), capabilities(7), 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/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Julien
Cristau et l'equipe francophone de traduction de Debian (2006-2009).
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> >>.