diff options
Diffstat (limited to 'usr.sbin/tzsetup/tzsetup.8')
| -rw-r--r-- | usr.sbin/tzsetup/tzsetup.8 | 132 |
1 files changed, 132 insertions, 0 deletions
diff --git a/usr.sbin/tzsetup/tzsetup.8 b/usr.sbin/tzsetup/tzsetup.8 new file mode 100644 index 0000000000000..09d842f24a456 --- /dev/null +++ b/usr.sbin/tzsetup/tzsetup.8 @@ -0,0 +1,132 @@ +.\" Copyright (c) 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. +.\" All rights reserved. +.\" +.\" 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. +.\" +.\" 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. +.\" +.\" $FreeBSD$ +.Dd January 24, 1996 +.Dt TZSETUP 8 +.Os +.Sh NAME +.Nm tzsetup +.Nd set local timezone +.Sh SYNOPSIS +.Nm +.Op Fl n +.Op Ar default +.Sh DESCRIPTION +The +.Nm +utility reads a database of timezone information and presents a menu +allowing the user to select a specific zone without knowing the details +of the database layout. +The selected zone is installed as the system +default zone. +The +.Nm +utility also determines whether any adjustment is necessary for systems where +the hardware clock does not keep +.Tn UTC . +.Pp +The following option is available: +.Bl -tag -offset indent -width Fl +.It Fl n +Do not create or copy files. +.El +.Pp +It is possible to short-circuit the menu system by specifying a +.Ar default +on the command line; this is intended mainly for pre-configured +installation scripts. +.Sh TIMEZONE DATABASE +The contents of the timezone database are indexed by +.Pa /usr/share/zoneinfo/zone.tab . +This file lists, for each timezone data file, the +.Tn ISO +3166 territory code, approximate geographical coordinates +(in +.Tn ISO +6709 format), +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 +epoch (January 1, 1970, +.Tn GMT ) . +.It +Each zone is named for the most populous city therein. +(Where possible, +the database includes pre-1970 history for its city.) +.El +The source code to the database +.Pq Pa /usr/src/share/zoneinfo/[a-z]* +contains many additional comments and documentation references for the +historically minded. +.Sh BUGS +Programs which are already running when +.Nm +creates or updates +.Pa /etc/localtime +will not reflect the updated timezone. +When the system is first configured for a +.Pf non- Tn UTC +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. +.Sh FILES +.Bl -tag -width /usr/share/zoneinfo/zone.tab -compact +.It Pa /etc/localtime +current time zone file +.It Pa /etc/wall_cmos_clock +see +.Xr adjkerntz 8 . +.It Pa /usr/share/misc/iso3166 +mapping of +.Tn ISO +3166 territory codes to names +.It Pa /usr/share/zoneinfo +directory for zoneinfo files +.It Pa /usr/share/zoneinfo/zone.tab +mapping of timezone file to country and location +.El +.Sh SEE ALSO +.Xr date 1 , +.Xr adjtime 2 , +.Xr ctime 3 , +.Xr timezone 3 , +.Xr tzfile 5 , +.Xr adjkerntz 8 , +.Xr zdump 8 , +.Xr zic 8 +.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 +.Fx +Project of the territorial claims of any entity. |