1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
.\" Traduction 11/05/1999 par Christophe Blaess (ccb@club-internet.fr)
.\" LDP-man-pages 1.23
.TH TZFILE 5 "11 Mai 1999" Linux "Manuel de l'administrateur Linux"
.SH NOM
tzfile \- Information de fuseau horaire.
.SH SYNOPSIS
.B
#include <tzfile.h>
.SH DESCRIPTION
Les fichiers d'information de fuseau horaire utiliss par
.IR tzset (3)
commencent par les caractres magiques "TZif" pour les identifier
(Time Zone information file).
Ces caractres sont suivis de 16 octets rservs pour une utilisation
future, suivis de 6 valeurs sur 4 octets de type
.BR long ,
crites dans l'ordre standard des octets (poids fort en premier)
Ces valeurs sont, dans l'ordre :
.TP
.I tzh_ttisgmtcnt
Le nombre d'indicateurs UTC/local enregistrs dans le fichier.
.TP
.I tzh_ttisstdcnt
Le nombre d'indicateurs standard/wall enregistrs dans le fichier.
.TP
.I tzh_leapcnt
Le nombre de secondes de rattrapage pour lesquelles des donnes sont
enregistres dans le fichier.
.TP
.I tzh_timecnt
Le nombre d'instants de transition pour lesquels des donnes sont
enregistres dans le fichier.
.TP
.I tzh_typecnt
Le nombre de types d'heures locales pour lesquelles des donnes sont
enregistres dans le fichier (ne doit pas tre nul).
.TP
.I tzh_charcnt
Le nombre de caractres de chanes d'abbrviation de fuseau horaire
enregistres dans le fichier.
.PP
Cet en-tte est suivi par
.I tzh_timecnt
valeurs sur 4 octets de type
.BR long ,
classes en ordre croissant.
Ces valeurs sont crites dans l'ordre standard des octets.
Chacune est un instant de transition (comme renvoy par
l'appel-systme
.IR time (2))
auquel les rgles de calcul de l'heure locale changent.
Ensuite viennent
.I tzh_timecnt
valeurs sur un octet de type
.BR "unsigned char" ;
chacune indiquant lequel des diffrents types d'heures locales dcrites
dans le fichier est associ avec l'instant de transition ayant le mme
rang.
Ces valeurs servent d'indice dans une table de structures
.I ttinfo
qui apparaissent ensuite dans le fichier. Ces structures sont dfinies ainsi:
.in +.5i
.sp
.nf
.ta .5i +\w'unsigned int\0\0'u
struct ttinfo {
long tt_gmtoff;
int tt_isdst;
unsigned int tt_abbrind;
};
.in -.5i
.fi
.sp
Chaque structure est crite sous forme d'une valeur 4 octets pour
.I tt_gmtoff
du type
.BR long ,
dans l'ordre standard des octets, suivie d'une valeur sur 1 octet pour
.I tt_isdst
et une valeur sur 1 octet pour
.IR tt_abbrind .
Dans chaque structure,
.I tt_gmtoff
indique le nombre de secondes ajouter l'UTC,
.I tt_isdst
indique si
.I tm_isdst
doit tre indiqu par
.I localtime (3)
et
.I tt_abbrind
sert d'index dans la table des caractres d'abbrviation de la zone horaire
qui suit les structures
.I ttinfo
dans le fichier.
.PP
Viennent ensuite
.I tzh_leapcnt
paires de valeurs 4 octets, crites dans l'ordre standard des octets. La
premire valeur de chaque paire donne l'instant (comme fourni par
.IR time(2))
auquel se trouve une seconde de rattrapage.
La seconde indique le nombre
.I total
de secondes de rattrapage
a insrer aprs l'instant donn.
Ces paires sont classes en ordre croissant de date.
.PP
Ensuite se trouvent
.I tzh_ttisstdcnt
indicateurs standard/wall, chacun enregistr sur un octet. Ils indiquent
si les instants de transition associs aux types d'heures locales ont t
spcifis en heure standard ou locale, et servent lorsqu'un fichier
de fuseau horaire permet de manipuler des variables d'environnement
de zone horaire la manire POSIX.
.PP
Finalement se trouvent
.I tzh_ttisgmtcnt
indicateurs UTC/local , chacun enregistr sur un octet. Ils indiquent
si les instants de transition associs aux types d'heures locales ont t
spcifis en heure UTC ou locale, et servent lorsqu'un fichier
de fuseau horaire permet de manipuler des variables d'environnement
de zone horaire la manire POSIX.
.PP
.I Localtime
utilise la premire structure
.I ttinfo
en heure standard du fichier (ou simplement la premire structure
.I ttinfo
s'il n'y en a pas en heure standard), si
.I tzh_timecnt
est nul, ou si son argument temporel est antrieur la premire transition
enregistre dans le fichier.
.SH "VOIR AUSSI"
newctime(3)
|
