diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /upstream/fedora-40/man5/vconsole.conf.5 | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/fedora-40/man5/vconsole.conf.5')
-rw-r--r-- | upstream/fedora-40/man5/vconsole.conf.5 | 127 |
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) |