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_rattrapage ] [ -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ées dans ces fichiers. Si un nom de fichier est -, l'entrée standard est lue.

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 conversions horaires 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 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 de générer 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 est de 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
    Indique le nom (arbitraire) du jeu de règles dont celle-ci fait partie.

FROM
    Indique la première année pour laquelle 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 sont pas représentables par des valeurs de time(2). Ceci permet aux règles d'être générales quels que soient les types de données employés par la machine hôte.

TO  Indique l'année finale pour laquelle 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.

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 auquel la règle prend effet. Les noms de mois peuvent être abrégés.

ON  Indique le jour auquel la règle prend effet. 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 la 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 prend effet. Diverses formes sont acceptées :

    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 vaut 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 », c'est-à-dire la pendule), 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.

SAVE
    Indique la quantité horaire à ajouter à l'heure locale lorsque la règle prend effet. 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 est de la forme :

Zone	NAME	UTCOFF	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 horaires pour cette zone.

UTCOFF
    La quantité de temps à ajouter au temps universel 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 « partie variable » de l'abréviation du fuseau. Éventuellement, une barre oblique « / » peut séparer les abréviations standard et d'heure d'été.

UNTIL
    Le moment où changent le décalage par rapport à l'UTC ou les règles pour le lieu. Ce moment est indiqué sous la forme d'une année, un mois, un jour, et une heure. Si elles sont spécifiées, 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 valeur par défaut étant le plus tôt possible pour les colonnes manquantes.

    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 est de 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 de lien alternatif pour la zone.

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

Les lignes dans le fichier décrivant 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 indiquent 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 est enlevée. Le champ R/S doit être un S (abréviation de Stationary) si l'instant indiqué par les autres champs doit être interprété comme une heure UTC, ou bien R (abréviation de Rolling) si l'instant est en heure locale.

FICHIERS
/usr/local/etc/zoneinfo    Répertoire standard pour les fichiers créés

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.

VOIR AUSSI
tzfile(5), zdump(8)

COLOPHON
Cette page fait partie de la publication 3.40 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <URL:http://perkamon.alioth.debian.org/>.

Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1999-2008).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».