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

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)