Provided by:
manpages-fr_3.27fr1.4-1_all 
NOM
tzfile - Informations de zone horaire.
SYNOPSIS
#include <tzfile.h>
DESCRIPTION
Cette page de manuel decrit 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 utilises par tzset(3)
commencent par les caracteres magiques << TZif >> pour les identifier
en tant que fichiers d'informations de zone horaire (Time Zone
information file). Ces caracteres sont suivis d'un caractere permettant
d'identifier le format du fichier (en 2005, les seuls caracteres
autorises sont l'ASCII NUL << \0 >> et le '2'), suivis de 15 octets
contenant des zeros et reserves pour un usage futur, suivis de six
valeurs sur 4 octets de type long, ecrites dans l'ordre << standard >>
(big endian, le bit de poids fort en premier). Ces valeurs sont, dans
l'ordre :
tzh_ttisgmtcnt
Nombre d'indicateurs UTC/local enregistres dans le fichier.
tzh_ttisstdcnt
Nombre d'indicateurs standard/locale enregistres dans le
fichier.
tzh_leapcnt
Nombre de secondes de rattrapage pour lesquelles des donnees
sont enregistrees dans le fichier.
tzh_timecnt
Nombre d'<< instants de transition >> pour lesquels des donnees
sont enregistrees dans le fichier.
tzh_typecnt
Le nombre de << types d'heures locales >> pour lesquelles des
donnees sont enregistrees dans le fichier (ne doit pas etre
nul).
tzh_charcnt
Nombre de caracteres de << chaines d'abreviation de zone
horaire >> enregistrees dans le fichier.
L'en-tete ci-dessus est suivi par les valeurs tzh_timecnt sur 4 octets
de type long, triees par ordre croissant. Ces valeurs sont ecrites dans
l'ordre << standard >> des octets. Chacune est utilisee comme un
instant de transition (tel que renvoye par l'appel systeme time(2))
auquel les regles de calcul de l'heure locale changent. Ensuite,
viennent les valeur tzh_timecnt sur un octet de type unsigned char ;
chacune indiquant lequel des differents types << d'heure locale >>
decrits dans le fichier est associe avec l'instant de transition de
meme rang. Ces valeurs servent d'indice dans une table de structures
ttinfo (avec des entrees tzh_typecnt) qui apparaissent ensuite dans le
fichier. Ces structures sont definies ainsi :
struct ttinfo {
long tt_gmtoff;
int tt_isdst;
unsigned int tt_abbrind;
};
Chaque structure est ecrite 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 a ajouter a UTC, tt_isdst indique que tm_isdst doit etre
definie par localtime(3) et que tt_abbrind sert d'index dans la table
des caracteres d'abreviation de la zone horaire qui suit les structures
ttinfo dans le fichier.
Viennent ensuite tzh_leapcnt paires de valeurs 4 octets, ecrites dans
l'ordre standard des octets. La premiere valeur de chaque paire donne
l'instant (comme fourni par time(2)) auquel s'insere une seconde de
rattrapage. La seconde indique le nombre total de secondes de
rattrapage a inserer apres l'instant donne. Ces paires sont classees en
ordre croissant de temps.
Ensuite se trouvent tzh_ttisstdcnt indicateurs standard/locale, chacun
enregistre sur un octet. Ils indiquent si les instants de transition
associes aux types d'heures locales ont ete specifies en heure standard
ou locale, et servent lorsqu'un fichier de zone horaire permet de
manipuler des variables d'environnement de zone horaire a la maniere
POSIX.
Finalement se trouvent tzh_ttisgmtcnt indicateurs UTC/local, chacun
enregistre sur un octet. Ils indiquent si les instants de transition
associes aux types d'heures locales ont ete specifies en heure UTC ou
locale, et servent lorsqu'un fichier de fuseau horaire permet de
manipuler des variables d'environnement de zone horaire a la maniere
POSIX.
Localtime(3) utilise la premiere structure ttinfo en heure standard du
fichier (ou simplement la premiere structure ttinfo s'il n'y en a pas
en heure standard), si tzh_timecnt est nul, ou si son parametre horaire
est anterieur a la premiere transition enregistree dans le fichier.
NOTES
Cette page de manuel decrit <tzfile.h> de l'archive source de glibc,
voir timezone/tzfile.h.
Il semble que timezone utilise tzfile de maniere interne, mais glibc
refuse de le rendre visible depuis l'espace utilisateur. Ceci
probablement parce que les fonctions standardisees sont plus utiles et
portables, et de fait documente par glibc. Il se peut qu'elle ne se
trouve dans glibc que pour gerer les donnees de timezone qui sont
maintenue hors de glibc (qui est maintenue par une autre entite).
VOIR AUSSI
time(3), gettimeofday(3), tzset(3), ctime(3)
Pour les fichiers de fuseau horaire dans le format 2, l'en-tete et les
donnees ci-dessus sont suivies d'un second en-tete et donnees,
identiques en format sauf que 8 octets sont utilises pour chaque
transition ou secondes de rattrapage. Apres le deuxieme en-tete et
donnees, arrive une chaine, du meme type que la variable
d'environnement POSIX TZ, entouree de sauts de lignes. Cette chaine est
utilisee pour gerer les instants apres la derniere transition stockee
dans le fichier (avec rien entre les sauts de lignes s'il n'existe pas
de representation POSIX pour de tels instants).
VOIR AUSSI
ctime(3)
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). Jean-Luc
Coulon 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> >>.
31 aout 2010 TZFILE(5)