man/vconsole.conf.5

   1 '\" t
   2 .\"     Title: vconsole.conf
   3 .\"    Author: Lennart Poettering <lennart@poettering.net>
   4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 02/15/2012
   6 .\"    Manual: vconsole.conf
   7 .\"    Source: systemd
   8 .\"  Language: English
   9 .\"
  10 .TH "VCONSOLE\&.CONF" "5" "02/15/2012" "systemd" "vconsole.conf"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 vconsole.conf \- configuration file for the virtual console
  32 .SH "SYNOPSIS"
  33 .PP
  34 /etc/vconsole\&.conf
  35 .SH "DESCRIPTION"
  36 .PP
  37 The
  38 /etc/vconsole\&.conf
  39 file configures the virtual console, i\&.e\&. keyboard mapping and console font\&.
  40 .PP
  41 The basic file format of the
  42 vconsole\&.conf
  43 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\&.
  44 .PP
  45 Note that the kernel command line options
  46 \fIvconsole\&.keymap=\fR,
  47 \fIvconsole\&.keymap\&.toggle=\fR,
  48 \fIvconsole\&.font=\fR,
  49 \fIvconsole\&.font\&.map=\fR,
  50 \fIvconsole\&.font\&.unimap=\fR
  51 may be used to override the console settings at boot\&.
  52 .PP
  53 Depending on the operating system other configuration files might be checked for configuration of the virtual console as well, however only as fallback\&.
  54 .SH "OPTIONS"
  55 .PP
  56 The following options are understood:
  57 .PP
  58 \fIKEYMAP=\fR, \fIKEYMAP_TOGGLE=\fR
  59 .RS 4
  60 Configures the key mapping table of for they keyboard\&.
  61 \fIKEYMAP=\fR
  62 defaults to
  63 us
  64 if not set\&. The
  65 \fIKEYMAP_TOGGLE=\fR
  66 can be used to configured a second toggle keymap and is by default unset\&.
  67 .RE
  68 .PP
  69 \fIFONT=\fR, \fIFONT_MAP=\fR, \fIFONT_UNIMAP=\fR
  70 .RS 4
  71 Configures the console font, the console map and the unicode font map\&.
  72 \fIFONT=\fR
  73 defaults to
  74 latarcyrheb\-sun16\&.
  75 .RE
  76 .SH "EXAMPLE"
  77 .PP
  78 \fBExample\ \&1.\ \&German keyboard and console\fR
  79 .PP
  80 /etc/vconsole\&.conf:
  81 .sp
  82 .if n \{\
  83 .RS 4
  84 .\}
  85 .nf
  86 KEYMAP=de\-latin1
  87 FONT=latarcyrheb\-sun16
  88 .fi
  89 .if n \{\
  90 .RE
  91 .\}
  92 .SH "SEE ALSO"
  93 .PP
  94
  95 \fBsystemd\fR(1),
  96 \fBloadkeys\fR(1),
  97 \fBsetfont\fR(8),
  98 \fBlocale.conf\fR(5)
  99 .SH "AUTHOR"
 100 .PP
 101 \fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
 102 .RS 4
 103 Developer
 104 .RE