mirror of https://github.com/mkerrisk/man-pages
tzfile.5: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
72942d65ad
commit
2061865fb4
|
@ -7,7 +7,7 @@
|
||||||
.\"
|
.\"
|
||||||
.TH TZFILE 5 2017-08-04 "" "Linux Programmer's Manual"
|
.TH TZFILE 5 2017-08-04 "" "Linux Programmer's Manual"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
tzfile \- time zone information
|
tzfile \- timezone information
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.ie '\(lq'' .ds lq \&"\"
|
.ie '\(lq'' .ds lq \&"\"
|
||||||
.el .ds lq \(lq\"
|
.el .ds lq \(lq\"
|
||||||
|
@ -16,7 +16,7 @@ tzfile \- time zone information
|
||||||
.de q
|
.de q
|
||||||
\\$3\*(lq\\$1\*(rq\\$2
|
\\$3\*(lq\\$1\*(rq\\$2
|
||||||
..
|
..
|
||||||
The time zone information files used by
|
The timezone information files used by
|
||||||
.BR tzset (3)
|
.BR tzset (3)
|
||||||
are typically found under a directory with a name like
|
are typically found under a directory with a name like
|
||||||
.IR /usr/share/zoneinfo .
|
.IR /usr/share/zoneinfo .
|
||||||
|
@ -24,7 +24,7 @@ These files begin with a 44-byte header containing the following fields:
|
||||||
.IP * 2
|
.IP * 2
|
||||||
The magic four-byte ASCII sequence
|
The magic four-byte ASCII sequence
|
||||||
.q "TZif"
|
.q "TZif"
|
||||||
identifies the file as a time zone information file.
|
identifies the file as a timezone information file.
|
||||||
.IP *
|
.IP *
|
||||||
A byte identifying the version of the file's format
|
A byte identifying the version of the file's format
|
||||||
(as of 2017, either an ASCII NUL, or
|
(as of 2017, either an ASCII NUL, or
|
||||||
|
@ -59,7 +59,7 @@ The number of local time types for which data entries are stored
|
||||||
in the file (must not be zero).
|
in the file (must not be zero).
|
||||||
.TP
|
.TP
|
||||||
.I tzh_charcnt
|
.I tzh_charcnt
|
||||||
The number of bytes of time zone abbreviation strings
|
The number of bytes of timezone abbreviation strings
|
||||||
stored in the file.
|
stored in the file.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
@ -111,7 +111,7 @@ should be set by
|
||||||
.BR localtime (3)
|
.BR localtime (3)
|
||||||
and
|
and
|
||||||
.I tt_abbrind
|
.I tt_abbrind
|
||||||
serves as an index into the array of time zone abbreviation bytes
|
serves as an index into the array of timezone abbreviation bytes
|
||||||
that follow the
|
that follow the
|
||||||
.I ttinfo
|
.I ttinfo
|
||||||
structure(s) in the file.
|
structure(s) in the file.
|
||||||
|
@ -134,15 +134,15 @@ transitions always separated by at least 28 days minus 1 second.
|
||||||
standard/wall indicators, each stored as a one-byte value;
|
standard/wall indicators, each stored as a one-byte value;
|
||||||
they tell whether the transition times associated with local time types
|
they tell whether the transition times associated with local time types
|
||||||
were specified as standard time or wall clock time,
|
were specified as standard time or wall clock time,
|
||||||
and are used when a time zone file is used in handling POSIX-style
|
and are used when a timezone file is used in handling POSIX-style
|
||||||
time zone environment variables.
|
timezone environment variables.
|
||||||
.IP *
|
.IP *
|
||||||
.I tzh_ttisgmtcnt
|
.I tzh_ttisgmtcnt
|
||||||
UT/local indicators, each stored as a one-byte value;
|
UT/local indicators, each stored as a one-byte value;
|
||||||
they tell whether the transition times associated with local time types
|
they tell whether the transition times associated with local time types
|
||||||
were specified as UT or local time,
|
were specified as UT or local time,
|
||||||
and are used when a time zone file is used in handling POSIX-style
|
and are used when a timezone file is used in handling POSIX-style
|
||||||
time zone environment variables.
|
timezone environment variables.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR localtime (3)
|
.BR localtime (3)
|
||||||
|
@ -158,7 +158,7 @@ if either
|
||||||
is zero or the time argument is less than the first transition time recorded
|
is zero or the time argument is less than the first transition time recorded
|
||||||
in the file.
|
in the file.
|
||||||
.SS Version 2 format
|
.SS Version 2 format
|
||||||
For version-2-format time zone files,
|
For version-2-format timezone files,
|
||||||
the above header and data are followed by a second header and data,
|
the above header and data are followed by a second header and data,
|
||||||
identical in format except that
|
identical in format except that
|
||||||
eight bytes are used for each transition time or leap second time.
|
eight bytes are used for each transition time or leap second time.
|
||||||
|
@ -176,12 +176,13 @@ type must specify a daylight-saving time abbreviated
|
||||||
.q "WEST"
|
.q "WEST"
|
||||||
that is one hour east of UT.
|
that is one hour east of UT.
|
||||||
.SS Version 3 format
|
.SS Version 3 format
|
||||||
For version-3-format time zone files, the POSIX-TZ-style string may
|
For version-3-format timezone files, the POSIX-TZ-style string may
|
||||||
use two minor extensions to the POSIX TZ format, as described in
|
use two minor extensions to the POSIX TZ format, as described in
|
||||||
.IR newtzset (3).
|
.IR newtzset (3).
|
||||||
First, the hours part of its transition times may be signed and range from
|
First, the hours part of its transition times may be signed and range from
|
||||||
\-167 through 167 instead of the POSIX-required unsigned values
|
\-167 through 167 instead of the POSIX-required unsigned values
|
||||||
from 0 through 24. Second, DST is in effect all year if it starts
|
from 0 through 24.
|
||||||
|
Second, DST is in effect all year if it starts
|
||||||
January 1 at 00:00 and ends December 31 at 24:00 plus the difference
|
January 1 at 00:00 and ends December 31 at 24:00 plus the difference
|
||||||
between daylight saving and standard time.
|
between daylight saving and standard time.
|
||||||
.PP
|
.PP
|
||||||
|
|
Loading…
Reference in New Issue