1 files changed, 127 insertions, 0 deletions
diff --git a/upstream/fedora-40/man5/vconsole.conf.5 b/upstream/fedora-40/man5/vconsole.conf.5
new file mode 100644
index 00000000..ef220e50
--- /dev/null
+++ b/upstream/fedora-40/man5/vconsole.conf.5
@@ -0,0 +1,127 @@
+'\" t
+.TH "VCONSOLE\&.CONF" "5" "" "systemd 255" "vconsole.conf"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+vconsole.conf \- Configuration file for the virtual console
+.SH "SYNOPSIS"
+.PP
+/etc/vconsole\&.conf
+.SH "DESCRIPTION"
+.PP
+The
+/etc/vconsole\&.conf
+file configures the virtual console, i\&.e\&. keyboard mapping and console font\&. It is applied at boot by udev using
+90\-vconsole\&.rules
+file\&. You can safely mask this file if you want to avoid this kind of initialization\&.
+.PP
+The format of
+vconsole\&.conf
+is a newline\-separated list of environment\-like shell\-compatible variable assignments, ignoring comments and empty lines\&. It is possible to source the configuration from shell scripts, however, beyond mere variable assignments no shell features are supported, allowing applications to read the file without implementing a shell compatible execution engine\&. See
+\fBos-release\fR(5)
+for a detailed description of the format\&.
+.PP
+Note that the kernel command line options
+\fIvconsole\&.keymap=\fR,
+\fIvconsole\&.keymap_toggle=\fR,
+\fIvconsole\&.font=\fR,
+\fIvconsole\&.font_map=\fR,
+\fIvconsole\&.font_unimap=\fR
+may be used to override the console settings at boot\&.
+.PP
+Depending on the operating system other configuration files might be checked for configuration of the virtual console as well, however only as fallback\&.
+.PP
+/etc/vconsole\&.conf
+is usually created and updated using
+\fBsystemd-localed.service\fR(8)\&.
+\fBlocalectl\fR(1)
+may be used to instruct
+\fBsystemd\-localed\&.service\fR
+to query or update configuration\&.
+.SH "OPTIONS"
+.PP
+The following options are understood:
+.PP
+\fIKEYMAP=\fR, \fIKEYMAP_TOGGLE=\fR
+.RS 4
+Configures the key mapping table for the keyboard\&.
+\fIKEYMAP=\fR
+defaults to
+"us"
+if not set\&. Specially, if
+"@kernel"
+is specified, no keymap will be loaded, i\&.e\&. the kernel\*(Aqs default keymap is used\&. The
+\fIKEYMAP_TOGGLE=\fR
+can be used to configure a second toggle keymap and is by default unset\&.
+.RE
+.PP
+\fIFONT=\fR, \fIFONT_MAP=\fR, \fIFONT_UNIMAP=\fR
+.RS 4
+Configures the console font, the console map and the unicode font map\&.
+.RE
+.SH "KERNEL COMMAND LINE"
+.PP
+A few configuration parameters from
+vconsole\&.conf
+may be overridden on the kernel command line:
+.PP
+\fIvconsole\&.keymap=\fR, \fIvconsole\&.keymap_toggle=\fR
+.RS 4
+Overrides
+\fIKEYMAP=\fR
+and
+\fIKEYMAP_TOGGLE=\fR\&.
+.sp
+Added in version 232\&.
+.RE
+.PP
+\fIvconsole\&.font=\fR, \fIvconsole\&.font_map=\fR, \fIvconsole\&.font_unimap=\fR
+.RS 4
+Overrides
+\fIFONT=\fR,
+\fIFONT_MAP=\fR, and
+\fIFONT_UNIMAP=\fR\&.
+.sp
+Added in version 232\&.
+.RE
+.SH "EXAMPLE"
+.PP
+\fBExample\ \&1.\ \&German keyboard and console\fR
+.PP
+/etc/vconsole\&.conf:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+KEYMAP=de\-latin1
+FONT=eurlatgr
+.fi
+.if n \{\
+.RE
+.\}
+.SH "SEE ALSO"
+.PP
+\fBsystemd\fR(1),
+\fBsystemd-vconsole-setup.service\fR(8),
+\fBloadkeys\fR(1),
+\fBsetfont\fR(8),
+\fBlocale.conf\fR(5),
+\fBsystemd-localed.service\fR(8)