summaryrefslogtreecommitdiff
path: root/man/localectl.html
diff options
context:
space:
mode:
Diffstat (limited to 'man/localectl.html')
-rw-r--r--man/localectl.html100
1 files changed, 0 insertions, 100 deletions
diff --git a/man/localectl.html b/man/localectl.html
deleted file mode 100644
index c1c0f54ec7..0000000000
--- a/man/localectl.html
+++ /dev/null
@@ -1,100 +0,0 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>localectl</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
- a.headerlink {
- color: #c60f0f;
- font-size: 0.8em;
- padding: 0 4px 0 4px;
- text-decoration: none;
- visibility: hidden;
- }
-
- a.headerlink:hover {
- background-color: #c60f0f;
- color: white;
- }
-
- h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
- visibility: visible;
- }
- </style><a href="index.html">Index </a>·
- <a href="systemd.directives.html">Directives </a>·
- <a href="../python-systemd/index.html">Python </a>·
-
- <span style="float:right">systemd 221</span><hr><div class="refentry"><a name="localectl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>localectl — Control the system locale and keyboard layout settings</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">localectl</code> [OPTIONS...] {COMMAND}</p></div></div><div class="refsect1"><a name="idm47213327658176"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>localectl</strong></span> may be used to query and change
- the system locale and keyboard layout settings.</p><p>The system locale controls the language settings of system
- services and of the UI before the user logs in, such as the
- display manager, as well as the default for users after
- login.</p><p>The keyboard settings control the keyboard layout used on
- the text console and of the graphical UI before the user logs in,
- such as the display manager, as well as the default for users
- after login.</p><p>Use
- <a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
- to initialize the system locale for mounted (but not booted)
- system images.</p></div><div class="refsect1"><a name="idm47213328978320"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-ask-password"><span class="term"><code class="option">--no-ask-password</code></span><a class="headerlink" title="Permalink to this term" href="#--no-ask-password">¶</a></dt><dd><p>Do not query the user for authentication for
- privileged operations.</p></dd><dt id="--no-convert"><span class="term"><code class="option">--no-convert</code></span><a class="headerlink" title="Permalink to this term" href="#--no-convert">¶</a></dt><dd><p>If <span class="command"><strong>set-keymap</strong></span> or
- <span class="command"><strong>set-x11-keymap</strong></span> is invoked and this option
- is passed, then the keymap will not be converted from the
- console to X11, or X11 to console,
- respectively.</p></dd><dt id="-H"><span class="term"><code class="option">-H</code>, </span><span class="term"><code class="option">--host=</code></span><a class="headerlink" title="Permalink to this term" href="#-H">¶</a></dt><dd><p><a name="host-text"></a>Execute the operation remotely. Specify a hostname, or a
- username and hostname separated by "<code class="literal">@</code>", to
- connect to. The hostname may optionally be suffixed by a
- container name, separated by "<code class="literal">:</code>", which
- connects directly to a specific container on the specified
- host. This will use SSH to talk to the remote machine manager
- instance. Container names may be enumerated with
- <span class="command"><strong>machinectl -H
- <em class="replaceable"><code>HOST</code></em></strong></span>.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
- </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="status"><span class="term"><span class="command"><strong>status</strong></span></span><a class="headerlink" title="Permalink to this term" href="#status">¶</a></dt><dd><p>Show current settings of the system locale and
- keyboard mapping.</p></dd><dt id="set-locale LOCALE..."><span class="term"><span class="command"><strong>set-locale LOCALE...</strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-locale%20LOCALE...">¶</a></dt><dd><p>Set the system locale. This takes one or more
- assignments such as "LANG=de_DE.utf8",
- "LC_MESSAGES=en_GB.utf8", and so on. See
- <a href="http://man7.org/linux/man-pages/man7/locale.7.html"><span class="citerefentry"><span class="refentrytitle">locale</span>(7)</span></a>
- for details on the available settings and their meanings. Use
- <span class="command"><strong>list-locales</strong></span> for a list of available
- locales (see below). </p></dd><dt id="list-locales"><span class="term"><span class="command"><strong>list-locales</strong></span></span><a class="headerlink" title="Permalink to this term" href="#list-locales">¶</a></dt><dd><p>List available locales useful for
- configuration with
- <span class="command"><strong>set-locale</strong></span>.</p></dd><dt id="set-keymap MAP [TOGGLEMAP]"><span class="term"><span class="command"><strong>set-keymap MAP [TOGGLEMAP]</strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-keymap%20MAP%20%5BTOGGLEMAP%5D">¶</a></dt><dd><p>Set the system keyboard mapping for the
- console and X11. This takes a mapping name (such as "de" or
- "us"), and possibly a second one to define a toggle keyboard
- mapping. Unless <code class="option">--no-convert</code> is passed, the
- selected setting is also applied as the default system
- keyboard mapping of X11, after converting it to the closest
- matching X11 keyboard mapping. Use
- <span class="command"><strong>list-keymaps</strong></span> for a list of available
- keyboard mappings (see below).</p></dd><dt id="list-keymaps"><span class="term"><span class="command"><strong>list-keymaps</strong></span></span><a class="headerlink" title="Permalink to this term" href="#list-keymaps">¶</a></dt><dd><p>List available keyboard mappings for the
- console, useful for configuration with
- <span class="command"><strong>set-keymap</strong></span>.</p></dd><dt id="set-x11-keymap LAYOUT [MODEL [VARIANT [OPTIONS]]]"><span class="term"><span class="command"><strong>set-x11-keymap LAYOUT [MODEL [VARIANT [OPTIONS]]]</strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-x11-keymap%20LAYOUT%20%5BMODEL%20%5BVARIANT%20%5BOPTIONS%5D%5D%5D">¶</a></dt><dd><p>Set the system default keyboard mapping for
- X11 and the virtual console. This takes a keyboard mapping
- name (such as "<code class="literal">de</code>" or "<code class="literal">us</code>"),
- and possibly a model, variant, and options, see
- <a href="http://man7.org/linux/man-pages/man4/kbd.4.html"><span class="citerefentry"><span class="refentrytitle">kbd</span>(4)</span></a>
- for details. Unless <code class="option">--no-convert</code> is passed,
- the selected setting is also applied as the system console
- keyboard mapping, after converting it to the closest matching
- console keyboard mapping.</p></dd><dt id="list-x11-keymap-models"><span class="term"><span class="command"><strong>list-x11-keymap-models</strong></span>, </span><span class="term"><span class="command"><strong>list-x11-keymap-layouts</strong></span>, </span><span class="term"><span class="command"><strong>list-x11-keymap-variants [LAYOUT]</strong></span>, </span><span class="term"><span class="command"><strong>list-x11-keymap-options</strong></span></span><a class="headerlink" title="Permalink to this term" href="#list-x11-keymap-models">¶</a></dt><dd><p>List available X11 keymap models, layouts,
- variants and options, useful for configuration with
- <span class="command"><strong>set-keymap</strong></span>. The command
- <span class="command"><strong>list-x11-keymap-variants</strong></span> optionally takes a
- layout parameter to limit the output to the variants suitable
- for the specific layout.</p></dd></dl></div></div><div class="refsect1"><a name="idm47213324281104"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure code
- otherwise.</p></div><div class="refsect1"><a name="idm47213314645056"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$SYSTEMD_PAGER"><span class="term"><code class="varname">$SYSTEMD_PAGER</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_PAGER">¶</a></dt><dd><p>Pager to use when
- <code class="option">--no-pager</code> is not given;
- overrides <code class="varname">$PAGER</code>. Setting
- this to an empty string or the value
- "<code class="literal">cat</code>" is equivalent to passing
- <code class="option">--no-pager</code>.</p></dd><dt id="$SYSTEMD_LESS"><span class="term"><code class="varname">$SYSTEMD_LESS</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_LESS">¶</a></dt><dd><p>Override the default
- options passed to
- <span class="command"><strong>less</strong></span>
- ("<code class="literal">FRSXMK</code>").</p></dd></dl></div></div><div class="refsect1"><a name="idm47213324279456"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
- <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
- <a href="http://man7.org/linux/man-pages/man7/locale.7.html"><span class="citerefentry"><span class="refentrytitle">locale</span>(7)</span></a>,
- <a href="http://man7.org/linux/man-pages/man5/locale.conf.5.html"><span class="citerefentry"><span class="refentrytitle">locale.conf</span>(5)</span></a>,
- <a href="vconsole.conf.html"><span class="citerefentry"><span class="refentrytitle">vconsole.conf</span>(5)</span></a>,
- <a href="https://www.mankier.com/1/loadkeys"><span class="citerefentry"><span class="refentrytitle">loadkeys</span>(1)</span></a>,
- <a href="http://man7.org/linux/man-pages/man4/kbd.4.html"><span class="citerefentry"><span class="refentrytitle">kbd</span>(4)</span></a>,
- <a class="ulink" href="http://www.x.org/releases/current/doc/xorg-docs/input/XKB-Config.html" target="_top">
- The XKB Configuration Guide
- </a>,
- <a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
- <a href="systemd-localed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-localed.service</span>(8)</span></a>,
- <a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
- </p></div></div></body></html>