Debian Codegraph @

upstream/debian-unstable/man5/locale.conf.5

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