ZIC(8)

NOM
zic - Compilation des informations de fuseau horaire

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

DESCRIPTION
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

Les champs composant une ligne de règle sont :

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 « - », la règle s'applique pour toutes les années entre FROM et TO comprises. Si le TYPE a une autre valeur, zic exécute la commande
    yearistype année type
    pour vérifier le type de l'année : un code de sortie nul indique que 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 « partie variable » de l'abréviation du fuseau horaire (par exemple, « S » ou « D » dans « EST » ou « EDT ») 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

Les champs constituant une ligne de zone sont les suivants :

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 « - », 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 « continuation » qui a la même forme qu'une ligne de zone, sauf que la chaîne « Zone » 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 suivante est également une future continuation.

Une ligne de lien a la forme :

Link	LINK-FROM	LINK-TO

Par exemple :

Link	Europe/Istanbul	Asia/Istanbul

Le champ LINK-FROM doit exister sous forme de champ NAME quelque part dans une ligne de zone. Le champ LINK-TO sert d'autre nom pour la zone.

À 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

Les champs YEAR, MONTH, DAY, et HH:MM:SS indique le moment où la seconde de rattrapage apparaît. Le champ CORR doit contenir un « + » si une seconde est ajoutée ou un « - » si une seconde disparaît. Le champ R/S doit être Stationary (ou une abréviation) si l'instant indiqué par les autres champs doit être interprété comme une heure UTC, ou bien Rolling (ou une abréviation) si l'instant est en heure locale.

FICHIERS
/usr/local/etc/zoneinfo

NOTES
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. répertoire standard pour les fichiers créés.

VOIR AUSSI
tzfile(5), zdump(8)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 mai 1999 et révisée le 10 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 8 zic ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.