.\" Traduction 11/05/1999 par Christophe Blaess (ccb@club-internet.fr)
.\" LDP-man-pages 1.23
.\" Mise  jour 06/06/2001 - LDP-man-pages-1.37
.\" MJ 25/07/2003 LDP-1.56
.TH ZIC 8 "25 juillet 2003" LDP "Manuel de l'administrateur Linux" 
.SH NOM
zic \- Compilation des informations de fuseau horaire.
.SH SYNOPSIS
.B zic
[
.B \-v
] [
.B \-d
.I rpertoire
] [
.B \-l
.I heure_locale
] [
.B \-p
.I rgles_posix
] [
.B \-L
.I fichier_secondes_rattrapages
] [
.B \-s
] [
.B \-y
.I commande
] [
.I fichier
\&... ]
.SH DESCRIPTION
.if t .ds lq ``
.if t .ds rq ''
.if n .ds lq \&"\"
.if n .ds rq \&"\"
.de q
\\$3\*(lq\\$1\*(rq\\$2
..
.I Zic
lit le texte dans les fichiers indiqus sur la ligne de commande et
cre les fichiers d'information pour les conversions horaires indiqus
dans son entre.
Si un nom de
.I fichier
est
.BR - ,
on lit l'entre standard  sa place.
.PP
Les options disponibles sont\ :
.TP
.BI "\-d " rpertoire
Cre les fichiers d'informations pour les conversions horaires dans
le rpertoire indiqu plutt que dans le rpertoire standard
indiqu plus bas.
.TP
.BI "\-l " fuseau_horaire
Utiliser le fuseau horaire indiqu comme heure locale.
.I Zic
agira comme si l'entre contenait une ligne de lien de la forme
.sp
.ti +.5i
Link	\fIfuseau_horaire\fP		heure_locale
.TP
.BI "\-p " fuseau_horaire
Utiliser les rgles de conversion horaire du fuseau indiqu lors
de la gestion des variables d'environnement horaires POSIX.
.I Zic
agira comme si l'entre contenait une ligne de lien de la forme
.sp
.ti +.5i
Link	\fIfuseau_horaire\fP		rgles_posix
.TP
.BI "\-L " fichier_secondes_rattrapage
Lire les informations concernant les secondes supplmentaires
de rattrapage priodique  partir du fichier indiqu.
Si cette option n'est pas indique, aucune seconde de rattrapage
ne sera prise en compte dans les fichiers de sortie.
.TP
.B \-v
Refuser qu'une anne indique dans le fichier de donnes soit en
dehors de l'intervalle reprsentable par les valeurs de
.IR time (2).
.TP
.B \-s
Limiter les valeurs de temps stockes dans les fichiers de sortie aux valeurs
qui sont identiques en stockage sign et non-sign. Cette option permet
d'engendrer des fichiers compatibles SVVS.
.TP
.BI "\-y " commande
Utiliser la
.I commande
plutt que
.B yearistype
pour vrifier les types d'annes (voir plus bas).
.PP
Les lignes d'entres sont composes de champs, spars les uns des autres
par un nombre quelconque de caractres blancs. Les espaces en dbut et
fin de ligne sont ignores.
Un caractre dise (#) non protg en entre introduit un commentaire qui
s'tend jusqu' la fin de la ligne o il apparat.
Les caractres blancs et les dises peuvent tre inclus entre guillemets (")
lorsqu'ils doivent faire partie d'un champ.
Toute ligne vide (aprs suppression des commentaires) est ignore.
Les lignes non-vides peuvent tre de trois types :
les lignes de rgle, de zone, et de lien.
.PP
Une ligne de rgle a la forme\ :
.nf
.ti +.5i
.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u
.sp
Rule	NAME	FROM	TO	TYPE	IN	ON	AT	SAVE	LETTER/S
.sp
Par exemple\ :
.ti +.5i
.sp
Rule	US	1967	1973	\-	Apr	lastSun	2:00	1:00	D
.sp
.fi
Les champs composant une ligne de rgle sont\ :
.TP "\w'LETTER/S'u"
.B NAME
Indiquer le nom (arbitraire) du jeu de rgles dont celle-ci fait partie.
.TP
.B FROM
Donne la premire anne o la rgle s'applique.
Tout nombre entier correspondant  une anne peut tre utilis. On suppose
qu'il s'agit du calendrier grgorien. Le mot
.B minimum
(ou une abrviation) correspond  la plus petite anne reprsentable par
un entier. Le mot
.B maximum
(ou une abrviation) correspond  la plus grande anne reprsentable par
un entier.
Les rgles peuvent dcrire des dates qui ne soient pas reprsentables par
des valeurs de type \fItime\fP. Ceci permet aux rgles d'tre gnrales
quels que soient les types de donnes employes par la machine hte.
.TP
.B TO
Indique l'anne finale o la rgle s'applique.
En plus des symboles
.B minimum
et
.B maximum
(comme prcdemment), le mot
.B only
(ou une abrviation) permet de r-utiliser
la valeur du champ
.B FROM
sans avoir  la rpter.
.TP
.B TYPE
Indique le type des annes o la rgle s'applique.
Si le
.B TYPE
est
.B -
alors la rgle s'applique pour toutes les annes entre
.B FROM
et
.B TO
comprises.
Si le
.B TYPE
a une autre valeur, alors
.I zic
excute la commande
.ti +.5i
\fByearistype\fP \fIanne\fP \fItype\fP
.br
pour vrifier le type de l'anne :
un code de sortie nul indique l'anne indique est du type considr, un
code de sortie valant 1 signifie que l'anne n'est pas de ce type.
.TP
.B IN
Indique le mois o la rgle prend effet. Les noms de mois peuvent tre
abrgs.
.TP
.B ON
Indique le jour o la rgle s'applique. Les formes acceptes comprennent :
.nf
.in +.5i
.sp
.ta \w'Sun<=25\0\0'u
5	Le 5 du mois
lastSun	le dernier Dimanche du mois
lastMon	le dernier Lundi du mois
Sun>=8	Le premier Dimanche aprs le 8
Sun<=25	Le dernier Dimanche avant le 25
.fi
.in -.5i
.sp
Les noms des jours de semaine peuvent tre abrgs.
Il ne doit pas y avoir d'espace au sein du champ
.BR ON .
.TP
.B AT
Indique l'heure  laquelle la rgle s'applique. Diverses
formes sont possibles :
.nf
.in +.5i
.sp
.ta \w'1:28:13\0\0'u
2	L'heure
2:00	L'heure et les minutes
15:00	Un format sur 24 heures
1:28:14	Heure, minutes, et secondes
\-      quivalent  0
.fi
.in -.5i
.sp
l'heure peut valoir 0  minuit au dbut de la journe, ou 24
 minuit  la fin de la journe. N'importe quelle forme ci-dessus
peut tre suivie des lettres
.B w
si l'heure est locale
("wall clock" = "horloge sur le mur"),
.B s
s'il s'agit de l'heure locale standard,
.B u
(ou
.B g
ou
.BR z )
s'il s'agit de l'heure universelle. Sans indicateur
on suppose que c'est l'heure locale (w).
.TP
.B SAVE
Indique la quantit horaire  ajouter  l'heure locale lorsque la rgle agit.
Ce champ a le mme format que le champ
.B AT
(sauf que les suffixes
.B w
et
.B s
ne sont videmment pas utiliss).
.TP
.B LETTER/S
Indique la
.q "partie variable"
de l'abrviation du fuseau horaire
(par exemple,
.q S
ou
.q D
dans
.q EST
ou
.q EDT )
lorsque la rgle est en fonction.
Si ce champ vaut
.BR - ,
la partie variable est nulle.
.PP
Une ligne de zone a la forme
.sp
.nf
.ti +.5i
.ta \w'Zone\0\0'u +\w'Australia/Adelaide\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
Zone	NAME	GMTOFF	RULES/SAVE	FORMAT	[UNTIL]
.sp
Par exemple:
.sp
.ti +.5i
Zone	Australia/Adelaide	9:30	Aus	CST	1971 Oct 31 2:00
.sp
.fi
Les champs constituant une ligne de zone sont les suivants\ :
.TP "\w'GMTOFF'u"
.B NAME
Le nom du fuseau horaire.
Il s'agit du nom utilis pour la cration du fichier de donnes de conversions
temporelles pour cette zone.
.TP
.B GMTOFF
La quantit de temps  ajouter au temps universel UTC pour obtenir l'heure
standard dans la zone. Ce champ a le mme format que les champs
.B AT
et
.B SAVE
des lignes de rgles. On peut commencer le champ avec un signe moins (-) si
la quantit doit tre soustraite de l'UTC.
.TP
.B RULES/SAVE
Les noms des rgles qui s'appliquent dans cette zone, ou bien
la quantit horaire  ajouter au temps local standard de la zone.
Si ce champ est
.B -
alors l'heure standard s'applique toujours dans cette zone.
.TP
.B FORMAT
Le format pour l'abrviation du fuseau horaire dans cette zone.
Les deux caractres
.B %s
servent  indiquer o placer la
.q "partie variable"
de l'abrviation du fuseau.
ventuellement, un slash (/) peut sparer les abrviations
standard et d'heure d't.
.TP
.B UNTIL
Le moment o change le dcalage par rapport  l'UTC. 
Ce moment est indiqu sous la forme d'une anne, un mois, un jour, et
une heure. S'il est spcifi, les informations pour le fuseau horaire
seront cres  partir de la rgle, ou du dcalage UTC jusqu'au moment
indiqu. Les valeurs doivent avoir le mme format que pour les colonnes
IN, ON, et AT d'une rgle. Les colonnes suivantes peuvent tre omises.
.IP
La ligne suivante doit tre une ligne de
.q continuation
qui a la mme forme qu'une ligne de zone, sauf que la chane
.q Zone
et le nom sont absents. Cette ligne de continuation va placer les informations
commenant au moment prcis dans le champ
.B UNTIL
de la ligne prcdente dans le fichier utilis par cette dernire.
Les lignes de continuation peuvent avoir un champ
.BR UNTIL ,
comme les lignes de zones, pour montrer que la ligne suivant est galement
une future continuation.
.PP
Une ligne de lien a la forme\ :
.sp
.nf
.ti +.5i
.ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u
Link	LINK-FROM	LINK-TO
.sp
Par exemple:
.sp
.ti +.5i
Link	Europe/Istanbul	Asia/Istanbul
.sp
.fi
Le champ
.B LINK-FROM
doit exister sous forme de champ
.B NAME
quelque part dans une ligne de zone. Le champ
.B LINK-TO
sert d'autre nom pour la zone.
.PP
A l'exception des lignes de continuation, toutes les autres lignes
peuvent apparatre dans n'importe quel ordre.
.PP
Les lignes dans les fichiers qui dcrivent les secondes de rattrapage
priodique doivent avoir la forme\ :
.nf
.ti +.5i
.ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u
.sp
Leap	YEAR	MONTH	DAY	HH:MM:SS	CORR	R/S
.sp
Par exemple\ :
.ti +.5i
.sp
Leap	1974	Dec	31	23:59:60	+	S
.sp
.fi
Les champs
.BR YEAR ,
.BR MONTH ,
.BR DAY ,
et
.B HH:MM:SS
indique le moment o la seconde de rattrapage apparat.
Le champ
.B CORR
doit contenir un
.q +
si une seconde est ajoute
ou un
.q -
si une seconde disparat.
Le champ
.B R/S
doit tre
.I Stationary
(ou une abrviation) si l'instant indiqu par les autres champs doit tre
interprt comme une heure UTC, ou bien 
.I Rolling
(ou une abrviation) si l'instant est en heure locale.
.SH NOTE
Pour les zones ayant plus de deux types d'heure locale, il peut tre ncessaire
d'utiliser l'heure locale standard dans le champ
.B AT
de la premire rgle de transition pour s'assurer que la premire
heure de transition du fichier compil soit correcte.
.SH FICHIERS
/usr/local/etc/zoneinfo	rpertoire standard pour les fichiers crs.
.SH "VOIR AUSSI"
.BR newctime (3),
.BR tzfile (5),
.BR zdump (8)
.SH TRADUCTION
Christophe Blaess, 1999-2003.