]> git.proxmox.com Git - systemd.git/blame - man/locale.conf.html
Imported Upstream version 220
[systemd.git] / man / locale.conf.html
CommitLineData
663996b3
MS
1<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>locale.conf</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
2 a.headerlink {
3 color: #c60f0f;
4 font-size: 0.8em;
5 padding: 0 4px 0 4px;
6 text-decoration: none;
7 visibility: hidden;
8 }
9
10 a.headerlink:hover {
11 background-color: #c60f0f;
12 color: white;
13 }
14
15 h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
16 visibility: visible;
17 }
18 </style><a href="index.html">Index </a>·
19 <a href="systemd.directives.html">Directives </a>·
20 <a href="../python-systemd/index.html">Python </a>·
21 <a href="../libudev/index.html">libudev </a>·
e3bff60a 22 <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 220</span><hr><div class="refentry"><a name="locale.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>locale.conf — Configuration file for locale settings</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/locale.conf</code></p></div><div class="refsect1"><a name="idm140553047869168"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>The <code class="filename">/etc/locale.conf</code> file configures
e735f4d4
MP
23 system-wide locale settings. It is read at early-boot by
24 <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>.</p><p>The basic file format of <code class="filename">locale.conf</code> is
25 a newline-separated list of environment-like shell-compatible
26 variable assignments. It is possible to source the configuration
27 from shell scripts, however, beyond mere variable assignments, no
28 shell features are supported, allowing applications to read the
29 file without implementing a shell compatible execution
30 engine.</p><p>Note that the kernel command line options
31 <code class="varname">locale.LANG=</code>,
32 <code class="varname">locale.LANGUAGE=</code>,
33 <code class="varname">locale.LC_CTYPE=</code>,
34 <code class="varname">locale.LC_NUMERIC=</code>,
35 <code class="varname">locale.LC_TIME=</code>,
36 <code class="varname">locale.LC_COLLATE=</code>,
37 <code class="varname">locale.LC_MONETARY=</code>,
38 <code class="varname">locale.LC_MESSAGES=</code>,
39 <code class="varname">locale.LC_PAPER=</code>,
40 <code class="varname">locale.LC_NAME=</code>,
41 <code class="varname">locale.LC_ADDRESS=</code>,
42 <code class="varname">locale.LC_TELEPHONE=</code>,
43 <code class="varname">locale.LC_MEASUREMENT=</code>,
44 <code class="varname">locale.LC_IDENTIFICATION=</code> may be
45 used to override the locale settings at boot.</p><p>The locale settings configured in
46 <code class="filename">/etc/locale.conf</code> are system-wide and are
47 inherited by every service or user, unless overridden or unset by
48 individual programs or individual users.</p><p>Depending on the operating system, other configuration files
49 might be checked for locale configuration as well, however only as
e3bff60a 50 fallback.</p><p><a href="http://man7.org/linux/man-pages/man1/localectl.1.html"><span class="citerefentry"><span class="refentrytitle">localectl</span>(1)</span></a>
e735f4d4
MP
51 may be used to alter the settings in this file during runtime from
52 the command line. Use
53 <a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
54 to initialize them on mounted (but not booted) system
e3bff60a 55 images.</p></div><div class="refsect1"><a name="idm140553046834048"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following locale settings may be set using
e735f4d4
MP
56 <code class="filename">/etc/locale.conf</code>:
57 <code class="varname">LANG=</code>,
58 <code class="varname">LANGUAGE=</code>,
59 <code class="varname">LC_CTYPE=</code>,
60 <code class="varname">LC_NUMERIC=</code>,
61 <code class="varname">LC_TIME=</code>,
62 <code class="varname">LC_COLLATE=</code>,
63 <code class="varname">LC_MONETARY=</code>,
64 <code class="varname">LC_MESSAGES=</code>,
65 <code class="varname">LC_PAPER=</code>,
66 <code class="varname">LC_NAME=</code>,
67 <code class="varname">LC_ADDRESS=</code>,
68 <code class="varname">LC_TELEPHONE=</code>,
69 <code class="varname">LC_MEASUREMENT=</code>,
70 <code class="varname">LC_IDENTIFICATION=</code>.
71 Note that <code class="varname">LC_ALL</code> may not be configured in this
72 file. For details about the meaning and semantics of these
73 settings, refer to
e3bff60a
MP
74 <a href="http://man7.org/linux/man-pages/man7/locale.7.html"><span class="citerefentry"><span class="refentrytitle">locale</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm140553046825360"></a><h2 id="Example">Example<a class="headerlink" title="Permalink to this headline" href="#Example">¶</a></h2><div class="example"><a name="idm140553046824720"></a><p class="title"><b>Example 1. German locale with English messages</b></p><div class="example-contents"><p><code class="filename">/etc/locale.conf</code>:</p><pre class="programlisting">LANG=de_DE.UTF-8
75LC_MESSAGES=en_US.UTF-8</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm140553046822320"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
e735f4d4 76 <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
e3bff60a
MP
77 <a href="http://man7.org/linux/man-pages/man7/locale.7.html"><span class="citerefentry"><span class="refentrytitle">locale</span>(7)</span></a>,
78 <a href="http://man7.org/linux/man-pages/man1/localectl.1.html"><span class="citerefentry"><span class="refentrytitle">localectl</span>(1)</span></a>,
e735f4d4
MP
79 <a href="systemd-localed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-localed.service</span>(8)</span></a>,
80 <a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
81 </p></div></div></body></html>