proxmox-mirrors/systemd
1
0
Fork 0
mirror of https://git.proxmox.com/git/systemd synced 2025-05-30 03:06:13 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
e735f4d4ea
systemd/man/localectl.html
Martin Pitt e735f4d4ea Imported Upstream version 219
2015-02-17 11:22:16 +01:00

101 lines
12 KiB
HTML
Raw Blame History

<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>·
<a href="../libudev/index.html">libudev </a>·
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 219</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="idm140284591207968"></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="idm140284587367888"></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="locale.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="idm140284591280960"></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="idm140284577298976"></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="idm140284591279248"></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="locale.html"><span class="citerefentry"><span class="refentrytitle">locale</span>(7)</span></a>,
<a href="locale.conf.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="loadkeys.html"><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>
Reference in New Issue View Git Blame Copy Permalink