1996-08-27 20:04:45 +00:00
|
|
|
.\" Copyright (c) 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin.
|
|
|
|
.\" All rights reserved.
|
1996-01-24 00:11:58 +00:00
|
|
|
.\"
|
1996-08-27 20:04:45 +00:00
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
1996-01-24 00:11:58 +00:00
|
|
|
.\"
|
1996-08-27 20:04:45 +00:00
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
2023-04-19 11:56:58 +00:00
|
|
|
.Dd April 18, 2023
|
1996-01-24 00:11:58 +00:00
|
|
|
.Dt TZSETUP 8
|
2001-07-10 15:12:08 +00:00
|
|
|
.Os
|
1996-01-24 00:11:58 +00:00
|
|
|
.Sh NAME
|
|
|
|
.Nm tzsetup
|
1996-02-27 00:27:21 +00:00
|
|
|
.Nd set local timezone
|
1997-10-27 07:49:47 +00:00
|
|
|
.Sh SYNOPSIS
|
2000-11-20 20:10:44 +00:00
|
|
|
.Nm
|
2009-10-20 06:54:31 +00:00
|
|
|
.Op Fl nrs
|
2011-05-20 17:35:10 +00:00
|
|
|
.Op Fl C Ar chroot_directory
|
|
|
|
.Op Ar zoneinfo_file | zoneinfo_name
|
1997-10-27 07:49:47 +00:00
|
|
|
.Sh DESCRIPTION
|
1999-02-02 20:26:31 +00:00
|
|
|
The
|
1997-10-27 07:49:47 +00:00
|
|
|
.Nm
|
2002-07-14 14:47:15 +00:00
|
|
|
utility reads a database of timezone information and presents a menu
|
1999-02-02 20:26:31 +00:00
|
|
|
allowing the user to select a specific zone without knowing the details
|
2004-07-02 23:13:00 +00:00
|
|
|
of the database layout.
|
|
|
|
The selected zone is installed as the system
|
1999-02-02 20:26:31 +00:00
|
|
|
default zone.
|
2002-07-14 14:47:15 +00:00
|
|
|
The
|
1999-02-02 20:26:31 +00:00
|
|
|
.Nm
|
2002-07-14 14:47:15 +00:00
|
|
|
utility also determines whether any adjustment is necessary for systems where
|
2023-04-19 11:56:58 +00:00
|
|
|
the hardware clock does not keep UTC.
|
1997-10-27 07:49:47 +00:00
|
|
|
.Pp
|
2012-02-29 14:44:42 +00:00
|
|
|
The following options are available:
|
1999-02-02 20:26:31 +00:00
|
|
|
.Bl -tag -offset indent -width Fl
|
2011-05-20 17:35:10 +00:00
|
|
|
.It Fl C Ar chroot_directory
|
2009-10-21 20:55:04 +00:00
|
|
|
Open all files and directories relative to
|
2011-05-20 17:35:10 +00:00
|
|
|
.Ar chroot_directory .
|
1997-10-27 07:49:47 +00:00
|
|
|
.It Fl n
|
1999-02-02 20:26:31 +00:00
|
|
|
Do not create or copy files.
|
2009-10-20 06:54:31 +00:00
|
|
|
.It Fl r
|
2011-05-20 17:35:10 +00:00
|
|
|
Reinstall the zoneinfo file installed last time.
|
|
|
|
The name is obtained from
|
2009-10-20 06:54:31 +00:00
|
|
|
.Pa /var/db/zoneinfo .
|
2011-05-20 17:35:10 +00:00
|
|
|
.It Fl s
|
2023-04-19 11:56:58 +00:00
|
|
|
Skip the initial question about adjusting the clock if not set to UTC.
|
1997-10-27 07:49:47 +00:00
|
|
|
.El
|
1999-02-02 20:26:31 +00:00
|
|
|
.Pp
|
2009-10-19 21:37:31 +00:00
|
|
|
It is possible to short-circuit the menu system by specifying the
|
|
|
|
location of a
|
2011-05-20 17:35:10 +00:00
|
|
|
.Ar zoneinfo_file
|
2009-10-21 20:55:04 +00:00
|
|
|
or the name of the
|
2011-05-20 17:35:10 +00:00
|
|
|
.Ar zoneinfo_name
|
2009-10-19 21:37:31 +00:00
|
|
|
on the command line; this is intended mainly for pre-configured installation
|
2009-10-21 20:55:04 +00:00
|
|
|
scripts or people who know which zoneinfo they want to install.
|
1999-02-02 20:26:31 +00:00
|
|
|
.Sh TIMEZONE DATABASE
|
|
|
|
The contents of the timezone database are indexed by
|
2023-04-19 11:56:58 +00:00
|
|
|
.Pa /usr/share/zoneinfo/zone1970.tab .
|
|
|
|
This file lists, for each timezone data file, the ISO 3166 territory code,
|
|
|
|
approximate geographical coordinates (in ISO 6709 format),
|
1999-02-02 20:26:31 +00:00
|
|
|
and location within the territory.
|
|
|
|
.Pp
|
|
|
|
The maintainers of the database maintain the following policies:
|
|
|
|
.Bl -enum -offset indent
|
|
|
|
.It
|
|
|
|
At least one zone for every country or inhabited geographical territory.
|
|
|
|
.It
|
|
|
|
One zone for every distinct, documented timezone history since the
|
|
|
|
beginning of the
|
|
|
|
.Ux
|
2023-04-19 11:56:58 +00:00
|
|
|
epoch (January 1, 1970, GMT).
|
1999-02-02 20:26:31 +00:00
|
|
|
.It
|
2004-07-02 23:13:00 +00:00
|
|
|
Each zone is named for the most populous city therein.
|
|
|
|
(Where possible,
|
1999-02-02 20:26:31 +00:00
|
|
|
the database includes pre-1970 history for its city.)
|
|
|
|
.El
|
2023-04-19 11:56:58 +00:00
|
|
|
.Pp
|
1999-02-02 20:26:31 +00:00
|
|
|
The source code to the database
|
2023-04-19 11:56:58 +00:00
|
|
|
.Pq Pa /usr/src/contrib/tzdata/[a-z]*
|
1999-02-02 20:26:31 +00:00
|
|
|
contains many additional comments and documentation references for the
|
|
|
|
historically minded.
|
1996-01-24 00:11:58 +00:00
|
|
|
.Sh FILES
|
2023-04-19 11:56:58 +00:00
|
|
|
.Bl -tag -width ".Pa /usr/share/zoneinfo/zone1970.tab" -compact
|
1996-01-24 00:11:58 +00:00
|
|
|
.It Pa /etc/localtime
|
2011-05-20 17:35:10 +00:00
|
|
|
current time zone file
|
1996-01-24 00:11:58 +00:00
|
|
|
.It Pa /etc/wall_cmos_clock
|
1997-10-27 07:49:47 +00:00
|
|
|
see
|
2011-05-20 17:35:10 +00:00
|
|
|
.Xr adjkerntz 8
|
1999-02-02 20:26:31 +00:00
|
|
|
.It Pa /usr/share/misc/iso3166
|
2023-04-19 11:56:58 +00:00
|
|
|
mapping of ISO 3166 territory codes to names
|
1999-02-02 20:26:31 +00:00
|
|
|
.It Pa /usr/share/zoneinfo
|
2011-05-20 17:35:10 +00:00
|
|
|
directory for zoneinfo files
|
2023-04-19 11:56:58 +00:00
|
|
|
.It Pa /usr/share/zoneinfo/zone1970.tab
|
2011-05-20 17:35:10 +00:00
|
|
|
mapping of timezone file to country and location
|
2009-10-20 06:54:31 +00:00
|
|
|
.It Pa /var/db/zoneinfo
|
2011-05-20 17:35:10 +00:00
|
|
|
saved name of the timezone file installed last
|
1996-01-24 00:11:58 +00:00
|
|
|
.El
|
2009-10-21 20:55:04 +00:00
|
|
|
.Sh EXAMPLES
|
|
|
|
Normal usage, to select the right zoneinfo file via the dialog-based
|
|
|
|
user interface:
|
2023-04-19 11:56:58 +00:00
|
|
|
.Pp
|
|
|
|
.Dl # tzsetup
|
2011-05-20 17:35:10 +00:00
|
|
|
.Pp
|
2009-10-21 20:55:04 +00:00
|
|
|
Install the file
|
|
|
|
.Pa /usr/share/zoneinfo/Australia/Sydney :
|
2011-05-20 17:35:10 +00:00
|
|
|
.Pp
|
2023-04-19 11:56:58 +00:00
|
|
|
.Dl "# tzsetup /usr/share/zoneinfo/Australia/Sydney"
|
|
|
|
.Pp
|
|
|
|
Install the zoneinfo file for Australia/Sydney, assumed to be located in
|
2009-10-21 20:55:04 +00:00
|
|
|
.Pa /usr/share/zoneinfo :
|
2023-04-19 11:56:58 +00:00
|
|
|
.Pp
|
|
|
|
.Dl "# tzsetup Australia/Sydney"
|
2011-05-20 17:35:10 +00:00
|
|
|
.Pp
|
2009-10-21 20:55:04 +00:00
|
|
|
After a reinstall of the zoneinfo files, you can reinstall the
|
2011-05-20 17:35:10 +00:00
|
|
|
latest installed zoneinfo file (as specified in
|
|
|
|
.Pa /var/db/zoneinfo ) :
|
2023-04-19 11:56:58 +00:00
|
|
|
.Pp
|
|
|
|
.Dl "# tzsetup -r"
|
1996-01-24 00:11:58 +00:00
|
|
|
.Sh SEE ALSO
|
1997-01-20 00:03:00 +00:00
|
|
|
.Xr date 1 ,
|
1996-01-24 00:11:58 +00:00
|
|
|
.Xr adjtime 2 ,
|
|
|
|
.Xr ctime 3 ,
|
|
|
|
.Xr timezone 3 ,
|
|
|
|
.Xr tzfile 5 ,
|
1997-01-20 00:03:00 +00:00
|
|
|
.Xr adjkerntz 8 ,
|
1996-01-24 00:11:58 +00:00
|
|
|
.Xr zdump 8 ,
|
2000-01-23 20:25:01 +00:00
|
|
|
.Xr zic 8
|
1999-02-02 20:26:31 +00:00
|
|
|
.Sh DISCLAIMER
|
|
|
|
The representation of certain localities as being associated with certain
|
|
|
|
countries and/or territories is for the purposes of identification only,
|
|
|
|
and does not imply any endorsement or rejection on the part of the
|
2000-11-14 11:20:58 +00:00
|
|
|
.Fx
|
1999-02-02 20:26:31 +00:00
|
|
|
Project of the territorial claims of any entity.
|
2005-01-18 20:02:45 +00:00
|
|
|
.Sh BUGS
|
|
|
|
Programs which are already running when
|
|
|
|
.Nm
|
|
|
|
creates or updates
|
|
|
|
.Pa /etc/localtime
|
|
|
|
will not reflect the updated timezone.
|
2023-04-19 11:56:58 +00:00
|
|
|
When the system is first configured for a non-UTC
|
2005-01-18 20:02:45 +00:00
|
|
|
hardware clock, it is necessary to run
|
|
|
|
.Xr adjkerntz 8
|
|
|
|
(which normally happens as a part of system startup) in order to update
|
|
|
|
the kernel's idea of the correct timezone offset.
|