<?xml version='1.0'?> <!--*-nxml-*-->

<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<refentry id="localectl" conditional='ENABLE_LOCALED'

xmlns:xi="http://www.w3.org/2001/XInclude">

<refentryinfo>

<title>localectl</title>

<productname>systemd</productname>

<authorgroup>

<author>

<contrib>Developer</contrib>

<firstname>Lennart</firstname>

<surname>Poettering</surname>

<email>lennart@poettering.net</email>

</author>

</authorgroup>

</refentryinfo>

<refmeta>

<refentrytitle>localectl</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>localectl</refname>

<refpurpose>Control the system locale and keyboard layout settings</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>localectl</command>

<arg choice="opt" rep="repeat">OPTIONS</arg>

<arg choice="req">COMMAND</arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para><command>localectl</command> may be used to

query and change the system locale and keyboard layout

settings.</para>

<para>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.</para>

<para>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.</para>

<para>Use

<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>

to initialize the system locale for mounted (but not

booted) system images.</para>

</refsect1>

<refsect1>

<title>Options</title>

<para>The following options are understood:</para>

<variablelist>

<varlistentry>

<term><option>--no-ask-password</option></term>

<listitem><para>Do not query the user

for authentication for privileged

operations.</para></listitem>

</varlistentry>

<varlistentry>

<term><option>--no-convert</option></term>

<listitem><para>If

<command>set-keymap</command> or

<command>set-x11-keymap</command> is

invoked and this option is passed, then

the keymap will not be converted from

the console to X11, or X11 to console,

respectively.</para></listitem>

</varlistentry>

<xi:include href="user-system-options.xml" xpointer="host" />

<xi:include href="standard-options.xml" xpointer="help" />

<xi:include href="standard-options.xml" xpointer="version" />

<xi:include href="standard-options.xml" xpointer="no-pager" />

</variablelist>

<para>The following commands are understood:</para>

<variablelist>

<varlistentry>

<term><command>status</command></term>

<listitem><para>Show current settings

of the system locale and keyboard

mapping.</para></listitem>

</varlistentry>

<varlistentry>

<term><command>set-locale LOCALE...</command></term>

<listitem><para>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

<citerefentry><refentrytitle>locale</refentrytitle><manvolnum>7</manvolnum></citerefentry>

for details on the available settings

and their meanings. Use

<command>list-locales</command> for a

list of available locales (see below).

</para></listitem>

</varlistentry>

<varlistentry>

<term><command>list-locales</command></term>

<listitem><para>List available locales

useful for configuration with

<command>set-locale</command>.</para></listitem>

</varlistentry>

<varlistentry>

<term><command>set-keymap MAP [TOGGLEMAP]</command></term>

<listitem><para>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

<option>--no-convert</option> 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

<command>list-keymaps</command> for a

list of available keyboard mappings

(see below).</para></listitem>

</varlistentry>

<varlistentry>

<term><command>list-keymaps</command></term>

<listitem><para>List available

keyboard mappings for the console,

useful for configuration with

<command>set-keymap</command>.</para></listitem>

</varlistentry>

<varlistentry>

<term><command>set-x11-keymap LAYOUT [MODEL [VARIANT [OPTIONS]]]</command></term>

<listitem><para>Set the system default

keyboard mapping for X11 and the

virtual console. This takes a keyboard

mapping name (such as

<literal>de</literal> or

<literal>us</literal>), and possibly a

model, variant, and options, see

<citerefentry><refentrytitle>kbd</refentrytitle><manvolnum>4</manvolnum></citerefentry>

for details. Unless

<option>--no-convert</option> is

passed, the selected setting is also

applied as the system console keyboard

mapping, after converting it to the

closest matching console keyboard

mapping.</para></listitem>

</varlistentry>

<varlistentry>

<term><command>list-x11-keymap-models</command></term>

<term><command>list-x11-keymap-layouts</command></term>

<term><command>list-x11-keymap-variants [LAYOUT]</command></term>

<term><command>list-x11-keymap-options</command></term>

<listitem><para>List available X11

keymap models, layouts, variants and

options, useful for configuration with

<command>set-keymap</command>. The

command

<command>list-x11-keymap-variants</command>

optionally takes a layout parameter to

limit the output to the variants

suitable for the specific

layout.</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title>Exit status</title>

<para>On success, 0 is returned, a non-zero failure

code otherwise.</para>

</refsect1>

<xi:include href="less-variables.xml" />

<refsect1>

<title>See Also</title>

<para>

<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>locale</refentrytitle><manvolnum>7</manvolnum></citerefentry>,

<citerefentry><refentrytitle>locale.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>kbd</refentrytitle><manvolnum>4</manvolnum></citerefentry>,

<ulink url="http://www.x.org/releases/current/doc/xorg-docs/input/XKB-Config.html">

The XKB Configuration Guide

</ulink>,

<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,

<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>

</para>

</refsect1>

</refentry>