| SYSTEMD-VCONSOLE-SETUP.SERVICE(8) | systemd-vconsole-setup.service | SYSTEMD-VCONSOLE-SETUP.SERVICE(8) |
.SH "NAME" systemd-vconsole-setup.service, systemd-vconsole-setup -
Configure the virtual consoles
.SH "SYNOPSIS"
.PP systemd-vconsole-setup.service
.HP 960u
/usr/lib/systemd/systemd-vconsole-setup
[TTY]
.SH "DESCRIPTION"
.PP systemd-vconsole-setup sets up and configures either all virtual
consoles, or — if the optional TTY parameter is provided
— a specific one. When the system is booting up,
systemd-vconsole-setup.service is called by systemd-udevd(8) during
VT console subsystem initialization. Also, systemd-localed.service(8)
invokes it as needed when language or console changes are made. Internally,
this program calls loadkeys(1) and setfont(8).
.PP Execute systemctl restart systemd-vconsole-setup.service in order
to apply any manual changes made to /etc/vconsole.conf.
.PP See vconsole.conf(5) for information about the configuration files
and kernel command line options understood by this program.
.SH "CREDENTIALS"
.PP systemd-vconsole-setup supports the service credentials logic as
implemented by
ImportCredential=/LoadCredential=/SetCredential= (see
systemd.exec(5) for details). The following credentials are used when
passed in:
.PP vconsole.keymap, vconsole.keymap_toggle
The keymap (and toggle keymap) to apply. The matching options in
vconsole.conf and on the kernel command line take precedence over these
credentials.
Note the relationship to the firstboot.keymap credential understood by
systemd-firstboot.service(1): both ultimately affect the same
setting, but firstboot.keymap is written into /etc/vconsole.conf on
first boot (if not already configured), and then read from there by
systemd-vconsole-setup, while vconsole.keymap is read on every
boot, and is not persisted to disk (but any configuration in vconsole.conf
will take precedence if present).
Added in version 253.
.RE
.PP vconsole.font, vconsole.font_map,
vconsole.font_unimap, vconsole.font_scale
The console font settings to apply. The matching options in vconsole.conf and
on the kernel command line take precedence over these credentials.
vconsole.font_scale was added in version 262.
Added in version 253.
.RE
.SH "FIRMWARE-PROVIDED KEYBOARD LAYOUT"
.PP If the boot loader reports the firmware-configured keyboard layout via
the LoaderKeyboardLayout EFI variable (see the Boot Loader
Interface[1]), systemd-vconsole-setup uses it as the
lowest-priority fallback for the keymap. The RFC 4646 / BCP 47 language tag
reported by the firmware (e.g. de-DE) is matched against the optional sixth
column of /usr/share/systemd/kbd-model-map, which lists the language tags
each virtual-console keymap covers. Credentials, /etc/vconsole.conf, and
kernel command line options all override this firmware-provided default.
.SH "SEE ALSO"
.PP systemd(1), vconsole.conf(5), loadkeys(1),
setfont(8), systemd-localed.service(8)
NOTES
- 1.
- Boot Loader Interface
| systemd 262.2 |