Provided by:
manpages-de_0.10-1_all 
BEZEICHNUNG
tzfile - Zeitzonen-Informationen
"UBERSICHT
#include <tzfile.h>
BESCHREIBUNG
Diese Handbuchseite beschreibt die Struktur der Zeitzonen-Dateien,
welche in /usr/lib/zoneinfo oder /usr/share/zoneinfo gespeichert sind.
Die Bibliotheksfunktion tzset(3) nutzt Zeitzonen-Informationsdateien.
Diese Dateien beginnen mit den magischen Zeichen >>TZif<<, welches sie
als Zeitzonen-Informationsdateien identifiziert. Ihnen folgt (Stand
2005) ein Zeichen zur Identifikation des Dateiformats (entweder ein
ASCII-NUL (>>\0<<) oder eine >>2<<). Die darauf folgenden 15 Byte sind
fur eine zukunftige Verwendung reserviert. Danach folgen sechs
32-Bit-Werte des Typs long. Die Daten werden in einer
>>Standard<<-Byteordnung geschrieben (die hoherwertigen Bytes zuerst).
Die sechs Werte bedeuten:
tzh_ttisgmtcnt
Anzahl der in der Datei hinterlegten UTC-/Lokal-Kennziffern
tzh_ttisstdcnt
Anzahl der in der Datei gespeicherten Standard-/Wall-Kennziffern
tzh_leapcnt
Anzahl der Schaltsekunden, fur die Angaben in der Datei
gespeichert sind
tzh_timecnt
Anzahl der >>Ubergangszeiten<< (transition times), fur die
Angaben in der Datei gespeichert sind
tzh_typecnt
Anzahl der >>lokalen Zeit-Typen<<, fur die Informationen in der
Datei gespeichert sind (darf nicht Null sein)
tzh_charcnt
Anzahl der Zeichen fur in der Datei gespeicherte
Zeitzonen-Abkurzungen (timezone abbreviation strings)
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
sie von time(2) zuruckgegeben wird) verwendet, zu dem sich die Regeln
fur die Berechnung der lokalen Zeit andern. 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 verknupft ist. Die
Werte dienen als Indizes fur ein Feld von ttinfo-Strukturen (mit
tzh_typecnt Eintragen). 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 fur tt_gmtoff vom Typ long,
geschrieben in einer Standard-Bytefolge, gefolgt von den 1-Byte-Werten
fur tt_isdst und fur 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 Abkurzungszeichen fur Zeitzonen, die den
ttinfo-Strukturen in der Datei folgen.
Als Nachstes gibt es tzh_leapcnt Paare von 4-Byte-Werten, geschrieben
in Standard-Bytefolge. Der erste Wert jedes Paares bezeichnet den
Zeitpunkt (Ruckgabewert 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 Ubergangszeiten, die den
lokalen Zeit-Typen zugeordnet sind, als Standard-Zeit oder als >>wall
clock time<< angegeben wurden. Sie werden verwendet, wenn eine
Zonendatei fur die Verarbeitung POSIX-artiger
Zeitzonen-Umgebungsvariablen eingesetzt wird.
SchlieBlich gibt es tzh_ttisgmtcnt UTC-/Lokal-Kennziffern, jeder als
1-Byte-Wert gespeichert. Sie besagen, ob die den lokalen Zeit-Typen
zugeordneten Ubergangszeiten als UTC oder als lokale Zeit angegeben
wurden. Sie werden verwendet, wenn eine Zonendatei fur die Verarbeitung
POSIX-artiger Zeitzonen-Umgebungsvariablen eingesetzt wird.
localtime(3) verwendet den ersten ttinfo-Eintrag fur 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
Ubergangszeitpunkt.
ANMERKUNGEN
Diese Handbuchseite beschreibt <tzfile.h> aus dem Glibc-Quelltext
(siehe timezone/tzfile.h).
Es scheint, dass timezone tzfile intern verwendet, aber Glibc das nicht
in der Anwendungsebene verfugbar macht. Das ist sehr wahrscheinlich,
weil die standardisierten Funktionen sinnvoller, besser portierbar und
tatsachlich von Glibc dokumentiert sind. Es ist vielleicht nur in Glibc
enthalten, nur um die nicht von Glibc (sondern einer anderen
Organisation) gepflegten Zeitzonendaten zu unterstutzen.
SIEHE AUCH
time(3), gettimeofday(3), tzset(3), ctime(3)
Fur Zeitzonen-Dateien im Version-2-Format folgen dem oben Beschriebenen
(Vorspann und Daten) ein zweiter Vorspann und Daten in einem ahnlichen
Format. Der Unterschied besteht darin, dass die Ubergangszeiten und
Schaltsekundenzeiten jeweils mit jeweils acht Byte kodiert werden. Nach
dem zweiten Header und den Daten folgt eine durch Zeilenumbruche
abgetrennte Zeichenkette im Stil von
POSIX-Zeitzonen-Umgebungsvariablen. Sie ist fur die Behandlung der
Momente nach der letzten in der Datei gespeicherten Ubergangszeit
bestimmt. (Wenn es keinen POSIX-Darstellung fur solche Momente gibt,
ist die Zeichenkette leer.)
SIEHE AUCH
ctime(3)
KOLOPHON
Diese Seite ist Teil der Veroffentlichung 3.32 des Projekts
Linux-man-pages. Eine Beschreibung des Projekts und Informationen, wie
Fehler gemeldet werden konnen, finden sich unter
http://www.kernel.org/doc/man-pages/.
"UBERSETZUNG
Die deutsche Ubersetzung dieser Handbuchseite wurde von
erstellt.
Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
Public License Version 3 oder neuer bezuglich der Copyright-
Bedingungen. Es wird KEINE HAFTUNG ubernommen.
Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an <debian-l10n-
german@lists.debian.org>.
31. August 2010 TZFILE(5)