Debian Codegraph @

upstream/fedora-44/man8/systemd-vconsole-setup.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-VCONSOLE\-SETUP\&.SERVICE" "8" "" "systemd 259.5" "systemd-vconsole-setup.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-vconsole-setup.service, systemd-vconsole-setup \- Configure the virtual consoles
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-vconsole\-setup\&.service
27 .HP \w'\fB/usr/lib/systemd/systemd\-vconsole\-setup\fR\ 'u
28 \fB/usr/lib/systemd/systemd\-vconsole\-setup\fR [TTY]
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-vconsole\-setup\fR
32 sets up and configures either all virtual consoles, or \(em if the optional
33 \fITTY\fR
34 parameter is provided \(em a specific one\&. When the system is booting up,
35 systemd\-vconsole\-setup\&.service
36 is called by
37 \fBsystemd-udevd\fR(8)
38 during VT console subsystem initialization\&. Also,
39 \fBsystemd-localed.service\fR(8)
40 invokes it as needed when language or console changes are made\&. Internally, this program calls
41 \fBloadkeys\fR(1)
42 and
43 \fBsetfont\fR(8)\&.
44 .PP
45 Execute
46 \fBsystemctl restart systemd\-vconsole\-setup\&.service\fR
47 in order to apply any manual changes made to
48 /etc/vconsole\&.conf\&.
49 .PP
50 See
51 \fBvconsole.conf\fR(5)
52 for information about the configuration files and kernel command line options understood by this program\&.
53 .SH "CREDENTIALS"
54 .PP
55 \fBsystemd\-vconsole\-setup\fR
56 supports the service credentials logic as implemented by
57 \fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR
58 (see
59 \fBsystemd.exec\fR(5)
60 for details)\&. The following credentials are used when passed in:
61 .PP
62 \fIvconsole\&.keymap\fR, \fIvconsole\&.keymap_toggle\fR
63 .RS 4
64 The keymap (and toggle keymap) to apply\&. The matching options in
65 vconsole\&.conf
66 and on the kernel command line take precedence over these credentials\&.
67 .sp
68 Note the relationship to the
69 \fIfirstboot\&.keymap\fR
70 credential understood by
71 \fBsystemd-firstboot.service\fR(8): both ultimately affect the same setting, but
72 \fIfirstboot\&.keymap\fR
73 is written into
74 /etc/vconsole\&.conf
75 on first boot (if not already configured), and then read from there by
76 \fBsystemd\-vconsole\-setup\fR, while
77 \fIvconsole\&.keymap\fR
78 is read on every boot, and is not persisted to disk (but any configuration in
79 vconsole\&.conf
80 will take precedence if present)\&.
81 .sp
82 Added in version 253\&.
83 .RE
84 .PP
85 \fIvconsole\&.font\fR, \fIvconsole\&.font_map\fR, \fIvconsole\&.font_unimap\fR
86 .RS 4
87 The console font settings to apply\&. The matching options in
88 vconsole\&.conf
89 and on the kernel command line take precedence over these credentials\&.
90 .sp
91 Added in version 253\&.
92 .RE
93 .SH "SEE ALSO"
94 .PP
95 \fBsystemd\fR(1), \fBvconsole.conf\fR(5), \fBloadkeys\fR(1), \fBsetfont\fR(8), \fBsystemd-localed.service\fR(8)