diff options
author | Lennart Poettering <lennart@poettering.net> | 2023-01-03 13:05:32 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2023-01-05 18:24:21 +0100 |
commit | ea575e176aac9fa8f430bb30a3e8abd8da767a10 (patch) | |
tree | e0299499fce39c3b74c9c73d13a941032642ded5 /man/systemd-vconsole-setup.service.xml | |
parent | bc0b2d377f4f8cf4dcf29651c8570f93bd52408e (diff) | |
download | systemd-ea575e176aac9fa8f430bb30a3e8abd8da767a10.tar.gz |
vconsole: permit configuration of vconsole settings via credentials
Diffstat (limited to 'man/systemd-vconsole-setup.service.xml')
-rw-r--r-- | man/systemd-vconsole-setup.service.xml | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/man/systemd-vconsole-setup.service.xml b/man/systemd-vconsole-setup.service.xml index 80577edba0..98d9e2ad01 100644 --- a/man/systemd-vconsole-setup.service.xml +++ b/man/systemd-vconsole-setup.service.xml @@ -50,6 +50,44 @@ </refsect1> <refsect1> + <title>Credentials</title> + + <para><command>systemd-vconsole-setup</command> supports the service credentials logic as implemented by + <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>, |