Debian Codegraph @

upstream/debian-unstable/man5/localtime.5

raw
1 '\" t
2 .TH "LOCALTIME" "5" "" "systemd 261~rc3" "localtime"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 localtime \- Local timezone configuration file
24 .SH "SYNOPSIS"
25 .PP
26 /etc/localtime
27 \->
28 \&.\&./usr/share/zoneinfo/\&...
29 .SH "DESCRIPTION"
30 .PP
31 The
32 /etc/localtime
33 file configures the system\-wide timezone of the local system that is used by applications for presentation to the user\&. It should be an absolute or relative symbolic link pointing to
34 /usr/share/zoneinfo/, followed by a timezone identifier such as
35 "Europe/Berlin"
36 or
37 "Etc/UTC"\&. The resulting link should lead to the corresponding binary
38 \fBtzfile\fR(5)
39 timezone data for the configured timezone\&.
40 .PP
41 Because the timezone identifier is extracted from the symlink target name of
42 /etc/localtime, this file may not be a normal file or hardlink\&.
43 .PP
44 If
45 /etc/localtime
46 is missing, the default
47 "UTC"
48 timezone is used\&.
49 .PP
50 The timezone may be overridden for individual programs by using the
51 \fI$TZ\fR
52 environment variable\&. See
53 \fBenviron\fR(7)\&.
54 .PP
55 You may use
56 \fBtimedatectl\fR(1)
57 to change the settings of this file from the command line during runtime\&. Use
58 \fBsystemd-firstboot\fR(1)
59 to initialize the time zone on mounted (but not booted) system images\&.
60 .SH "SEE ALSO"
61 .PP
62 \fBsystemd\fR(1), \fBtzset\fR(3), \fBlocaltime\fR(3), \fBtimedatectl\fR(1), \fBsystemd-timedated.service\fR(8), \fBsystemd-firstboot\fR(1)