15a80fb27SWolfram Schneider.\" Copyright (c) 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. 25a80fb27SWolfram Schneider.\" All rights reserved. 38eeb71d7SWolfram Schneider.\" 45a80fb27SWolfram Schneider.\" Redistribution and use in source and binary forms, with or without 55a80fb27SWolfram Schneider.\" modification, are permitted provided that the following conditions 65a80fb27SWolfram Schneider.\" are met: 75a80fb27SWolfram Schneider.\" 1. Redistributions of source code must retain the above copyright 85a80fb27SWolfram Schneider.\" notice, this list of conditions and the following disclaimer. 95a80fb27SWolfram Schneider.\" 2. Redistributions in binary form must reproduce the above copyright 105a80fb27SWolfram Schneider.\" notice, this list of conditions and the following disclaimer in the 115a80fb27SWolfram Schneider.\" documentation and/or other materials provided with the distribution. 128eeb71d7SWolfram Schneider.\" 135a80fb27SWolfram Schneider.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 145a80fb27SWolfram Schneider.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 155a80fb27SWolfram Schneider.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 165a80fb27SWolfram Schneider.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 175a80fb27SWolfram Schneider.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 185a80fb27SWolfram Schneider.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 195a80fb27SWolfram Schneider.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 205a80fb27SWolfram Schneider.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 215a80fb27SWolfram Schneider.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 225a80fb27SWolfram Schneider.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 235a80fb27SWolfram Schneider.\" SUCH DAMAGE. 245a80fb27SWolfram Schneider.\" 2597d92980SPeter Wemm.\" $FreeBSD$ 26d0dff61cSSteve Price.Dd January 24, 1996 278eeb71d7SWolfram Schneider.Dt TZSETUP 8 28a4c37c81SRuslan Ermilov.Os 298eeb71d7SWolfram Schneider.Sh NAME 308eeb71d7SWolfram Schneider.Nm tzsetup 318eeb71d7SWolfram Schneider.Nd set local timezone 32342afc34SPhilippe Charnier.Sh SYNOPSIS 33e97407b4SRuslan Ermilov.Nm 34342afc34SPhilippe Charnier.Op Fl n 35239e57d0SGarrett Wollman.Op Ar default 36342afc34SPhilippe Charnier.Sh DESCRIPTION 37239e57d0SGarrett WollmanThe 38342afc34SPhilippe Charnier.Nm 39490d5836SPhilippe Charnierutility reads a database of timezone information and presents a menu 40239e57d0SGarrett Wollmanallowing the user to select a specific zone without knowing the details 41239e57d0SGarrett Wollmanof the database layout. The selected zone is installed as the system 42239e57d0SGarrett Wollmandefault zone. 43490d5836SPhilippe CharnierThe 44239e57d0SGarrett Wollman.Nm 45490d5836SPhilippe Charnierutility also determines whether any adjustment is necessary for systems where 46239e57d0SGarrett Wollmanthe hardware clock does not keep 47239e57d0SGarrett Wollman.Tn UTC . 48342afc34SPhilippe Charnier.Pp 49342afc34SPhilippe CharnierThe following option is available: 50239e57d0SGarrett Wollman.Bl -tag -offset indent -width Fl 51342afc34SPhilippe Charnier.It Fl n 52239e57d0SGarrett WollmanDo not create or copy files. 53342afc34SPhilippe Charnier.El 54239e57d0SGarrett Wollman.Pp 55239e57d0SGarrett WollmanIt is possible to short-circuit the menu system by specifying a 56239e57d0SGarrett Wollman.Ar default 57239e57d0SGarrett Wollmanon the command line; this is intended mainly for pre-configured 58239e57d0SGarrett Wollmaninstallation scripts. 59239e57d0SGarrett Wollman.Sh TIMEZONE DATABASE 60239e57d0SGarrett WollmanThe contents of the timezone database are indexed by 61239e57d0SGarrett Wollman.Pa /usr/share/zoneinfo/zone.tab . 62239e57d0SGarrett WollmanThis file lists, for each timezone data file, the 63239e57d0SGarrett Wollman.Tn ISO 64239e57d0SGarrett Wollman3166 territory code, approximate geographical coordinates 65c4d9468eSRuslan Ermilov(in 66c4d9468eSRuslan Ermilov.Tn ISO 67c4d9468eSRuslan Ermilov6709 format), 68239e57d0SGarrett Wollmanand location within the territory. 69239e57d0SGarrett Wollman.Pp 70239e57d0SGarrett WollmanThe maintainers of the database maintain the following policies: 71239e57d0SGarrett Wollman.Bl -enum -offset indent 72239e57d0SGarrett Wollman.It 73239e57d0SGarrett WollmanAt least one zone for every country or inhabited geographical territory. 74239e57d0SGarrett Wollman.It 75239e57d0SGarrett WollmanOne zone for every distinct, documented timezone history since the 76239e57d0SGarrett Wollmanbeginning of the 77239e57d0SGarrett Wollman.Ux 78239e57d0SGarrett Wollmanepoch (January 1, 1970, 79239e57d0SGarrett Wollman.Tn GMT ) . 80239e57d0SGarrett Wollman.It 81239e57d0SGarrett WollmanEach zone is named for the most populous city therein. (Where possible, 82239e57d0SGarrett Wollmanthe database includes pre-1970 history for its city.) 83239e57d0SGarrett Wollman.El 84239e57d0SGarrett WollmanThe source code to the database 85239e57d0SGarrett Wollman.Pq Pa /usr/src/share/zoneinfo/[a-z]* 86239e57d0SGarrett Wollmancontains many additional comments and documentation references for the 87239e57d0SGarrett Wollmanhistorically minded. 888eeb71d7SWolfram Schneider.Sh BUGS 89239e57d0SGarrett WollmanPrograms which are already running when 90239e57d0SGarrett Wollman.Nm 91239e57d0SGarrett Wollmancreates or updates 92239e57d0SGarrett Wollman.Pa /etc/localtime 93239e57d0SGarrett Wollmanwill not reflect the updated timezone. 94239e57d0SGarrett WollmanWhen the system is first configured for a 95239e57d0SGarrett Wollman.Pf non- Tn UTC 96239e57d0SGarrett Wollmanhardware clock, it is necessary to run 97239e57d0SGarrett Wollman.Xr adjkerntz 8 98239e57d0SGarrett Wollman(which normally happens as a part of system startup) in order to update 99239e57d0SGarrett Wollmanthe kernel's idea of the correct timezone offset. 1008eeb71d7SWolfram Schneider.Sh FILES 101239e57d0SGarrett Wollman.Bl -tag -width /usr/share/zoneinfo/zone.tab -compact 1028eeb71d7SWolfram Schneider.It Pa /etc/localtime 1038eeb71d7SWolfram Schneidercurrent time zone file 1048eeb71d7SWolfram Schneider.It Pa /etc/wall_cmos_clock 105342afc34SPhilippe Charniersee 106342afc34SPhilippe Charnier.Xr adjkerntz 8 . 107239e57d0SGarrett Wollman.It Pa /usr/share/misc/iso3166 108239e57d0SGarrett Wollmanmapping of 109239e57d0SGarrett Wollman.Tn ISO 110239e57d0SGarrett Wollman3166 territory codes to names 111239e57d0SGarrett Wollman.It Pa /usr/share/zoneinfo 112239e57d0SGarrett Wollmandirectory for zoneinfo files 113239e57d0SGarrett Wollman.It Pa /usr/share/zoneinfo/zone.tab 114239e57d0SGarrett Wollmanmapping of timezone file to country and location 1158eeb71d7SWolfram Schneider.El 1168eeb71d7SWolfram Schneider.Sh SEE ALSO 117bfd34a4aSWolfram Schneider.Xr date 1 , 1188eeb71d7SWolfram Schneider.Xr adjtime 2 , 1198eeb71d7SWolfram Schneider.Xr ctime 3 , 1208eeb71d7SWolfram Schneider.Xr timezone 3 , 1218eeb71d7SWolfram Schneider.Xr tzfile 5 , 122bfd34a4aSWolfram Schneider.Xr adjkerntz 8 , 1238eeb71d7SWolfram Schneider.Xr zdump 8 , 124bb897a87SPhilippe Charnier.Xr zic 8 125239e57d0SGarrett Wollman.Sh DISCLAIMER 126239e57d0SGarrett WollmanThe representation of certain localities as being associated with certain 127239e57d0SGarrett Wollmancountries and/or territories is for the purposes of identification only, 128239e57d0SGarrett Wollmanand does not imply any endorsement or rejection on the part of the 129b5c508fbSRuslan Ermilov.Fx 130239e57d0SGarrett WollmanProject of the territorial claims of any entity. 131