Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] adjtimex - Régler l'horloge du noyau (kernel clock). [size=18] [b]Résumé[/b] [/size] [b]#include <sys/timex.h>[/b] [b][i]int adjtimex(struct timex * buf );[/i][/b] [size=18] [b]Description[/b] [/size] Linux utilise l'algorithme d'ajustement d'horloge de David L. Mills (RFC 1305). L'appel-système [b]adjtimex[/b] lit, et écrit éventuellement les paramètres d'ajustement pour cet algorithme. Il utilise un pointeur sur une structure [i]timex [/i] pour mettre à jour les paramètres du noyau avec les valeurs de ses champs, et renvoyer la même structure avec les valeurs actuelles du noyau. La structure est déclarée comme suit [table][row][col]    [/col][col] .nf struct timex { int modes; /* mode selector / long offset; / time offset (usec) / long freq; / frequency offset (scaled ppm) / long maxerror; / maximum error (usec) / long esterror; / estimated error (usec) / int status; / clock command/status / long constant; / pll time constant / long precision; / clock precision (usec) (read only) / long tolerance; / clock frequency tolerance (ppm) (read only) / struct timeval time; / current time (read only) / long tick; / usecs between clock ticks / }; .fi[/col][/row][/table] Le champ [i]modes[/i] détermine les paramètres éventuels à écrire. Il contient un [i]OU [/i] binaire ( \| ) entre les valeurs suivantes: [table][row][col]    [/col][col] .nf #define ADJ_OFFSET 0x0001 / time offset / #define ADJ_FREQUENCY 0x0002 / frequency offset / #define ADJ_MAXERROR 0x0004 / maximum time error / #define ADJ_ESTERROR 0x0008 / estimated time error / #define ADJ_STATUS 0x0010 / clock status / #define ADJ_TIMECONST 0x0020 / pll time constant / #define ADJ_TICK 0x4000 / tick value / #define ADJ_OFFSET_SINGLESHOT 0x8001 / old-fashioned adjtime / .fi[/col][/row][/table] Les utilisateurs normaux sont limités à une valeur de [b]mode [/b] nulle, seul le Super-User peut écrire les paramètres. [b][/b] .ne 12v [size=18] [b]Valeur renvoyée[/b] [/size] S'il réussit, [b]adjtimex[/b] renvoie l'état de l'horloge : [table][row][col]    [/col][col] .nf #define TIME_OK 0 / clock synchronized / #define TIME_INS 1 / insert leap second / #define TIME_DEL 2 / delete leap second / #define TIME_OOP 3 / leap second in progress / #define TIME_WAIT 4 / leap second has occurred / #define TIME_BAD 5 / clock not synchronized */ .fi[/col][/row][/table] En cas d'échec [b]adjtimex[/b] renvoie -1 et remplit [b]errno .[/b] [size=18] [b]Erreurs[/b] [/size] [b]EFAULT[/b] [i]buf[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] [b]EPERM[/b] [i]buf.mode[/i] [table][row][col]    [/col][col]est non nul, et l'utilisateur n'est pas Super-User.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Une tentative est faite de remplir [i]buf.offset[/i] en dehors de l'intervalle -131071 à +131071, ou de mettre [i]buf.status[/i] a une valeur autre que celle listée ci-dessus, ou [i]buf.tick[/i] en dehors de l'intervalle [b]900000/ HZ[/b] à [b]1100000/ HZ ,[/b] où [b]HZ[/b] est la fréquence d'interruption de l'horloge système.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] [b]adjtimex[/b] est spécifique à Linux, et ne doit pas être employé dans des programmes destinés à être portés sur d'autres systèmes. Un appel [b]adjtime[/b] moins général existe sous SVr4. [size=18] [b]Voir aussi[/b] [/size] [b]settimeofday (2).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier