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