1<?xml version="1.0"?>
2<!--*-nxml-*-->
3<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
4  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
6<refentry id="systemd-vconsole-setup.service" conditional='ENABLE_VCONSOLE'>
7
8  <refentryinfo>
9    <title>systemd-vconsole-setup.service</title>
10    <productname>systemd</productname>
11  </refentryinfo>
12
13  <refmeta>
14    <refentrytitle>systemd-vconsole-setup.service</refentrytitle>
15    <manvolnum>8</manvolnum>
16  </refmeta>
17
18  <refnamediv>
19    <refname>systemd-vconsole-setup.service</refname>
20    <refname>systemd-vconsole-setup</refname>
21    <refpurpose>Configure the virtual consoles</refpurpose>
22  </refnamediv>
23
24  <refsynopsisdiv>
25    <para><filename>systemd-vconsole-setup.service</filename></para>
26    <cmdsynopsis>
27      <command>/usr/lib/systemd/systemd-vconsole-setup</command>
28      <arg choice="opt">TTY</arg>
29    </cmdsynopsis>
30  </refsynopsisdiv>
31
32  <refsect1>
33    <title>Description</title>
34
35    <para><filename>systemd-vconsole-setup</filename> sets up and configures either all virtual consoles, or — if the
36    optional <replaceable>TTY</replaceable> parameter is provided — a specific one. When the system is booting up, it's
37    called by <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry> during
38    VT console subsystem initialization.  Also,
39    <citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> invokes
40    it as needed when language or console changes are made. Internally, this program calls <citerefentry
41    project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry> and <citerefentry
42    project='die-net'><refentrytitle>setfont</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
43    </para>
44
45    <para>Execute <command>systemctl restart systemd-vconsole-setup.service</command> in order to apply any manual
46    changes made to <filename>/etc/vconsole.conf</filename>.</para>
47
48    <para>See <citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
49    information about the configuration files and kernel command line options understood by this program.</para>
50  </refsect1>
51
52  <refsect1>
53    <title>See Also</title>
54    <para>
55      <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
56      <citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
57      <citerefentry project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
58      <citerefentry project='die-net'><refentrytitle>setfont</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
59      <citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
60    </para>
61  </refsect1>
62
63</refentry>
64