'\" t
.\"     Title: hwclock
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Administration Système
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "HWCLOCK" "8" "2024-04-27" "util\-linux 2.40" "Administration Système"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NOM"
hwclock \- utilitaire d’horloges
.SH "SYNOPSIS"
.sp
\fBhwclock\fP [\fIfunction\fP] [\fIoption\fP...]
.SH "DESCRIPTION"
.sp
\fBhwclock\fP is an administration tool for the time clocks. It can: display the Hardware Clock time; set the Hardware Clock to a specified time; set the Hardware Clock from the System Clock; set the System Clock from the Hardware Clock; compensate for Hardware Clock drift; correct the System Clock timescale; set the kernel\(cqs timezone, NTP timescale, and epoch (Alpha only); and predict future Hardware Clock values based on its drift rate.
.sp
Depuis la version 2.26, des modifications importantes ont été faites à la fonction \fB\-\-hctosys\fP et à l’option \fB\-\-directisa\fP, et une nouvelle option \fB\-\-update\-drift\fP a été ajoutée. Consultez leurs descriptions respectives ci\-dessous.
.SH "FONCTIONS"
.sp
Les fonctions suivantes s’excluent mutuellement, une seule peut être indiquée à la fois. Si aucune n’est indiquée, \fB\-\-show\fP est utilisée par défaut.
.sp
\fB\-a, \-\-adjust\fP
.RS 4
Ajouter ou retirer du temps à l’horloge matérielle pour tenir compte de la dérive systématique depuis la dernière fois où l’horloge a été ajustée. Consultez la discussion ci\-dessous, sous \fBLa fonction d\(cqajustement\fP.
.RE
.sp
\fB\-\-getepoch\fP; \fB\-\-setepoch\fP
.RS 4
Ces fonctions sont uniquement pour les machines Alpha et ne sont disponibles qu’avec le pilote RTC du noyau Linux.
.sp
Lire et définir la valeur d’Époque de l’horloge matérielle. C’est l’année grégorienne qui correspond à la valeur zéro du champ année de l’horloge matérielle. Par exemple, si le BIOS de la machine définit le décompte d’années entières de l’horloge matérielle au nombre d\(cqannées entières depuis 1952, la valeur d’Époque de l’horloge matérielle pour le noyau doit être 1952.
.sp
La fonction \fB\-\-setepoch\fP nécessite l’utilisation de l’option \fB\-\-epoch\fP pour préciser l’année. Par exemple :
.sp
\fBhwclock \-\-setepoch \-\-epoch=1952\fP
.sp
Le pilote de l’horloge temps réel (RTC) essaie de deviner la valeur correcte d’Époque, aussi la régler peut ne pas être nécessaire.
.sp
La valeur de l\(cqÉpoque est utilisée à chaque fois que \fBhwclock\fP lit ou ajuste l’horloge matérielle sur une machine Alpha. Pour les machines ISA, le noyau utilise une valeur fixe de 1900 pour l’Époque.
.RE
.sp
\fB\-\-param\-get=\fP\fIparameter\fP; \fB\-\-param\-set=\fP\fIparameter\fP=\fIvalue\fP
.RS 4
Read and set the RTC\(cqs parameter. This is useful, for example, to retrieve the RTC\(cqs feature or set the RTC\(cqs Backup Switchover Mode.
.sp
\fIparameter\fP is either a numeric RTC parameter value (see the Kernel\(cqs \fIinclude/uapi/linux/rtc.h\fP) or an alias. See \fB\-\-help\fP for a list of valid aliases. \fIparameter\fP and \fIvalue\fP, if prefixed with 0x, are interpreted as hexadecimal, otherwise decimal values.
.RE
.sp
\fB\-\-predict\fP
.RS 4
Prédire ce que l’horloge matérielle lira dans le futur à partir de l’heure donnée par l’option \fB\-\-date\fP et des renseignements de \fI/etc/adjtime\fP. C’est utile, par exemple, pour prendre en compte la dérive lors de la définition d’un réveil (alarme) par l’horloge matérielle. Consultez \fBrtcwake\fP(8).
.sp
N’utilisez pas cette fonction si l’horloge matérielle est modifiée par autre chose que la commande \fBhwclock\fP du système d’exploitation actuel, comme le « mode 11 minutes » ou par un autre système d’exploitation en multiboot.
.RE
.sp
\fB\-r\fP, \fB\-\-show\fP; \fB\-\-get\fP
.RS 4
Lire l’horloge matérielle matérielle et afficher l’heure sur la sortie standard au format \fBISO\(rs 8601\fP. L’heure affichée est toujours en heure locale, même si l’horloge matérielle est en temps universel. Consultez l\(cqoption \fB\-\-localtime\fP.
.sp
Montrer l\(cqheure de l’horloge matérielle est l\(cqaction par défaut si aucune fonction n\(cqest indiquée.
.sp
La fonction \fB\-\-get\fP applique aussi la correction de dérive à l’heure lue, à partir des renseignements de \fI/etc/adjtime\fP. N’utilisez pas cette fonction si l’horloge matérielle est modifiée par autre chose que la commande \fBhwclock\fP du système d’exploitation actuel, comme le « mode 11 minutes » ou par un autre système d’exploitation en multiboot.
.RE
.sp
\fB\-s\fP, \fB\-\-hctosys\fP
.RS 4
Mettre l’heure système à l’heure de l’horloge matérielle. L’heure lue de l’horloge matérielle est compensée pour prendre en compte la dérive systématique avant de l’utiliser pour définir l’heure système. Consultez la discussion ci\-dessous, sous \fBLa fonction d\(cqajustement\fP.
.sp
L’horloge système doit être gardée en UTC pour que les applications de date et d\(cqheure fonctionnent correctement avec le fuseau horaire configuré sur le système. Si l’horloge matérielle est conservée en heure locale, alors l’heure qui y est lue doit être convertie en UTC avant de l’utiliser pour définir l’horloge système. La fonction \fB\-\-hctosys\fP le fait à partir des renseignements du fichier \fI/etc/adjtime\fP ou des arguments \fB\-\-localtime\fP et \fB\-\-utc\fP en ligne de commande. Remarque : aucun ajustement d’heure d’été n’est réalisé. Consultez la discussion ci\-dessous sous \fBLOCALE ou UTC\fP.
.sp
The kernel also keeps a timezone value, the \fB\-\-hctosys\fP function sets it to the timezone configured for the system. The system timezone is configured by the \fBTZ\fP environment variable or the \fI/etc/localtime\fP file, as \fBtzset\fP(3) would interpret them. The obsolete \fItz_dsttime\fP field of the kernel\(cqs timezone value is set to zero. (For details on what this field used to mean, see \fBsettimeofday\fP(2).)
.sp
Lors d’une utilisation dans un script de démarrage, si la fonction \fB\-\-hctosys\fP est la première à appeler \fBsettimeofday\fP(2) depuis le démarrage, cela définira le « mode 11 minutes » de NTP par l’intermédiaire de la variable \fIpersistent_clock_is_local\fP du noyau. Si la configuration du fuseau horaire de l’horloge matérielle est modifiée, alors un redémarrage est nécessaire pour informer le noyau. Consultez la discussion ci\-dessous, sous \fBSynchronisation automatique de l’horloge matérielle par le noyau\fP.
.sp
C’est une fonction particulièrement utile dans un des scripts de démarrage avant que les systèmes de fichiers ne soient montés en lecture et écriture.
.sp
Cette fonction ne devrait jamais être utilisée sur un système en fonctionnement. Les sauts d’horloge système provoqueront des problèmes comme par exemple des horodatages corrompus sur le système de fichiers. Ainsi, si quelque chose a modifié l’horloge matérielle, comme le « mode 11 minutes » de NTP, \fB\-\-hctosys\fP définira l’heure de façon incorrecte en incluant la compensation de dérive.
.sp
La compensation de dérive peut être inhibée en définissant le facteur de dérive à zéro dans \fI/etc/adjtime\fP. Ce réglage sera persistant tant que l’option \fB\-\-update\-drift\fP n’est pas utilisée avec \fB\-\-systohc\fP à l’arrêt (ou n’importe quand). Une autre façon d’inhiber cela est d’utiliser l’option \fB\-\-noadjfile\fP en appelant la fonction \fB\-\-hctosys\fP. Une troisième méthode est d’effacer le fichier \fI/etc/adjtime\fP. \fBhwclock\fP utilisera alors UTC par défaut pour l’horloge matérielle. Si l’horloge matérielle est à l’heure locale, elle devra être définie dans le fichier. Cela peut être fait en appelant \fBhwclock\(rs \-\-localtime\(rs \-\-adjust\fP ; quand le fichier n’est pas présent, cette commande n’ajustera pas vraiment l’horloge, mais créera le fichier avec l’heure locale configurée et un facteur de dérive à zéro.
.sp
Une condition sous laquelle l’inhibition de correction de dérive de \fBhwclock\fP peut être utile est lorsque plusieurs systèmes sont utilisés en multiboot. Pendant que cette instance de Linux est arrêtée, si un autre système d’exploitation modifie la valeur de l’horloge matérielle, la correction de dérive appliquée sera incorrecte quand cette instance redémarrera.
.sp
Pour que la correction de dérive de \fBhwclock\fP fonctionne correctement, rien ne doit modifier l’horloge matérielle pendant que son instance de Linux n’est pas en fonctionnement.
.RE
.sp
\fB\-\-set\fP
.RS 4
Mettre l’horloge matérielle à l’heure donnée par l\(cqoption \fB\-\-date\fP et mettre à jour les horodatages dans \fI/etc/adjtime\fP. Avec l’option \fB\-\-update\-drift\fP, recalculer le facteur de dérive. À essayer sans cette option si \fB\-\-set\fP échoue. Consulter \fB\-\-update\-drift\fP ci\-après.
.RE
.sp
\fB\-\-systz\fP
.RS 4
C\(cqest une alternative à la fonction \fB\-\-hctosys\fP qui ne lit pas l’horloge matérielle et n’ajuste pas l’horloge système ; par conséquent, aucune correction de dérive n’est effectuée. Elle est conçue pour être utilisée dans un script de démarrage sur les systèmes avec des noyaux de version supérieure à 2.6 où l’horloge système a été ajustée depuis l’horloge matérielle par le noyau lors du démarrage.
.sp
Elle procède aux actions suivantes qui sont détaillées ci\-dessus dans la fonction \fB\-\-hctosys\fP :
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
correction du fuseau horaire de l’horloge matérielle en UTC si nécessaire. Seulement, au lieu d’accomplir cela en réglant l’horloge système, \fBhwclock\fP informe simplement le noyau qui se charge de la modification ;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
activation du « mode 11 minutes » de NTP du noyau ;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
définition du fuseau horaire du noyau.
.RE
.RE
.sp
Les deux premières actions ne sont disponibles que lors du premier appel de \fBsettimeofday\fP(2) après le démarrage. Par conséquent, cette option n’a de sens que dans un script de démarrage. Si la configuration du fuseau horaire de l’horloge matérielle est modifiée, un redémarrage serait nécessaire pour informer le noyau.
.sp
\fB\-w\fP, \fB\-\-systohc\fP
.RS 4
Mettre l’horloge matérielle à l’heure système et mettre à jour les horodatages dans \fI/etc/adjtime\fP. Avec l’option \fB\-\-update\-drift\fP, (re)calculer le facteur de dérive. À essayer sans l’option si \fB\-\-systohc\fP échoue. Consulter \fB\-\-update\-drift\fP ci\-après.
.RE
.sp
\fB\-\-vl\-read\fP, \fB\-\-vl\-clear\fP
.RS 4
Some RTC devices are able to monitor the voltage of the backup battery and thus provide a way for the user to know that the battery should be replaced. The \fB\-\-vl\-read\fP function retrieves the Voltage Low information and decodes the result into human\-readable form. The \fB\-\-vl\-clear\fP function resets the Voltage Low information, which is necessary for some RTC devices after a battery replacement.
.sp
See the Kernel\(cqs \fIinclude/uapi/linux/rtc.h\fP for details on which pieces of information may be returned. Note that not all RTC devices have this monitoring capability, nor do all drivers necessarily support reading the information.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher l’aide\-mémoire puis quitter.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afficher le numéro de version et quitter.
.RE
.SH "OPTIONS"
.sp
\fB\-\-adjfile=\fP\fIfichier\fP
.RS 4
Remplacer le chemin de fichier par défaut \fI/etc/adjtime\fP.
.RE
.sp
\fB\-\-date=\fP\fIchaîne_date\fP
.RS 4
Cette option doit être utilisée avec les fonctions \fB\-\-set\fP ou \fB\-\-predict\fP, autrement elle est ignorée.
.sp
\fBhwclock \-\-set \-\-date=\*(Aq16:45\*(Aq\fP
.sp
\fBhwclock \-\-predict \-\-date=\*(Aq2525\-08\-14 07:11:05\*(Aq\fP
.sp
L’argument doit être en heure locale, même si l’horloge matérielle est en UTC. Consultez l’option \fB\-\-localtime\fP. Par conséquent, l’argument ne doit pas comporter d’information de fuseau horaire. Il ne doit pas aussi être en temps relatif, comme par exemple « +5 minutes » car la précision de \fBhwclock\fP dépend de la corrélation entre la valeur de l’argument et le moment où la touche Entrée est pressée. Les secondes fractionnaires sont écartées silencieusement. Cette option peut gérer beaucoup de formats de date et heure, mais les paramètres précédents doivent être respectés.
.RE
.sp
\fB\-\-delay=\fP\fIsecondes\fP
.RS 4
Cette option peut être utilisée pour surcharger le délai utilisé en interne lors du réglage de l’horloge. La valeur par défaut est 0,5s (500 ms) pour rtc_cmos, pour d’autres types d’horloge temps réel le délai est zéro. Si le type d’horloge temps réel est impossible à déterminer (à partir de sysfs), alors la valeur par défaut est 0,5 pour être rétrocompatible.
.sp
The 500ms default is based on commonly used MC146818A\-compatible (x86) hardware clock. This Hardware Clock can only be set to any integer time plus one half second. The integer time is required because there is no interface to set or get a fractional second. The additional half second delay is because the Hardware Clock updates to the following second precisely 500 ms after setting the new time. Unfortunately, this behavior is hardware specific and in some cases another delay is required.
.RE
.sp
\fB\-D\fP, \fB\-\-debug\fP
.RS 4
Utilisation avec \fB\-\-verbose\fP. L’option \fB\-\-debug\fP est obsolète et pourrait être redéfinie ou supprimée dans une publication future.
.RE
.sp
\fB\-\-directisa\fP
.RS 4
Cette option est utile pour les machines compatibles ISA des familles x86 et x86_64. Pour les autres machines, elle n\(cqa pas d\(cqimpact. Cette option indique à \fBhwclock\fP d\(cqutiliser des instructions d’entrée et sortie explicites pour accéder à l’horloge matérielle. Sans cette option, \fBhwclock\fP essaiera d\(cqutiliser le fichier de périphérique rtc, supposé être piloté par le pilote de périphérique RTC. Depuis la version 2.26, \fB\-\-directisa\fP n’est plus automatiquement utilisé quand le pilote rtc n’est pas disponible. Cela provoquait une condition non sécurisée qui pouvait permettre à deux processus d’accéder à l’horloge matérielle en même temps. L’accès direct au matériel depuis l’espace utilisateur ne devrait être utilisé que pour des essais, du dépannage ou en dernier recours après l\(cqéchec de toutes les autres méthodes. Consultez l’option \fB\-\-rtc\fP.
.RE
.sp
\fB\-\-epoch=\fP\fIannée\fP
.RS 4
Cette option est nécessaire lors de l’utilisation de la fonction \fB\-\-setepoch\fP. La valeur minimale de \fIannée\fP est 1900. Celle maximale dépend du système (\fBULONG_MAX\(rs \-\(rs 1\fP).
.RE
.sp
\fB\-f\fP, \fB\-\-rtc=\fP\fIfichier\fP
.RS 4
Remplacer le nom de fichier du périphérique rtc par défaut de \fBhwclock\fP. Sinon, le premier trouvé sera utilisé, dans cet ordre : \fI/dev/rtc0\fP, \fI/dev/rtc\fP, \fI/dev/misc/rtc\fP. Par \fBIA\-64:\fP \fI/dev/efirtc\fP \fI/dev/misc/efirtc\fP
.RE
.sp
\fB\-l\fP, \fB\-\-localtime\fP; \fB\-u\fP, \fB\-\-utc\fP
.RS 4
Indiquer le fuseau horaire utilisé par l’horloge matérielle.
.sp
L’horloge matérielle peut être configurée pour utiliser soit UTC, soit le fuseau horaire local, mais rien n’indique dans l’horloge elle\-même l’alternative utilisée. Les options \fB\-\-localtime\fP et \fB\-\-utc\fP indiquent cela à la commande \fBhwclock\fP. Si vous indiquez la mauvaise information (ou n’en indiquez aucune et que la valeur par défaut est incorrecte), à la fois le réglage et la lecture de l’horloge matérielle seront incorrectes.
.sp
Si vous n\(cqindiquez ni \fB\-\-utc\fP ni \fB\-\-localtime\fP, la valeur utilisée la dernière fois avec une fonction de définition (\fB\-\-set\fP, \fB\-\-systohc\fP ou \fB\-\-adjust\fP), comme sauvegardée dans \fI/etc/adjtime\fP, sera utilisée. Si le fichier d\(cqajustement n\(cqexiste pas, UTC est choisie.
.sp
Remarque : les modifications d’heure d’été peuvent être incohérentes quand l’horloge matérielle est gardée en heure locale. Consultez la discussion ci\-dessous sous \fBLOCALE ou UTC\fP.
.RE
.sp
\fB\-\-noadjfile\fP
.RS 4
Ne pas tenir compte de \fI/etc/adjtime\fP. \fBhwclock\fP ne lira ni n\(cqécrira dans ce fichier. L\(cqoption \fB\-\-utc\fP ou \fB\-\-localtime\fP doit obligatoirement être indiquée avec cette option.
.RE
.sp
\fB\-\-test\fP
.RS 4
Ne pas vraiment faire de modification sur le système, c’est\-à\-dire ni sur les horloges ni sur \fI/etc/adjtime\fP (\fB\-\-verbose\fP> est implicite avec cette option).
.RE
.sp
\fB\-\-update\-drift\fP
.RS 4
Mettre à jour le coefficient de dérive de l’horloge matérielle dans \fI/etc/adjtime\fP. Ce ne peut être utilisé qu’avec \fB\-\-set\fP ou \fB\-\-systohc\fP.
.sp
Une période minimale de quatre heures entre les réglages est nécessaire. Cela permet d’éviter des calculs incorrects. Plus la période est longue, plus le facteur de dérive résultant est précis.
.sp
Cette option a été ajoutée à la version 2.26, parce que les systèmes appellent souvent \fBhwclock\(rs \-\-systohc\fP lors de l’arrêt ; avec l’ancien comportement, cela forçait le (re)calcul du facteur de dérive, avec pour conséquence les problèmes suivants :
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
lors de l’utilisation de NTP avec un noyau en « mode 11 minutes », le facteur de dérive était écrasé par une valeur quasiment nulle ;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
cela ne permettait pas d’utiliser la correction de dérive « à froid ». Avec la plupart des configurations, l’utilisation de la dérive « à froid » donnera des résultats favorables. À froid signifie quand la machine est éteinte, ce qui peut avoir un impact significatif sur le facteur de dérive ;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
le (re)calcul du facteur de dérive à chaque arrêt entraîne des résultats suboptimaux. Par exemple, si des conditions éphémères rendent la machine anormalement chaude, le calcul du facteur de dérive serait hors limites ;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
augmentation significative du temps d’arrêt du système (depuis la version v2.31 lorsque \fB\-\-update\-drift\fP n’est pas utilisé, l’horloge temps réel n’est pas lue).
.RE
.RE
.sp
Laisser \fBhwclock\fP calculer le facteur de dérive est un bon point de départ, mais pour des résultats optimaux, il faudra probablement l’ajuster directement en éditant le fichier \fI/etc/adjtime\fP. Pour la plupart des configurations, une fois qu’un facteur de dérive optimal est mis en place, ce n’est plus la peine de le modifier. Ainsi, le comportement précédent de (re)calculer la dérive a été modifié, et cette option est nécessaire pour la rétablir. Consultez la discussion ci\-dessous dans \fBLa fonction d’ajustement\fP.
.sp
Cette option nécessite de lire l’horloge matérielle avant de la régler. Si elle ne peut être lue, cela conduit à l’échec des fonctions de réglage. Cela peut se produire, par exemple, si l’horloge matérielle est corrompue à cause d’un problème d’alimentation électrique. Dans ce cas, l’horloge doit d’abord être réglée sans cette option. Bien qu’il ne soit pas en fonctionnement, le facteur de correction de dérive ne serait pas valable de toute façon.
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Afficher plus de détails sur ce que réalise \fBhwclock\fP en interne.
.RE
.SH "NOTES"
.SS "Horloges dans un système Linux"
.sp
Deux types d’horloge existent.
.sp
\fBThe Hardware Clock:\fP This clock is an independent hardware device, with its own power domain (battery, capacitor, etc), that operates when the machine is powered off, or even unplugged.
.sp
Sur un système compatible ISA, l’horloge est définie dans la norme ISA. Un programme de contrôle ne peut lire ou ajuster l’heure qu’à la seconde, mais il peut également détecter les pentes des tics de seconde de l’horloge, de ce fait, l’horloge a virtuellement une précision infinie.
.sp
Cette horloge est communément appelée l’horloge matérielle (« hardware clock »), l’horloge temps réel, le RTC, l’horloge BIOS ou l’horloge CMOS. La désignation horloge matérielle a été inventée pour être utilisée avec \fBhwclock\fP. Le noyau Linux y fait référence sous le nom d’horloge persistante.
.sp
Certains systèmes non ISA ont plusieurs horloges temps réel, mais une seule avec sa propre source d\(cqénergie. Un composant externe, sur I2C ou SPI, consommant très peu, peut être utilisé avec une batterie de secours comme horloge matérielle afin d’initialiser une horloge temps réel intégrée plus fonctionnelle, utilisée pour la plupart des autres objectifs.
.sp
\fBThe System Clock:\fP This clock is part of the Linux kernel and is driven by a timer interrupt. (On an ISA machine, the timer interrupt is part of the ISA standard.) It has meaning only while Linux is running on the machine. The System Time is the number of seconds since 00:00:00 January 1, 1970 UTC (or more succinctly, the number of seconds since 1969 UTC). The System Time is not an integer, though. It has virtually infinite precision.
.sp
L’horloge système donne l’heure importante. Le but essentiel de l’horloge matérielle est de garder l’heure lorsque Linux ne fonctionne pas afin de pourvoir initialiser l’heure système au démarrage. Remarquez qu\(cqavec DOS, pour qui ISA a été conçu, l’horloge matérielle est la seule horloge temps réel.
.sp
L’heure système ne doit surtout pas subir de discontinuité comme lorsque le programme \fBdate\fP(1) est utilisé pour la modifier pendant le fonctionnement du système. Vous pouvez, cependant, faire tout ce que vous voulez sur l’horloge matérielle pendant le fonctionnement, la prochaine fois que Linux démarrera, il prendra en compte la nouvelle heure de l’horloge matérielle. Remarque : ce n’est actuellement pas possible sur la plupart des systèmes car \fBhwclock \-\-systohc\fP est appelée lors de l’arrêt.
.sp
Le fuseau horaire du noyau Linux est défini par \fBhwclock\fP. Cependant, ne vous trompez pas — pratiquement personne ne se préoccupe du fuseau horaire maintenu par le noyau. Les programmes devant utiliser le fuseau horaire (par exemple pour afficher l’heure locale) utilisent presque toujours une méthode plus traditionnelle afin de le déterminer. Ils utilisent la variable d\(cqenvironnement \fBTZ\fP ou le fichier \fI/etc/localtime\fP, comme expliqué dans la page de manuel de \fBtzset\fP(3). Cependant, certains programmes et certaines parties du noyau Linux comme les systèmes de fichiers utilisent la valeur de fuseau horaire du noyau. Un exemple est le système de fichiers vfat. Si la valeur dans le noyau est fausse, le système de fichiers vfat lira et modifiera d\(cqune manière erronée la date des fichiers. Un autre exemple est le « mode 11 minutes » de NTP du noyau. Si la valeur de fuseau horaire du noyau ou que la variable \fIpersistent_clock_is_local\fP sont fausses, l’horloge matérielle ne sera pas réglée correctement par le « mode 11 minutes ». Consultez la discussion ci\-dessous, sous \fBSynchronisation automatique de l’horloge matérielle par le noyau\fP.
.sp
\fBhwclock\fP sets the kernel\(cqs timezone to the value indicated by \fBTZ\fP or \fI/etc/localtime\fP with the \fB\-\-hctosys\fP or \fB\-\-systz\fP functions.
.sp
Le fuseau horaire du noyau est composé de deux parties : 1) un champ tz_minuteswest indiquant le nombre de minutes (non ajusté pour l’heure d\(cqété) de retard par rapport au temps universel (UTC) ; 2) un champ tz_dsttime indiquant le type de convention d’heure d’été utilisé localement à l’heure actuelle. Ce second champ n\(cqest jamais utilisé sous Linux et est toujours nul. Consultez également \fBsettimeofday\fP(2).
.SS "Méthodes d’accès à l’horloge matérielle"
.sp
\fBhwclock\fP uses many different ways to get and set Hardware Clock values. The most normal way is to do I/O to the rtc device special file, which is presumed to be driven by the rtc device driver. Also, Linux systems using the rtc framework with udev, are capable of supporting multiple Hardware Clocks. This may bring about the need to override the default rtc device by specifying one with the \fB\-\-rtc\fP option.
.sp
Cependant, cette méthode n’est pas toujours disponible sur les anciens systèmes ne disposant pas de pilote rtc. Sur ces systèmes, la méthode d\(cqaccès à l’horloge matérielle dépend de la machine.
.sp
Sur un système compatible ISA, \fBhwclock\fP peut accéder directement aux registres de la mémoire du CMOS qui constituent l’horloge, en effectuant des opérations d\(cqE/S sur les ports 0x70 et 0x71. \fBhwclock\fP effectue cela avec de véritables instructions d\(cqE/S et doit donc être exécuté avec des droits de superutilisateur. Cette méthode peut être utilisée en indiquant l’option \fB\-\-directisa\fP.
.sp
C\(cqest vraiment une mauvaise méthode pour accéder à l’horloge, notamment parce que les programmes de l\(cqespace utilisateur ne sont généralement pas supposés effectuer directement des opérations d\(cqE/S et désactiver les interruptions. \fBhwclock\fP fournit cette méthode pour permettre de faire des essais ou du dépannage et parce que cela pourrait être la seule méthode disponible sur les systèmes compatibles ISA ne disposant pas d’un pilote fonctionnel de périphérique rtc.
.SS "La fonction d’ajustement"
.sp
L’horloge matérielle n\(cqest généralement pas très précise. Cependant, la plupart de ces imprécisions sont prévisibles. Elle gagne ou perd la même durée chaque jour. C’est la dérive systématique. La fonction \fB\-\-adjust\fP de \fBhwclock\fP permet d’appliquer des corrections de dérive systématique à l’horloge matérielle.
.sp
Cela fonctionne de la façon suivante : \fBhwclock\fP utilise un fichier, \fI/etc/adjtime\fP, qui conserve des informations historiques. C’est le fichier d\(cqajustement (\fIadjtime\fP).
.sp
Supposons un démarrage sans fichier d\(cqajustement. La commande \fBhwclock \-\-set\fP règle l’horloge matérielle à l’heure actuelle. \fBhwclock\fP crée le fichier d’ajustement et y sauvegarde l’heure actuelle en tant que dernier moment d’étalonnage. Cinq jours plus tard, l’horloge a gagné 10 secondes, la commande \fBhwclock \-\-set \-\-update\-drift\fP corrige alors l’heure. \fBhwclock\fP met à jour le fichier d\(cqajustement avec l’heure actuelle en tant que dernier moment d’étalonnage, et enregistre une dérive systématique de 2 secondes par jour. Au bout de 24 heures, avec la commande \fBhwclock \-\-adjust\fP, \fBhwclock\fP consulte le fichier d\(cqajustement et remarque que l’horloge gagne deux secondes par jour lorsque rien n\(cqest fait et que rien n\(cqa été fait pendant un jour. Par conséquent, 2 secondes sont enlevées de l’horloge matérielle. L’heure actuelle est alors enregistrée en tant que dernier moment d’étalonnage. 24 heures après, la commande \fBhwclock \-\-adjust\fP effectuera exactement la même opération.
.sp
Quand l’option \fB\-\-update\-drift\fP est utilisée avec \fB\-\-set\fP ou \fB\-\-systohc\fP, le taux de dérive systématique est (re)calculé en comparant l’heure matérielle actuelle avec correction de dérive à la nouvelle heure de réglage. En est déduit le taux de dérive sur 24 heures à partir du dernier horodatage de calibration du fichier d’ajustement. Ce facteur de dérive mis à jour est sauvé dans \fI/etc/adjtime\fP.
.sp
Une petite erreur est introduite quand l’horloge matérielle est définie, de telle sorte que \fB\-\-adjust\fP évite de faire un ajustement de moins d\(cqune seconde. Plus tard, lors d’une redemande d’ajustement, la dérive accumulée sera supérieure à une seconde et \fB\-\-adjust\fP fera l\(cqajustement même de toute partie infime.
.sp
\fBhwclock \-\-hctosys\fP also uses the adjtime file data to compensate the value read from the Hardware Clock before using it to set the System Clock. It does not share the 1 second limitation of \fB\-\-adjust\fP, and will correct sub\-second drift values immediately. It does not change the Hardware Clock time nor the adjtime file. This may eliminate the need to use \fB\-\-adjust\fP, unless something else on the system needs the Hardware Clock to be compensated.
.SS "Le fichier d\(cqajustement"
.sp
Même s’il garde ce nom pour des raisons historiques, il contient en fait d\(cqautres informations utilisées par \fBhwclock\fP d’un appel à l\(cqautre.
.sp
Le format du fichier d\(cqajustement, en ASCII, est le suivant :
.sp
Ligne 1 : trois nombres, séparés par des espaces : 1) le taux de dérive systématique en seconde par jour, nombre décimal flottant ; 2) le nombre de secondes écoulées entre 1969 UTC et la date du dernier étalonnage, entier décimal ; 3) zéro (pour une compatibilité avec \fBclock\fP(8)) en tant que nombre décimal flottant.
.sp
Ligne 2 : un nombre : le nombre de secondes écoulées entre 1969 UTC et le dernier étalonnage. Zéro s\(cqil n\(cqy a pas eu d\(cqétalonnage ou si un des derniers étalonnages est discutable (par exemple, si l’horloge matérielle, depuis cet étalonnage, est erronée). C\(cqest un entier décimal.
.sp
Ligne 3 : « UTC » ou « LOCAL ». Indique si l’horloge matérielle est à l’heure universelle ou à l’heure locale. Vous pouvez toujours surcharger cette valeur par des options sur la ligne de commande de \fBhwclock\fP.
.sp
Vous pouvez utiliser un fichier d\(cqajustement précédemment utilisé avec le programme \fBclock\fP(8) avec \fBhwclock\fP.
.SS "Synchronisation automatique de l’horloge matérielle par le noyau"
.sp
Vous devez être au courant d\(cqun autre moyen utilisé pour garder l’horloge matérielle synchronisée sur certains systèmes. Le noyau Linux possède un mode qui copie l’heure système vers l’horloge matérielle toutes les 11 minutes. Ce mode est une option au moment de la compilation, aussi tous les noyaux n’ont pas cette possibilité. Il est pratique de l’utiliser quand un moyen sophistiqué comme NTP garde l’heure système à jour (NTP est un moyen de synchroniser l’heure système avec soit un serveur de temps situé quelque part sur le réseau, soit une horloge radio en duplex avec le système, consultez la RFC 1305).
.sp
Si le noyau est compilé avec l’option « mode 11 minutes », il sera actif quand la discipline de l’horloge du noyau est dans l’état synchronisé. Dans cet état, le bit 6 (le bit réglé dans le masque 0x0040) de la variable \fItime_status\fP du noyau n’est pas défini. Cette valeur est produite comme ligne « status » des commandes \fBadjtimex\(rs \-\-print\fP ou \fBntptime\fP.
.sp
Il agit de manière externe, comme le démon NTP pour mettre la discipline de l\(cqhorloge du noyau dans l’état synchronisé et, par conséquent, active le « mode 11 minutes ». Il peut être désactivé en exécutant n\(cqimporte quelle commande, y compris \fBhwclock \-\-hctosys\fP qui ajuste l’horloge système de manière classique. Cependant, si le démon NTP est toujours actif, il réactivera le « mode 11 minutes » la prochaine fois qu’il synchronisera l’horloge système.
.sp
Si le « mode 11 minutes » est activé sur le système, l’utilisation de \fB\-\-hctosys\fP ou \fB\-\-systz\fP risque d’être nécessaire dans un script de démarrage, en particulier si l’horloge matérielle est configurée pour utiliser le fuseau horaire local. À moins que le noyau ne soit informé du fuseau horaire utilisé par l’horloge matérielle, il risque de l’écraser avec une heure incorrecte. Le noyau utilise UTC par défaut.
.sp
La première commande en espace utilisateur pour définir l’horloge système informe le noyau du fuseau horaire utilisé par l’horloge matérielle. Cela ce fait par l’intermédiaire de la variable \fIpersistent_clock_is_local\fP du noyau. Si \fB\-\-hctosys\fP ou \fB\-\-systz\fP sont utilisées en premier, cette variable sera définie d’après le fichier d’ajustement ou l’argument approprié en ligne de commande. Remarquez que lorsque cette capacité est utilisée et que le fuseau horaire de l’horloge matérielle est modifié, un redémarrage est nécessaire pour informer le noyau.
.sp
\fBhwclock \-\-adjust\fP should not be used with NTP \*(Aq11 minute mode\*(Aq.
.SS "Valeur du siècle de l’horloge matérielle ISA"
.sp
Une sorte de norme définit l’octet 50 de la mémoire du CMOS sur une machine ISA comme un indicateur du siècle. \fBhwclock\fP ne l\(cqutilise ni le modifie car certaines machines ne définissent pas l\(cqoctet de cette manière, et ce n\(cqest vraiment pas nécessaire puisque l\(cqannée du siècle constitue un bon moyen de connaître le siècle.
.sp
Si vous pensez à un usage possible de l\(cqoctet du siècle CMOS (« CMOS century byte »), contactez le responsable de \fBhwclock\fP, une option peut être adéquate.
.sp
Notez que cette section est pertinente uniquement si vous utilisez un accès ISA direct à l’horloge matérielle. L\(cqACPI fournit un moyen standard d\(cqaccéder au siècle quand le matériel le gère.
.SH "CONFIGURATION DE DATE ET HEURE"
.SS "Garder l’heure sans synchronisation externe"
.sp
Cette discussion est basée sur les conditions suivantes.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Rien de ce qui fonctionne n’altère les date et heure des horloges, par exemple un démon NTP ou une tâche régulière (cron).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Le fuseau horaire du système est configuré pour l\(cqheure locale correcte. Consultez \fBPOSIX ou « RIGHT »\fP ci dessous.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Rapidement lors du démarrage, les commandes suivantes sont appelées dans cet ordre : \fBadjtimex \-\-tick\fP \fIvalor\fP \fB\-\-frequency\fP \fIvalor\fP \fBhwclock \-\-hctosys\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Pendant l’arrêt, la commande suivante est appelée : \fBhwclock \-\-systohc\fP
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Les systèmes sans \fBadjtimex\fP peuvent utiliser \fBntptime\fP.
.RE
.RE
.sp
Que la précision de l’heure soit maintenue avec le démon NTP ou pas, configurer le système pour qu’il reste à l’heure par lui\-même est utile.
.sp
La première étape pour réaliser cela est d’avoir une vision d’ensemble claire. Deux périphériques matériels indépendants fonctionnent à leur propre rythme et divergent de l’heure « correcte » à leur propre taux. Les méthodes et programmes pour la correction de dérive sont différents pour chaque périphérique. Cependant, la plupart des systèmes sont configurés pour échanger des valeurs entre ces deux horloges au démarrage et à l’arrêt. Désormais les heures de chaque périphérique, avec leurs propres erreurs, sont donc transférées de l’une à l’autre dans les deux sens. Si vous tentez de configurer une correction de dérive pour une seule d’entre elles, la dérive de l’autre l’écrasera.
.sp
Ce problème peut être évité en configurant la correction de dérive pour l’horloge système et en évitant simplement d’arrêter la machine. Cela, avec le fait que toute la précision de \fBhwclock\fP (y compris le calcul des facteurs de dérive) dépend de l’exactitude de la fréquence de l’horloge système, signifie que la configuration de l’horloge système devrait être la première étape.
.sp
La dérive de l’horloge système est corrigée avec les options \fB\-\-tick\fP et \fB\-\-frequency\fP d’\fBadjtimex\fP(8). Les deux fonctionnent ensemble, le tic est l’ajustement grossier alors que la fréquence est l’ajustement fin (sur les systèmes sans paquet \fBadjtimex\fP, \fBntptime\(rs \-f\fP \fIppm\fP peut être utilisé à la place).
.sp
Certaines distributions Linux essayent de calculer automatiquement la dérive de l’horloge système avec l’opération de comparaison d’\fBadjtimex\fP. Essayer de corriger une horloge qui dérive en utilisant comme référence une autre horloge qui dérive est un peu comme un chien qui essaye de s’attraper la queue. Cela peut fonctionner au bout d’un moment mais pas sans beaucoup d’efforts et de frustration. Cette automatisme peut être considéré comme une amélioration face à l’absence de configuration, mais espérer un résultat optimal serait une erreur. Les options \fB\-\-log\fP d’\fBadjtimex\fP s’avèrent être une meilleure possibilité pour une configuration manuelle.
.sp
Simplement suivre la dérive de l’horloge système avec \fBsntp\fP, ou \fBdate\(rs \-Ins\fP par rapport à une horloge de précision, puis calculer soi\-même la correction, serait plus efficace.
.sp
Après la définition des valeurs de tic et de fréquence, il faut continuer de tester et d\(cqaffiner les ajustements jusqu’à ce que l’horloge système garde l’heure correctement. Consultez \fBadjtimex\fP(2) pour plus de renseignements et l’exemple montrant un calcul manuel de dérive.
.sp
Une fois que l’horloge système est fiable, l’horloge matérielle va pouvoir être réglée.
.sp
En règle générale, la dérive à froid fonctionne bien dans la plupart des cas d’utilisation. Cela devrait même être vrai pour les machines fonctionnant vingt\-quatre heures sur vingt\-quatre et dont les temps d’arrêt usuels servent uniquement pour les redémarrages. Dans ce cas, la valeur du facteur de dérive est peu différente, mais si la machine est arrêtée plus longtemps que d’habitude, la dérive à froid devrait donner de meilleurs résultats.
.sp
\fBSteps to calculate cold drift:\fP
.sp
1
.RS 4
\fBEnsure that NTP daemon will not be launched at startup.\fP
.RE
.sp
2
.RS 4
L’heure de \fIl’horloge système\fP doit être exacte à l’arrêt !.
.RE
.sp
3
.RS 4
Arrêter le système.
.RE
.sp
4
.RS 4
Laisser passer suffisamment de temps sans modifier l’horloge matérielle.
.RE
.sp
5
.RS 4
Démarrer le système.
.RE
.sp
6
.RS 4
Utiliser \fBhwclock\fP immédiatement pour régler l’heure correcte avec l’option \fB\-\-update\-drift\fP.
.RE
.sp
Remarque : si l’étape six utilise \fB\-\-systohc\fP, alors l’horloge système doit être réglée correctement (étape 6a) juste avant.
.sp
Laisser \fBhwclock\fP calculer le facteur de dérive est un bon point de départ, mais pour obtenir des résultats optimaux, modifier directement le fichier \fI/etc/adjtime\fP sera probablement nécessaire. Continuer de tester et affiner les ajustements jusqu’à ce que l’horloge matérielle soit corrigée correctement au démarrage. Pour vérifier cela, assurez\-vous que l’heure système soit correcte avant l’arrêt puis utilisez \fBsntp\fP, ou \fBdate\(rs \-Ins\fP et une horloge de précision, immédiatement après le démarrage.
.SS "LOCALE ou UTC"
.sp
Garder l’horloge matérielle en heure locale provoque des résultats incohérents de changement d’heure d’été.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Si Linux est en cours de fonctionnement au moment du changement d’heure, l’heure écrite dans l’horloge matérielle sera ajustée pour le changement.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Si Linux n’est \fBpas\fP en cours de fonctionnement au moment du changement d’heure, l’heure lue de l’horloge matérielle ne sera \fBpas\fP ajustée pour le changement.
.RE
.sp
L’horloge matérielle sur un système compatible ISA ne garde que l’heure et la date, elle n’a pas de connaissance du fuseau horaire ni d’heure d’été. Ainsi, quand \fBhwclock\fP est informée d’utiliser l’heure locale, elle considère l’horloge matérielle en heure locale « correcte » et ne fait pas d’ajustement de l’heure qui y est lue.
.sp
Linux ne gère les changements d’heure d’été de façon transparente que quand l’horloge matérielle est gardée en UTC. Ce fonctionnement facilite le travail des administrateurs système car \fBhwclock\fP utilise l’heure locale en sortie et comme argument de l’option \fB\-\-date\fP.
.sp
Les systèmes POSIX, comme Linux, sont conçus pour avoir l’horloge système en heure UTC. Le but de l’horloge matérielle est d’initialiser l’horloge système, donc la garder aussi en UTC est sensé.
.sp
Linux, cependant, essaye de s’adapter à l’horloge matérielle en heure locale. C’est avant tout pour gérer le multiboot avec les plus anciennes versions de Microsoft Windows. Depuis Windows 7, la clef de registre RealTimeIsUniversal est supposée fonctionner correctement pour permettre de garder l’horloge matérielle en UTC.
.SS "POSIX ou « RIGHT »"
.sp
Une discussion sur la configuration de date et d’heure serait incomplète sans parler de fuseaux horaires, c’est assez bien couvert par \fBtzset\fP(3). Une zone qui semble non documentée est le répertoire \fIright\fP de la base de données de fuseaux horaires, parfois appelé « tz » ou « zoneinfo ».
.sp
Deux bases de données distinctes existent dans le système \fIzoneinfo\fP : \fIposix\fP et \fIright\fP. Le répertoire \fIright\fP (maintenant appelé \fIzoneinfo\-leaps\fP, secondes intercalaires de \fIzoneinfo>) contient les secondes intercalaires alors que _posix\fP ne les contient pas. Pour utiliser la base de données \fIright\fP, l’horloge système doit être configurée en (UTC + secondes intercalaires), ce qui est équivalent à (TAI − 10). Cela permet de calculer le nombre exact de secondes entre deux dates ayant une seconde intercalaire entre elles. L’horloge système est alors convertie en heure civile correcte, y compris UTC, en utilisant les fichiers de fuseau horaire \fIright\fP qui soustraient les secondes intercalaires. Remarque : cette configuration est considérée expérimentale et est connue pour poser des problèmes.
.sp
Pour configurer un système à utiliser une base de données en particulier, tous les fichiers de son répertoire doivent être copiés à la racine de \fI/usr/share/zoneinfo\fP. Les fichiers ne sont jamais utilisés directement des sous\-répertoires \fIposix\fP ou \fIright\fP, par exemple TZ=\*(Aq\fIright/America/Martinique\fP\*(Aq. Cette habitude était devenue si répandue que le projet zoneinfo amont a restructuré le système d’arborescence de fichiers en déplaçant les sous\-répertoires \fIposix\fP et \fIright\fP hors du répertoire \fIzoneinfo\fP et dans des répertoires adjacents :
.sp
\fI/usr/share/zoneinfo\fP, \fI/usr/share/zoneinfo\-posix\fP, \fI/usr/share/zoneinfo\-leaps\fP
.sp
Malheureusement, certaines distributions Linux replacent l’arborescence comme précédemment dans leurs paquets. Ainsi, le problème des administrateurs système utilisant directement le répertoire \fIright\fP persiste. À cause de cela, le fuseau horaire du système est configuré pour inclure les secondes intercalaires alors que la base de données de zoneinfo est encore configurée pour les exclure. Pourtant, quand une application comme une horloge mondiale, un agent de transport de courrier (MTA) ou \fBhwclock\fP a besoin du fichier de fuseau horaire \fISouth_Pole\fP, elle le prend à la racine du \fI/usr/share/zoneinfo\fP, puisque c’est ce qu’elle est censée faire. Ces fichiers excluent les secondes intercalaires, mais l’horloge système les inclut maintenant, avec pour conséquence une conversion d’heure incorrecte.
.sp
Tenter de mélanger et de faire correspondre les fichiers de ces bases de données distinctes ne fonctionnera pas puisqu’elles nécessitent chacune que l’horloge système utilise un fuseau horaire différent. La base de données zoneinfo doit être configurée pour utiliser soit \fIposix\fP, soit \fIright\fP, conformément à la description précédente ou en assignant un chemin de base de données à la variable \fITZDIR\fP.
.SH "CODE DE RETOUR"
.sp
Une des valeurs suivantes sera renvoyée.
.sp
\fBEXIT_SUCCESS\fP (\fB0\fP sur les systèmes POSIX)
.RS 4
Exécution du programme réussie.
.RE
.sp
\fBEXIT_FAILURE\fP (\fB1\fP sur les systèmes POSIX)
.RS 4
L’opération a échoué ou la syntaxe de la commande était inadéquate.
.RE
.SH "ENVIRONNEMENT"
.sp
\fBTZ\fP
.RS 4
Si cette variable est définie, sa valeur prend le pas sur la valeur de fuseau horaire configurée sur le système.
.RE
.sp
\fBTZDIR\fP
.RS 4
Si cette variable est définie, sa valeur prend le pas sur le chemin du répertoire de base de données des fuseaux horaires configuré sur le système.
.RE
.SH "FICHIERS"
.sp
\fI/etc/adjtime\fP
.RS 4
The configuration and state file for \fBhwclock\fP. See also \fBadjtime_config\fP(5).
.RE
.sp
\fI/etc/localtime\fP
.RS 4
Fichier de fuseau horaire du système
.RE
.sp
\fI/usr/share/zoneinfo/\fP
.RS 4
Répertoire de la base de données de fuseaux horaires du système.
.RE
.sp
Fichiers de périphérique pouvant être essayés par \fBhwclock\fP pour un accès à l’horloge matérielle : \fI/dev/rtc0\fP \fI/dev/rtc\fP \fI/dev/misc/rtc\fP \fI/dev/efirtc\fP \fI/dev/misc/efirtc\fP
.SH "VOIR AUSSI"
.sp
\fBdate\fP(1),
\fBadjtime_config\fP(5),
\fBadjtimex\fP(8),
\fBgettimeofday\fP(2),
\fBsettimeofday\fP(2),
\fBcrontab\fP(1p),
\fBtzset\fP(3)
.SH "AUTEURS"
.sp
Écrit par \c
.MTO "bryanh\(atgiraffe\-data.com" "Bryan Henderson" ","
septembre 1996, basé sur le travail effectué sur le programme \fBclock\fP(8) par Charles Hedrick, Rob Hooft et Harald Koenig. Veuillez vous référer au code source pour une histoire complète et les crédits.
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBhwclock\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."