man/localectl.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
   4 <!ENTITY % entities SYSTEM "custom-entities.ent" >
   5 %entities;
   6 ]>
   7
   8 <!--
   9   This file is part of systemd.
  10
  11   Copyright 2012 Lennart Poettering
  12
  13   systemd is free software; you can redistribute it and/or modify it
  14   under the terms of the GNU Lesser General Public License as published by
  15   the Free Software Foundation; either version 2.1 of the License, or
  16   (at your option) any later version.
  17
  18   systemd is distributed in the hope that it will be useful, but
  19   WITHOUT ANY WARRANTY; without even the implied warranty of
  20   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  21   Lesser General Public License for more details.
  22
  23   You should have received a copy of the GNU Lesser General Public License
  24   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  25 -->
  26
  27 <refentry id="localectl" conditional='ENABLE_LOCALED'
  28     xmlns:xi="http://www.w3.org/2001/XInclude">
  29
  30   <refentryinfo>
  31     <title>localectl</title>
  32     <productname>systemd</productname>
  33
  34     <authorgroup>
  35       <author>
  36         <contrib>Developer</contrib>
  37         <firstname>Lennart</firstname>
  38         <surname>Poettering</surname>
  39         <email>lennart@poettering.net</email>
  40       </author>
  41     </authorgroup>
  42   </refentryinfo>
  43
  44   <refmeta>
  45     <refentrytitle>localectl</refentrytitle>
  46     <manvolnum>1</manvolnum>
  47   </refmeta>
  48
  49   <refnamediv>
  50     <refname>localectl</refname>
  51     <refpurpose>Control the system locale and keyboard layout settings</refpurpose>
  52   </refnamediv>
  53
  54   <refsynopsisdiv>
  55     <cmdsynopsis>
  56       <command>localectl</command>
  57       <arg choice="opt" rep="repeat">OPTIONS</arg>
  58       <arg choice="req">COMMAND</arg>
  59     </cmdsynopsis>
  60   </refsynopsisdiv>
  61
  62   <refsect1>
  63     <title>Description</title>
  64
  65     <para><command>localectl</command> may be used to query and change
  66     the system locale and keyboard layout settings.</para>
  67
  68     <para>The system locale controls the language settings of system
  69     services and of the UI before the user logs in, such as the
  70     display manager, as well as the default for users after
  71     login.</para>
  72
  73     <para>The keyboard settings control the keyboard layout used on
  74     the text console and of the graphical UI before the user logs in,
  75     such as the display manager, as well as the default for users
  76     after login.</para>
  77
  78     <para>Use
  79     <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  80     to initialize the system locale for mounted (but not booted)
  81     system images.</para>
  82   </refsect1>
  83
  84   <refsect1>
  85     <title>Options</title>
  86
  87     <para>The following options are understood:</para>
  88
  89     <variablelist>
  90       <varlistentry>
  91         <term><option>--no-ask-password</option></term>
  92
  93         <listitem><para>Do not query the user for authentication for
  94         privileged operations.</para></listitem>
  95       </varlistentry>
  96
  97       <varlistentry>
  98         <term><option>--no-convert</option></term>
  99
 100         <listitem><para>If <command>set-keymap</command> or
 101         <command>set-x11-keymap</command> is invoked and this option
 102         is passed, then the keymap will not be converted from the
 103         console to X11, or X11 to console,
 104         respectively.</para></listitem>
 105       </varlistentry>
 106
 107       <xi:include href="user-system-options.xml" xpointer="host" />
 108
 109       <xi:include href="standard-options.xml" xpointer="help" />
 110       <xi:include href="standard-options.xml" xpointer="version" />
 111       <xi:include href="standard-options.xml" xpointer="no-pager" />
 112     </variablelist>
 113
 114     <para>The following commands are understood:</para>
 115
 116     <variablelist>
 117       <varlistentry>
 118         <term><command>status</command></term>
 119
 120         <listitem><para>Show current settings of the system locale and
 121         keyboard mapping.</para></listitem>
 122       </varlistentry>
 123
 124       <varlistentry>
 125         <term><command>set-locale LOCALE...</command></term>
 126
 127         <listitem><para>Set the system locale. This takes one or more
 128         assignments such as "LANG=de_DE.utf8",
 129         "LC_MESSAGES=en_GB.utf8", and so on. See
 130         <citerefentry project='man-pages'><refentrytitle>locale</refentrytitle><manvolnum>7</manvolnum></citerefentry>
 131         for details on the available settings and their meanings. Use
 132         <command>list-locales</command> for a list of available
 133         locales (see below). </para></listitem>
 134       </varlistentry>
 135
 136       <varlistentry>
 137         <term><command>list-locales</command></term>
 138
 139         <listitem><para>List available locales useful for
 140         configuration with
 141         <command>set-locale</command>.</para></listitem>
 142       </varlistentry>
 143
 144       <varlistentry>
 145         <term><command>set-keymap MAP [TOGGLEMAP]</command></term>
 146
 147         <listitem><para>Set the system keyboard mapping for the
 148         console and X11. This takes a mapping name (such as "de" or
 149         "us"), and possibly a second one to define a toggle keyboard
 150         mapping. Unless <option>--no-convert</option> is passed, the
 151         selected setting is also applied as the default system
 152         keyboard mapping of X11, after converting it to the closest
 153         matching X11 keyboard mapping. Use
 154         <command>list-keymaps</command> for a list of available
 155         keyboard mappings (see below).</para></listitem>
 156       </varlistentry>
 157
 158       <varlistentry>
 159         <term><command>list-keymaps</command></term>
 160
 161         <listitem><para>List available keyboard mappings for the
 162         console, useful for configuration with
 163         <command>set-keymap</command>.</para></listitem>
 164       </varlistentry>
 165
 166       <varlistentry>
 167         <term><command>set-x11-keymap LAYOUT [MODEL [VARIANT [OPTIONS]]]</command></term>
 168
 169         <listitem><para>Set the system default keyboard mapping for
 170         X11 and the virtual console. This takes a keyboard mapping
 171         name (such as <literal>de</literal> or <literal>us</literal>),
 172         and possibly a model, variant, and options, see
 173         <citerefentry><refentrytitle>kbd</refentrytitle><manvolnum>4</manvolnum></citerefentry>
 174         for details. Unless <option>--no-convert</option> is passed,
 175         the selected setting is also applied as the system console
 176         keyboard mapping, after converting it to the closest matching
 177         console keyboard mapping.</para></listitem>
 178       </varlistentry>
 179
 180       <varlistentry>
 181         <term><command>list-x11-keymap-models</command></term>
 182         <term><command>list-x11-keymap-layouts</command></term>
 183         <term><command>list-x11-keymap-variants [LAYOUT]</command></term>
 184         <term><command>list-x11-keymap-options</command></term>
 185
 186         <listitem><para>List available X11 keymap models, layouts,
 187         variants and options, useful for configuration with
 188         <command>set-keymap</command>. The command
 189         <command>list-x11-keymap-variants</command> optionally takes a
 190         layout parameter to limit the output to the variants suitable
 191         for the specific layout.</para></listitem>
 192       </varlistentry>
 193     </variablelist>
 194
 195   </refsect1>
 196
 197   <refsect1>
 198     <title>Exit status</title>
 199
 200     <para>On success, 0 is returned, a non-zero failure code
 201     otherwise.</para>
 202   </refsect1>
 203
 204   <xi:include href="less-variables.xml" />
 205
 206   <refsect1>
 207     <title>See Also</title>
 208     <para>
 209       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 210       <citerefentry project='man-pages'><refentrytitle>locale</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
 211       <citerefentry project='man-pages'><refentrytitle>locale.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
 212       <citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
 213       <citerefentry project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 214       <citerefentry><refentrytitle>kbd</refentrytitle><manvolnum>4</manvolnum></citerefentry>,
 215       <ulink url="http://www.x.org/releases/current/doc/xorg-docs/input/XKB-Config.html">
 216         The XKB Configuration Guide
 217       </ulink>,
 218       <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 219       <citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 220       <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 221     </para>
 222   </refsect1>
 223
 224 </refentry>