summaryrefslogtreecommitdiff
path: root/vconsole.conf.5.txt
blob: 956ca6a35fd388256fa53d29cd8572ad84373bd3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
/////
vim:set ts=4 sw=4 syntax=asciidoc noet:
/////
vconsole.conf(5)
================

NAME
----
vconsole.conf - configuration file for the virtual console

SYNOPSIS
--------
*/etc/vconsole.conf*

DESCRIPTION
-----------

The /etc/vconsole.conf file configures the virtual console, i.e. keyboard mapping and console font.

The basic file format of the vconsole.conf is a newline-separated list environment-like shell-compatible variable assignments. 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.

In Arch /etc/rc.conf is also checked for vconsole configuration as well, however only as fallback, as described below.

OPTIONS
-------

The following options are understood:

*KEYMAP=*
//, KEYMAP_TOGGLE=
//The KEYMAP_TOGGLE= can be used to configured a second toggle keymap and is by default unset.
//  KEYMAP= defaults to us if not set.

	Configures the key mapping table of for they keyboard. Overriding KEYMAP from rc.conf.

*FONT=*, *FONT_MAP=*
//, FONT_UNIMAP=
// the unicode font map
//  FONT= defaults to latarcyrheb-sun16.

	Configures the console font and the console map. Overriding respectively CONSOLEFONT and CONSOLEMAP from rc.conf.

EXAMPLE
-------
*Example 1. German keyboard and console*

/etc/vconsole.conf:

	KEYMAP=de-latin1
	FONT=latarcyrheb-sun16

SEE ALSO
--------

systemd.vconsole.conf(5), loadkeys(1), setfont(8), rc.conf(5)

AUTHORS
-------
Original by Lennart Poettering, adapted to Arch Linux by Tom Gundersen.