man/localtime.5

   1 '\" t
   2 .TH "LOCALTIME" "5" "" "systemd 219" "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 The timezone may be overridden for individual programs by using the
  45 \fI$TZ\fR
  46 environment variable\&. See
  47 \fBenviron\fR(7)\&.
  48 .PP
  49 You may use
  50 \fBtimedatectl\fR(1)
  51 to change the settings of this file from the command line during runtime\&. Use
  52 \fBsystemd-firstboot\fR(1)
  53 to initialize the time zone on mounted (but not booted) system images\&.
  54 .SH "SEE ALSO"
  55 .PP
  56 \fBsystemd\fR(1),
  57 \fBtzset\fR(3),
  58 \fBlocaltime\fR(3),
  59 \fBtimedatectl\fR(1),
  60 \fBsystemd-timedated.service\fR(8),
  61 \fBsystemd-firstboot\fR(1)