man/systemd-vconsole-setup.service.xml

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