man/locale.conf.5

   1 '\" t
   2 .TH "LOCALE\&.CONF" "5" "" "systemd 220" "locale.conf"
   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 locale.conf \- Configuration file for locale settings
  24 .SH "SYNOPSIS"
  25 .PP
  26 /etc/locale\&.conf
  27 .SH "DESCRIPTION"
  28 .PP
  29 The
  30 /etc/locale\&.conf
  31 file configures system\-wide locale settings\&. It is read at early\-boot by
  32 \fBsystemd\fR(1)\&.
  33 .PP
  34 The basic file format of
  35 locale\&.conf
  36 is a newline\-separated list of environment\-like shell\-compatible variable assignments\&. It is possible to source the configuration from shell scripts, however, beyond mere variable assignments, no shell features are supported, allowing applications to read the file without implementing a shell compatible execution engine\&.
  37 .PP
  38 Note that the kernel command line options
  39 \fIlocale\&.LANG=\fR,
  40 \fIlocale\&.LANGUAGE=\fR,
  41 \fIlocale\&.LC_CTYPE=\fR,
  42 \fIlocale\&.LC_NUMERIC=\fR,
  43 \fIlocale\&.LC_TIME=\fR,
  44 \fIlocale\&.LC_COLLATE=\fR,
  45 \fIlocale\&.LC_MONETARY=\fR,
  46 \fIlocale\&.LC_MESSAGES=\fR,
  47 \fIlocale\&.LC_PAPER=\fR,
  48 \fIlocale\&.LC_NAME=\fR,
  49 \fIlocale\&.LC_ADDRESS=\fR,
  50 \fIlocale\&.LC_TELEPHONE=\fR,
  51 \fIlocale\&.LC_MEASUREMENT=\fR,
  52 \fIlocale\&.LC_IDENTIFICATION=\fR
  53 may be used to override the locale settings at boot\&.
  54 .PP
  55 The locale settings configured in
  56 /etc/locale\&.conf
  57 are system\-wide and are inherited by every service or user, unless overridden or unset by individual programs or individual users\&.
  58 .PP
  59 Depending on the operating system, other configuration files might be checked for locale configuration as well, however only as fallback\&.
  60 .PP
  61 \fBlocalectl\fR(1)
  62 may be used to alter the settings in this file during runtime from the command line\&. Use
  63 \fBsystemd-firstboot\fR(1)
  64 to initialize them on mounted (but not booted) system images\&.
  65 .SH "OPTIONS"
  66 .PP
  67 The following locale settings may be set using
  68 /etc/locale\&.conf:
  69 \fILANG=\fR,
  70 \fILANGUAGE=\fR,
  71 \fILC_CTYPE=\fR,
  72 \fILC_NUMERIC=\fR,
  73 \fILC_TIME=\fR,
  74 \fILC_COLLATE=\fR,
  75 \fILC_MONETARY=\fR,
  76 \fILC_MESSAGES=\fR,
  77 \fILC_PAPER=\fR,
  78 \fILC_NAME=\fR,
  79 \fILC_ADDRESS=\fR,
  80 \fILC_TELEPHONE=\fR,
  81 \fILC_MEASUREMENT=\fR,
  82 \fILC_IDENTIFICATION=\fR\&. Note that
  83 \fILC_ALL\fR
  84 may not be configured in this file\&. For details about the meaning and semantics of these settings, refer to
  85 \fBlocale\fR(7)\&.
  86 .SH "EXAMPLE"
  87 .PP
  88 \fBExample\ \&1.\ \&German locale with English messages\fR
  89 .PP
  90 /etc/locale\&.conf:
  91 .sp
  92 .if n \{\
  93 .RS 4
  94 .\}
  95 .nf
  96 LANG=de_DE\&.UTF\-8
  97 LC_MESSAGES=en_US\&.UTF\-8
  98 .fi
  99 .if n \{\
 100 .RE
 101 .\}
 102 .SH "SEE ALSO"
 103 .PP
 104 \fBsystemd\fR(1),
 105 \fBlocale\fR(7),
 106 \fBlocalectl\fR(1),
 107 \fBsystemd-localed.service\fR(8),
 108 \fBsystemd-firstboot\fR(1)