Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
TZSETUP(8)		FreeBSD	System Manager's Manual		    TZSETUP(8)

NAME
     tzsetup --	set local timezone

SYNOPSIS
     tzsetup [-nrs] [-C	chroot_directory] [zoneinfo_file | zoneinfo_name]

DESCRIPTION
     The tzsetup 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 tzsetup utility also determines whether any
     adjustment	is necessary for systems where the hardware clock does not
     keep UTC.

     The following options are available:

	   -C chroot_directory
		       Open all	files and directories relative to
		       chroot_directory.

	   -n	       Do not create or	copy files.

	   -r	       Reinstall the zoneinfo file installed last time.	 The
		       name is obtained	from /var/db/zoneinfo.

	   -s	       Skip the	initial	question about adjusting the clock if
		       not set to UTC.

     It	is possible to short-circuit the menu system by	specifying the loca-
     tion of a zoneinfo_file or	the name of the	zoneinfo_name on the command
     line; this	is intended mainly for pre-configured installation scripts or
     people who	know which zoneinfo they want to install.

TIMEZONE DATABASE
     The contents of the timezone database are indexed by
     /usr/share/zoneinfo/zone.tab.  This file lists, for each timezone data
     file, the ISO 3166	territory code,	approximate geographical coordinates
     (in ISO 6709 format), and location	within the territory.

     The maintainers of	the database maintain the following policies:

	   1.	At least one zone for every country or inhabited geographical
		territory.

	   2.	One zone for every distinct, documented	timezone history since
		the beginning of the UNIX epoch	(January 1, 1970, GMT).

	   3.	Each zone is named for the most	populous city therein.	(Where
		possible, the database includes	pre-1970 history for its
		city.)
     The source	code to	the database (/usr/src/share/zoneinfo/[a-z]*) contains
     many additional comments and documentation	references for the histori-
     cally minded.

FILES
     /etc/localtime		   current time	zone file
     /etc/wall_cmos_clock	   see adjkerntz(8)
     /usr/share/misc/iso3166	   mapping of ISO 3166 territory codes to
				   names
     /usr/share/zoneinfo	   directory for zoneinfo files
     /usr/share/zoneinfo/zone.tab  mapping of timezone file to country and
				   location
     /var/db/zoneinfo		   saved name of the timezone file installed
				   last

EXAMPLES
     Normal usage, to select the right zoneinfo	file via the dialog-based user
     interface:
	   tzsetup

     Install the file /usr/share/zoneinfo/Australia/Sydney:
	   tzsetup /usr/share/zoneinfo/Australia/Sydney

     Install the zoneinfo file for Australia/Sydney, assumed to	be located in
     /usr/share/zoneinfo:
	   tzsetup Australia/Sydney

     After a reinstall of the zoneinfo files, you can reinstall	the latest
     installed zoneinfo	file (as specified in /var/db/zoneinfo):
	   tzsetup -r

SEE ALSO
     date(1), adjtime(2), ctime(3), timezone(3), tzfile(5), adjkerntz(8),
     zdump(8), zic(8)

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
     FreeBSD Project of	the territorial	claims of any entity.

BUGS
     Programs which are	already	running	when tzsetup creates or	updates
     /etc/localtime will not reflect the updated timezone.  When the system is
     first configured for a non-UTC hardware clock, it is necessary to run
     adjkerntz(8) (which normally happens as a part of system startup) in
     order to update the kernel's idea of the correct timezone offset.

FreeBSD	9.3		       October 21, 2009			   FreeBSD 9.3

NAME | SYNOPSIS | DESCRIPTION | TIMEZONE DATABASE | FILES | EXAMPLES | SEE ALSO | DISCLAIMER | BUGS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=tzsetup&sektion=8&manpath=FreeBSD+9.2-RELEASE>

home | help