zic - Compilation des informations de fuseau horaire.

zic [ -v ] [ -d répertoire ] [ -l heure_locale ] [ -p règles_posix ] [ -L fichier_secondes_rattrapages ] [ -s ] [ -y commande ] [ fichier ... ]

Zic lit le texte dans les fichiers indiqués sur la ligne de commande et crée les fichiers d'information pour les conversions horaires indiqués dans son entrée. Si un nom de fichier est -, on lit l'entrée standard à sa place.

Les options disponibles sont :

-d répertoire

Crée les fichiers d'informations pour les conversions horaires dans le répertoire indiqué plutôt que dans le répertoire standard indiqué plus bas.

-l fuseau_horaire

Utiliser le fuseau horaire indiqué comme heure locale. Zic agira comme si l'entrée contenait une ligne de lien de la forme Link fuseau_horaire heure_locale

-p fuseau_horaire

Utiliser les règles de conversion horaire du fuseau indiqué lors de la gestion des variables d'environnement horaires POSIX. Zic agira comme si l'entrée contenait une ligne de lien de la forme Link fuseau_horaire règles_posix

-L fichier_secondes_rattrapage

Lire les informations concernant les secondes supplémentaires de rattrapage périodique à partir du fichier indiqué. Si cette option n'est pas indiquée, aucune seconde de rattrapage ne sera prise en compte dans les fichiers de sortie.

-v

Refuser qu'une année indiquée dans le fichier de données soit en dehors de l'intervalle représentable par les valeurs de time(2).

-s

Limiter les valeurs de temps stockées 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.

-y commande

Utiliser la commande plutôt que yearistype pour vérifier les types d'années (voir plus bas).

Les lignes d'entrées sont composées de champs, séparés les uns des autres par un nombre quelconque de caractères blancs. Les espaces en début et fin de ligne sont ignorées. Un caractère dièse (#) non protégé en entrée introduit un commentaire qui s'étend jusqu'à la fin de la ligne où il apparaît. Les caractères blancs et les dièses peuvent être inclus entre guillemets (") lorsqu'ils doivent faire partie d'un champ. Toute ligne vide (après suppression des commentaires) est ignorée. Les lignes non-vides peuvent être de trois types : les lignes de règle, de zone, et de lien.

Une ligne de règle a la forme :

Rule	NAME	FROM	TO	TYPE	IN	ON	AT	SAVE	LETTER/S

Par exemple :

Rule	US	1967	1973	-	Apr	lastSun	2:00	1:00	D

NAME

Indiquer le nom (arbitraire) du jeu de règles dont celle-ci fait partie.

FROM

Donne la première année où la règle s'applique. Tout nombre entier correspondant à une année peut être utilisé. On suppose qu'il s'agit du calendrier grégorien. Le mot minimum (ou une abréviation) correspond à la plus petite année représentable par un entier. Le mot maximum (ou une abréviation) correspond à la plus grande année représentable par un entier. Les règles peuvent décrire des dates qui ne soient pas représentables par des valeurs de type time. Ceci permet aux règles d'être générales quels que soient les types de données employées par la machine hôte.

TO

Indique l'année finale où la règle s'applique. En plus des symboles minimum et maximum (comme précédemment), le mot only (ou une abréviation) permet de ré-utiliser la valeur du champ FROM sans avoir à la répéter.

TYPE

Indique le type des années où la règle s'applique. Si le TYPE est - alors la règle s'applique pour toutes les années entre FROM et TO comprises. Si le TYPE a une autre valeur, alors zic exécute la commande yearistype année type

pour vérifier le type de l'année : un code de sortie nul indique l'année indiquée est du type considéré, un code de sortie valant 1 signifie que l'année n'est pas de ce type.

IN

Indique le mois où la règle prend effet. Les noms de mois peuvent être abrégés.

ON

Indique le jour où la règle s'applique. Les formes acceptées comprennent :

5	Le 5 du mois
lastSun	le dernier Dimanche du mois
lastMon	le dernier Lundi du mois
Sun>=8	Le premier Dimanche après le 8
Sun<=25	Le dernier Dimanche avant le 25

Les noms des jours de semaine peuvent être abrégés. Il ne doit pas y avoir d'espace au sein du champ ON.

AT

Indique l'heure à laquelle la règle s'applique. Diverses formes sont possibles :

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

l'heure peut valoir 0 à minuit au début de la journée, ou 24 à minuit à la fin de la journée. N'importe quelle forme ci-dessus peut être suivie des lettres w si l'heure est locale ("wall clock" = "horloge sur le mur"), s s'il s'agit de l'heure locale standard, u (ou g ou z) s'il s'agit de l'heure universelle. Sans indicateur on suppose que c'est l'heure locale (w).

SAVE

Indique la quantité horaire à ajouter à l'heure locale lorsque la règle agit. Ce champ a le même format que le champ AT (sauf que les suffixes w et s ne sont évidemment pas utilisés).

LETTER/S

Indique la de l'abréviation du fuseau horaire (par exemple, ou dans ou lorsque la règle est en fonction. Si ce champ vaut -, la partie variable est nulle.

Une ligne de zone a la forme

Zone	NAME	GMTOFF	RULES/SAVE	FORMAT	[UNTIL]

Par exemple:

Zone	Australia/Adelaide	9:30	Aus	CST	1971 Oct 31 2:00

NAME

Le nom du fuseau horaire. Il s'agit du nom utilisé pour la création du fichier de données de conversions temporelles pour cette zone.

GMTOFF

La quantité de temps à ajouter au temps universel UTC pour obtenir l'heure standard dans la zone. Ce champ a le même format que les champs AT et SAVE des lignes de règles. On peut commencer le champ avec un signe moins (-) si la quantité doit être soustraite de l'UTC.

RULES/SAVE

Les noms des règles qui s'appliquent dans cette zone, ou bien la quantité horaire à ajouter au temps local standard de la zone. Si ce champ est - alors l'heure standard s'applique toujours dans cette zone.

FORMAT

Le format pour l'abréviation du fuseau horaire dans cette zone. Les deux caractères %s servent à indiquer où placer la de l'abréviation du fuseau. Éventuellement, un slash (/) peut séparer les abréviations standard et d'heure d'été.

UNTIL

Le moment où change le décalage par rapport à l'UTC. Ce moment est indiqué sous la forme d'une année, un mois, un jour, et une heure. S'il est spécifié, les informations pour le fuseau horaire seront créées à partir de la règle, ou du décalage UTC jusqu'au moment indiqué. Les valeurs doivent avoir le même format que pour les colonnes IN, ON, et AT d'une règle. Les colonnes suivantes peuvent être omises.

La ligne suivante doit être une ligne de qui a la même forme qu'une ligne de zone, sauf que la chaîne et le nom sont absents. Cette ligne de continuation va placer les informations commençant au moment précisé dans le champ UNTIL de la ligne précédente dans le fichier utilisé par cette dernière. Les lignes de continuation peuvent avoir un champ UNTIL, comme les lignes de zones, pour montrer que la ligne suivant est également une future continuation.

Une ligne de lien a la forme :

Link	LINK-FROM	LINK-TO

Par exemple:

Link	Europe/Istanbul	Asia/Istanbul

A l'exception des lignes de continuation, toutes les autres lignes peuvent apparaître dans n'importe quel ordre.

Les lignes dans les fichiers qui décrivent les secondes de rattrapage périodique doivent avoir la forme :

Leap	YEAR	MONTH	DAY	HH:MM:SS	CORR	R/S

Par exemple :

Leap	1974	Dec	31	23:59:60	+	S

Pour les zones ayant plus de deux types d'heure locale, il peut être nécessaire d'utiliser l'heure locale standard dans le champ AT de la première règle de transition pour s'assurer que la première heure de transition du fichier compilé soit correcte.

/usr/local/etc/zoneinfo répertoire standard pour les fichiers créés.

newctime(3), tzfile(5), zdump(8)

Christophe Blaess, 1999-2003.