Provided by: manpages-de_0.10-1_all bug

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)