67 lines
2.4 KiB
Groff
67 lines
2.4 KiB
Groff
.\" @(#)tzsetup.8 1.1 92/07/30 SMI;
|
|
.hw gettimeofday
|
|
.TH TZSETUP 8 "17 November 1987"
|
|
.SH NAME
|
|
tzsetup \- set up old-style time zone information in the kernel
|
|
.SH SYNOPSIS
|
|
.B /usr/etc/tzsetup
|
|
.SH DESCRIPTION
|
|
.IX "tzsetup command" "" "\fLtzsetup\fP command"
|
|
.LP
|
|
.B tzsetup
|
|
attempts to find the offset from GMT and old-style Daylight Savings Time
|
|
correction type (see
|
|
.BR gettimeofday (2))
|
|
that most closely matches the default time zone for the machine, and
|
|
to pass this information to the kernel with a
|
|
.B settimeofday (\|)
|
|
call (see
|
|
.BR gettimeofday (2)).
|
|
This is necessary if programs built under releases
|
|
of Sun\s-1OS\s0 prior to 4.0 are to be run;
|
|
those programs get time zone information from
|
|
the kernel using
|
|
.BR gettimeofday .
|
|
.LP
|
|
If it cannot find the offset from
|
|
.SM GMT\s0,
|
|
the offset is set to 0; if it
|
|
cannot find the Daylight Savings Time correction type, it is set to
|
|
.SM
|
|
.BR DST_NONE\s0 ,
|
|
indicating that no Daylight Savings Time correction is to be
|
|
performed.
|
|
.SH DIAGNOSTICS
|
|
.TP
|
|
.BI "tzsetup: Can't open /usr/share/lib/zoneinfo/localtime: " reason
|
|
The time zone file for the current time zone could not be opened.
|
|
.TP
|
|
.BI "tzsetup: Error reading /usr/lib/zoneinfo/localtime: " reason
|
|
The time zone file for the current time zone could not be read.
|
|
.TP
|
|
.B "tzsetup: Two or more time zone types are equally valid \(em no \s-1DST\s0 selected"
|
|
There were two or more Daylight Savings Time correction types that
|
|
generated results that were equally close to the correct results.
|
|
None of them was selected. Programs built under versions of Sun\s-1OS\s0
|
|
prior to 4.0 may not convert dates correctly.
|
|
.TP
|
|
.B "tzsetup: No old-style time zone type is valid \(em no \s-1DST\s0 selected"
|
|
None of the Daylight Savings Time correction types generated results
|
|
that were in any way correct; none of them was selected.
|
|
Programs built under versions of Sun\s-1OS\s0
|
|
prior to 4.0 may not convert dates correctly.
|
|
.TP
|
|
.B "tzsetup: Warning: No old-style time zone type is completely valid"
|
|
None of the Daylight Savings Time correction types generated results
|
|
that were completely correct; the best of them was selected. Programs built
|
|
under versions of Sun\s-1OS\s0 prior to 4.0 may not convert dates correctly.
|
|
.TP
|
|
.B "tzsetup: Can't set time zone"
|
|
.B tzsetup
|
|
was run by a user other than the super-user; only the super-user may
|
|
change the kernel's notion of the current time zone.
|
|
.SH "SEE ALSO"
|
|
.BR gettimeofday (2),
|
|
.BR tzfile (5),
|
|
.BR zic (8)
|