BEZEICHNUNG¶

BESCHREIBUNG¶

Zeitzoneninformationsdateien beginnen mit einem 44-Byte-Kopf, der wie folgt strukturiert ist:

• Die magische Vier-Byte-Sequenz »TZif« identifiziert dies als Zeitzoneninformationsdatei.
• Ein einzelnes Zeichen identifiziert die Version des Dateiformats: entweder ein ASCII NUL ('\0') oder ein '2' (0x32).
• Fünfzehn Bytes, die Nullen enthalten, sind für zukünftige Nutzung reserviert.
• Sechs Vierbytewerte des Typs long, geschrieben in einer »standard«-Byte-Reihenfolge (das »high-order«-Byte des Wertes ist zuerst geschrieben). Diese Werte sind, in Reihenfolge:

Nach diesem Header folgen tzh_timecnt 4-Byte-Werte vom Typ long, nach steigender Wertigkeit sortiert. Auch sie werden in der Standard-Byteordnung geschrieben. Jeder Wert wird als Zeitpunkt (wie er von time(2) zurückgegeben wird) verwendet, zu dem sich die Regeln für die Berechnung der lokalen Zeit ändern. Darauf folgen tzh_timecnt Werte vom Typ unsigned char. Jeder dieser Werte besagt, welcher der verschiedenen, in der Datei beschriebenen lokalen Zeit-Typen, mit dem Wechsel der Zeitberechnung mit dem gleichen Index verknüpft ist. Die Werte dienen als Indizes für ein Feld von ttinfo-Strukturen (mit tzh_typecnt Einträgen). Diese Strukturen sind wie folgt definiert:

struct ttinfo {
    long         tt_gmtoff;
    int          tt_isdst;
    unsigned int tt_abbrind;
};

Jede Struktur besteht aus einem 4-Byte-Wert für tt_gmtoff vom Typ long, geschrieben in einer Standard-Bytefolge, gefolgt von den 1-Byte-Werten für tt_isdst und für tt_abbrind. In jeder Struktur legt tt_gmtoff die Anzahl Sekunden fest, die zu UTC addiert werden, tt_isdst bestimmt, ob tm_isdst von localtime(3) gesetzt werden soll und tt_abbrind entspricht dem Index im Feld der Abkürzungszeichen für Zeitzonen, die den ttinfo-Strukturen in der Datei folgen.

Als Nächstes gibt es tzh_leapcnt Paare von 4-Byte-Werten, geschrieben in Standard-Bytefolge. Der erste Wert jedes Paares bezeichnet den Zeitpunkt (Rückgabewert von time(2)), zu dem die Schaltsekunden auftreten. Der zweite bestimmt die gesamte Anzahl der Schaltsekunden, die nach der angegebenen Zeit eingelegt werden sollen. Die Wertepaare sind in aufsteigender Folge nach der Zeit sortiert.

Nun folgen tzh_ttisstdcnt Standard-/Wall-Kennziffern, jede wird als 1-Byte-Wert gespeichert. Sie geben an, ob die Übergangszeiten, die den lokalen Zeit-Typen zugeordnet sind, als Standard-Zeit oder als »wall clock time« angegeben wurden. Sie werden verwendet, wenn eine Zonendatei für die Verarbeitung POSIX-artiger Zeitzonen-Umgebungsvariablen eingesetzt wird.

Schließlich gibt es tzh_ttisgmtcnt UTC-/Lokal-Kennziffern, jede als 1-Byte-Wert gespeichert. Sie besagen, ob die den lokalen Zeit-Typen zugeordneten Übergangszeiten als UTC oder als lokale Zeit angegeben wurden. Sie werden verwendet, wenn eine Zonendatei für die Verarbeitung POSIX-artiger Zeitzonen-Umgebungsvariablen eingesetzt wird.

localtime(3) verwendet den ersten ttinfo-Eintrag für Standardzeit in der Datei (oder einfach den ersten ttinfo-Eintrag, wenn kein Standardzeit-Eintrag existiert), wenn entweder tzh_timecnt Null ist oder das Zeit-Argument kleiner ist als der erste in der Datei abgelegte Übergangszeitpunkt.

ANMERKUNGEN¶

Es scheint, dass timezone tzfile intern verwendet, aber Glibc das nicht in der Anwendungsebene verfügbar macht. Der Grund ist höchstwahrscheinlich, dass die standardisierten Funktionen sinnvoller, besser portierbar und tatsächlich von Glibc dokumentiert sind. Vermutlich ist es nur in Glibc enthalten, um die nicht von Glibc (sondern einer anderen Organisation) gepflegten Zeitzonendaten zu unterstützen.

Vier-Byte-Werteabschnitt
(Header Version 0x00 oder 0x32)
        Headereintrag
        Vier-Byte Übergangszeiten
        Index der Übergangszeiten
        ttinfo-Strukturen
        Feld für Zeitzonen-Abkürzungen
        Schaltsekundeneinträge
        Feld für Standard/Echtzeit
        Feld für UTC/Ortszeit
Acht-Byte-Werteabschnitt
(nur wenn im ersten Header die Version 0x32 steht,
ist auch im zweiten Header die Version 0x32)
        Headereintrag
        Acht-Byte Übergangszeiten
        Index der Übergangszeiten
        ttinfo-Strukturen
        Feld für Zeitzonen-Abkürzungen
        Schaltsekundeneinträge
        Feld für Standard/Echtzeit
        Feld für UTC/Ortszeit
Dritter Abschnitt
(optional, nur in Version 0x32 Dateien)
        Zeilenumbruchzeichen
        Zeitzonenzeichenkette
        Zeilenumbruchzeichen

SIEHE AUCH¶

timezone/tzfile.h in dem Glibc-Quellcode.

KOLOPHON¶

ÜBERSETZUNG¶

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.