Penguin
Recent Changes
Annotated edit history of tzsetup(8) version 5, including all changes. View license author blame.
Rev Author # Line
1 perry 1 TZSETUP
2 !!!TZSETUP
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 A WORD OF WARNING
7 Internals
8 FILES
9 DERIVATION
10 SEE ALSO
11 AUTHOR
12 ----
13 !!NAME
14
15
16 tzsetup - set the local timezone
17 !!SYNOPSIS
18
19
20 __tzsetup [[-y] [[-g]__
21 !!DESCRIPTION
22
23
24 This manual page explains how you can use the __tzsetup__
25 utility to set the local timezone. This is necessary to let
26 your system know about the difference between system time
27 and local time (the time in the real world). It is also
28 necessary to make your system behave nicely when your
29 location uses Daylight Savings Time.
30
31
32 A valid system time together with the correct local time
33 zone will give you best performance and highest
34 reliablility. It is especially important in a network
35 environment, where even small time differences can make a
36 mirror refetch a whole ftp site, or where time stamps on
37 external file systems are used.
38
39
40 __tzsetup__ is typically called without any parameters
41 from the shell. Optionally, the -y parameter can be used, to
42 make it always change your time zone without asking first.
43 The -g parameter can also be used, to make it ask if the
44 hardware clock is set to gmt or not.
45
46
47 After you made your choice, __tzsetup__ will try to
48 change the timezone for you. See the __Internals__
49 section below for technical details. You must have root
50 privilegies to actually change anything. Please use
51 tzselect(1) as a user space command to just look at
52 the timezones. It will print the local time in any timezone
53 recognized by the system.
54 !!A WORD OF WARNING
55
56
57 What timezone is correct for your system? It depends on the
58 geographical location of the machine. Getting the correct
59 location is important, but the system must also know how
60 your hardware clock is set. Most DOS based PCs set their
61 hardware clock on Local Time, while most UNIX systems set
62 their hardware clock to UTC.
63
64
65 The Debian GNU/Linux system gains its knowledge of this
66 setting from the file ''/etc/default/rcS''. This file
67 contains either the line __UTC=yes__, which indicates
68 that the hardware clock is set to UTC, or it contains the
69 line __UTC=no__, which declares the hardware clock is set
70 to Local Time. If these setting are correct, and the
71 hardware clock is truely set as indicated, then configuring
72 the proper timezone for the machine will cause the proper
73 date and time to be displayed. If these are not set
74 correctly, the the reported time will be quite incorrect.
75 See hwclock(8) for more details on this
76 topic.
77 !!Internals
78
79
80 The work done by __tzsetup__ is actually pretty simple.
81 It just updates the link ''/etc/localtime'' to point to
82 the correct timezone installed in
83 ''/usr/share/zoneinfo/''.
84
85
86 There is nothing wrong with doing this manually. However,
87 using __tzsetup__ you don't have to remember the path to
88 the timezones.
89 !!FILES
90
91
92 ''/etc/timezone /etc/localtime
93 /usr/share/zoneinfo''
94 !!DERIVATION
95
96
97 This program is based on tzconfig(8) -- the only
98 major difference is that this program uses debconf for its
99 user interface, and that it allows configuration of
100 GMT.
101 !!SEE ALSO
102
103
5 AristotlePagaltzis 104 hwclock(8) tzselect(8) rcS(5)
1 perry 105 tzconfig(8)
106 !!AUTHOR
107
108
109 Joey Hess
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

PHP Warning

lib/blame.php:177: Warning: Invalid argument supplied for foreach()