mirror of
https://github.com/systemd/systemd.git
synced 2024-10-27 18:55:40 +03:00
bbfb25f4b9
ImportCredential= takes a credential name and searches for a matching credential in all the credential stores we know about it. It supports globs which are expanded so that all matching credentials are loaded.
102 lines
4.9 KiB
XML
102 lines
4.9 KiB
XML
<?xml version="1.0"?>
|
|
<!--*-nxml-*-->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
|
<refentry id="systemd-vconsole-setup.service" conditional='ENABLE_VCONSOLE'>
|
|
|
|
<refentryinfo>
|
|
<title>systemd-vconsole-setup.service</title>
|
|
<productname>systemd</productname>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>systemd-vconsole-setup.service</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>systemd-vconsole-setup.service</refname>
|
|
<refname>systemd-vconsole-setup</refname>
|
|
<refpurpose>Configure the virtual consoles</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<para><filename>systemd-vconsole-setup.service</filename></para>
|
|
<cmdsynopsis>
|
|
<command>/usr/lib/systemd/systemd-vconsole-setup</command>
|
|
<arg choice="opt">TTY</arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para><filename>systemd-vconsole-setup</filename> sets up and configures either all virtual consoles, or — if the
|
|
optional <replaceable>TTY</replaceable> parameter is provided — a specific one. When the system is booting up, it's
|
|
called by <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry> during
|
|
VT console subsystem initialization. Also,
|
|
<citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> invokes
|
|
it as needed when language or console changes are made. Internally, this program calls <citerefentry
|
|
project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry> and <citerefentry
|
|
project='die-net'><refentrytitle>setfont</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
|
</para>
|
|
|
|
<para>Execute <command>systemctl restart systemd-vconsole-setup.service</command> in order to apply any manual
|
|
changes made to <filename>/etc/vconsole.conf</filename>.</para>
|
|
|
|
<para>See <citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
|
|
information about the configuration files and kernel command line options understood by this program.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Credentials</title>
|
|
|
|
<para><command>systemd-vconsole-setup</command> supports the service credentials logic as implemented by
|
|
<varname>ImportCredential=</varname><varname>LoadCredential=</varname>/<varname>SetCredential=</varname>
|
|
(see <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>1</manvolnum></citerefentry> for
|
|
details). The following credentials are used when passed in:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><varname>vconsole.keymap</varname></term>
|
|
<term><varname>vconsole.keymap_toggle</varname></term>
|
|
|
|
<listitem><para>The keymap (and toggle keymap) to apply. The matching options in
|
|
<filename>vconsole.conf</filename> and on the kernel command line take precedence over these
|
|
credentials.</para>
|
|
|
|
<para>Note the relationship to the <varname>firstboot.keymap</varname> credential understood by
|
|
<citerefentry><refentrytitle>systemd-firstboot.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>:
|
|
both ultimately affect the same setting, but <varname>firstboot.keymap</varname> is written into
|
|
<filename>/etc/vconsole.conf</filename> on first boot (if not already configured), and then read from
|
|
there by <command>systemd-vconsole-setup</command>, while <varname>vconsole.keymap</varname> is read
|
|
on every boot, and is not persisted to disk (but any configuration in
|
|
<filename>vconsole.conf</filename> will take precedence if present).</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>vconsole.font</varname></term>
|
|
<term><varname>vconsole.font_map</varname></term>
|
|
<term><varname>vconsole.font_unimap</varname></term>
|
|
|
|
<listitem><para>The console font settings to apply. The matching options in
|
|
<filename>vconsole.conf</filename> and on the kernel command line take precedence over these
|
|
credentials.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>vconsole.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
|
<citerefentry project='mankier'><refentrytitle>loadkeys</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry project='die-net'><refentrytitle>setfont</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|