Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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> >>.