NOM
tzfile - Informations de zone horaire.
SYNOPSIS
#include <tzfile.h>
Cette page de manuel décrit la structure des fichiers de zone horaire
tels qu’on les trouve couramment dans /usr/lib/zoneinfo ou
/usr/share/zoneinfo
Les fichiers d’informations de zone horaire utilisés par tzset(3)
commencent par les caractères magiques « TZif » pour les identifier en
tant que fichiers d’informations de zone horaire (Time Zone information
file). Ces caractères sont suivis de 16 octets réservés pour une
utilisation future, suivis de 6 valeurs sur 4 octets de type long,
écrites dans l’ordre « standard » des octets (poids fort en premier).
Ces valeurs sont, dans l’ordre :
tzh_ttisgmtcnt
Nombre d’indicateurs UTC/local enregistrés dans le fichier.
tzh_ttisstdcnt
Nombre d’indicateurs standard/locale enregistrés dans le
fichier.
tzh_leapcnt
Nombre de secondes de rattrapage pour lesquelles des données
sont enregistrées dans le fichier.
tzh_timecnt
Nombre d’« instants de transition » pour lesquels des données
sont enregistrées dans le fichier.
tzh_typecnt
Le nombre de « types d’heures locales » pour lesquelles des
données sont enregistrées dans le fichier (ne doit pas être
nul).
tzh_charcnt
Nombre de caractères de « chaînes d’abréviation de zone
horaire » enregistrées dans le fichier.
L’en-tête ci-dessus est suivi par les valeurs tzh_timecnt sur 4 octets
de type long, triées par ordre croissant. Ces valeurs sont écrites dans
l’ordre « standard » des octets. Chacune est utilisée comme un instant
de transition (tel que renvoyé par l’appel système time(2)) auquel les
règles de calcul de l’heure locale changent. Ensuite, viennent les
valeur tzh_timecnt sur un octet de type unsigned char ; chacune
indiquant lequel des différents types « d’heure locale » décrits dans
le fichier est associé avec l’instant de transition de même rang. Ces
valeurs servent d’indice dans une table de structures ttinfo qui
apparaissent ensuite dans le fichier. Ces structures sont définies
ainsi :
struct ttinfo {
long tt_gmtoff;
int tt_isdst;
unsigned int tt_abbrind;
};
Chaque structure est écrite sous forme d’une valeur de 4 octets, du
type long, dans l’ordre standard des octets pour tt_gmtoff, suivie
d’une valeur sur 1 octet pour tt_isdst et d’une valeur sur 1 octet pour
tt_abbrind. Dans chaque structure, tt_gmtoff indique le nombre de
secondes à ajouter à UTC, tt_isdst indique que tm_isdst doit être
définie par localtime(3) et que tt_abbrind sert d’index dans la table
des caractères d’abréviation de la zone horaire qui suit les structures
ttinfo dans le fichier.
Viennent ensuite tzh_leapcnt paires de valeurs 4 octets, écrites dans
l’ordre standard des octets. La première valeur de chaque paire donne
l’instant (comme fourni par time(2)) auquel s’insère une seconde de
rattrapage. La seconde indique le nombre total de secondes de
rattrapage à insérer après l’instant donné. Ces paires sont classées en
ordre croissant de temps.
Ensuite se trouvent tzh_ttisstdcnt indicateurs standard/locale, chacun
enregistré sur un octet. Ils indiquent si les instants de transition
associés aux types d’heures locales ont été spécifiés en heure standard
ou locale, et servent lorsqu’un fichier de zone horaire permet de
manipuler des variables d’environnement de zone horaire à la manière
POSIX.
Finalement se trouvent tzh_ttisgmtcnt indicateurs UTC/local, chacun
enregistré sur un octet. Ils indiquent si les instants de transition
associés aux types d’heures locales ont été spécifiés en heure UTC ou
locale, et servent lorsqu’un fichier de fuseau horaire permet de
manipuler des variables d’environnement de zone horaire à la manière
POSIX.
Localtime utilise la première structure ttinfo en heure standard du
fichier (ou simplement la première structure ttinfo s’il n’y en a pas
en heure standard), si tzh_timecnt est nul, ou si son paramètre horaire
est antérieur à la première transition enregistrée dans le fichier.
NOTES
Cette page de manuel décrit <tzfile.h> de l’archive source de glibc,
voir timezone/tzfile.h.
Il semble que timezone utilise tzfile de manière interne, mais glibc
refuse de le rendre visible depuis l’espace utilisateur. Ceci
probablement parce que les fonctions standardisées sont plus utiles et
portables, et de fait documenté par glibc. Il se peut qu’elle ne se
trouve dans glibc que pour gérer les données de timezone qui sont
maintenue hors de glibc (qui est maintenue par une autre entité).
VOIR AUSSI
time(3), gettimeofday(3), tzset(3), ctime(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Jean-Luc Coulon (f5ibh)
<jean-luc.coulon@wanadoo.fr> et l’équipe francophone de traduction de
Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
5 juin 1996