3 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5 SPDX-License-Identifier: LGPL-2.1+
7 This file is part of systemd.
9 Copyright 2012 Lennart Poettering
11 <refentry id=
"systemd-vconsole-setup.service" conditional='ENABLE_VCONSOLE'
>
14 <title>systemd-vconsole-setup.service
</title>
15 <productname>systemd
</productname>
19 <contrib>Developer
</contrib>
20 <firstname>Lennart
</firstname>
21 <surname>Poettering
</surname>
22 <email>lennart@poettering.net
</email>
28 <refentrytitle>systemd-vconsole-setup.service
</refentrytitle>
29 <manvolnum>8</manvolnum>
33 <refname>systemd-vconsole-setup.service
</refname>
34 <refname>systemd-vconsole-setup
</refname>
35 <refpurpose>Configure the virtual consoles
</refpurpose>
39 <para><filename>systemd-vconsole-setup.service
</filename></para>
41 <command>/usr/lib/systemd/systemd-vconsole-setup
</command>
42 <arg choice=
"opt">TTY
</arg>
47 <title>Description
</title>
49 <para><filename>systemd-vconsole-setup
</filename> sets up and configures either all virtual consoles, or — if the
50 optional
<replaceable>TTY
</replaceable> parameter is provided — a specific one. When the system is booting up it's
51 called by
<citerefentry><refentrytitle>systemd-udevd
</refentrytitle><manvolnum>8</manvolnum></citerefentry> during
52 VT console subsystem initialization. Also,
53 <citerefentry><refentrytitle>systemd-localed.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry> invokes
54 it as needed when language or console changes are made. Internally, this program calls
<citerefentry
55 project='mankier'
><refentrytitle>loadkeys
</refentrytitle><manvolnum>1</manvolnum></citerefentry> and
<citerefentry
56 project='die-net'
><refentrytitle>setfont
</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
59 <para>Execute
<command>systemctl restart systemd-vconsole-setup.service
</command> in order to apply any manual
60 changes made to
<filename>/etc/vconsole.conf
</filename>.
</para>
62 <para>See
<citerefentry><refentrytitle>vconsole.conf
</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
63 information about the configuration files and kernel command line options understood by this program.
</para>
67 <title>See Also
</title>
69 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
70 <citerefentry><refentrytitle>vconsole.conf
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
71 <citerefentry project='mankier'
><refentrytitle>loadkeys
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
72 <citerefentry project='die-net'
><refentrytitle>setfont
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
73 <citerefentry><refentrytitle>systemd-localed.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>