man-pages/man5/console-setup.5.html
2021-03-31 01:06:50 +01:00

698 lines
17 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of CONSOLE-SETUP</TITLE>
</HEAD><BODY>
<H1>CONSOLE-SETUP</H1>
Section: Console-setup User's Manual (5)<BR>Updated: 2011-03-17<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
console-setup - configuration file for setupcon
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
The file
<B>console-setup</B>
specifies the encoding and the font to be used by
<B><A HREF="/cgi-bin/man/man2html?1+setupcon">setupcon</A></B>(1)
in order to setup the console. It can be used also to specify the
keyboard layout but it is not recommended to do so, use
<B><A HREF="/cgi-bin/man/man2html?5+keyboard">keyboard</A></B>(5)
instead.
<P>
The font specification consists of three parameters - codeset, font
face and font size. The codeset specifies what characters will be
supported by the font. There isn't one-to-one correspondence between
codeset and encoding, for example the codeset
<B>Lat15</B>
is suitable for ISO&nbsp;8859-1, ISO&nbsp;8859-9 and ISO&nbsp;8859-15. The
codesets are two kinds - small and big. Only small codesets are
supported on FreeBSD.
<P>
The font face determines the general look of the font. Each font face
is available in certain possible sizes. On FreeBSD only
<B>8x16</B>, <B>8x14</B> and <B>8x8</B>
are valid sizes. On Linux if framebuffer is not used or
<B><A HREF="/cgi-bin/man/man2html?1+consolechars">consolechars</A></B>(1)
is installed instead of
<B><A HREF="/cgi-bin/man/man2html?1+setfont">setfont</A></B>(1),
then the permitted sizes have the form
8x<I>NUMBER</I>.
<P>
<P>
The console driver of FreeBSD permits fonts in different sizes to be
simultaneously loaded. Which one of them will be actually used
depends on the current video mode. Therefore, on this platform the
font size specification will be ignored and
<B><A HREF="/cgi-bin/man/man2html?1+setupcon">setupcon</A></B>(1)
will load the selected font face in all available sizes.
<P>
The file
<B>console-setup</B>
consists of variable settings in
<FONT SIZE="-1">POSIX</FONT>
format:
<DL COMPACT>
<DT id="1"><DD>
<I>VARIABLE</I>='<I>VALUE</I>'
</DL>
<P>
Only one assignment is allowed per line. Comments (starting with '#')
are also allowed.
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>OPTIONS</H2>
The following variables can be set.
<P>
<DL COMPACT>
<DT id="2"><B>ACTIVE_CONSOLES</B>
<DD>
Specifies the device files in
<I>/dev</I>
of the virtual terminals to be configured. File name wild-cards
(<B>*</B>,&nbsp;<B>?</B>)
are allowed. On Linux usually you can set this to
<B>/dev/tty[1-6]</B>
and on FreeBSD a sensible value is
<B>/dev/ttyv[0-8]</B>.
You can assign to this variable also the special value
<B>guess</B>.
It will cause
<B><A HREF="/cgi-bin/man/man2html?1+setupcon">setupcon</A></B>(1)
to attempt to guess the active virtual consoles by looking in
configuration files such as
<I>/etc/inittab</I> and <I>/etc/ttys</I>.
This guessing is not always reliable.
<P>
<DT id="3"><B>CHARMAP</B>
<DD>
Specifies the desired encoding on the console. Valid values are:
<B>UTF-8</B>,
<B>ARMSCII-8</B>,
<B>CP1251</B>,
<B>CP1255</B>,
<B>CP1256</B>,
<B>GEORGIAN-ACADEMY</B>,
<B>GEORGIAN-PS</B>,
<B>IBM1133</B>,
<B>ISIRI-3342</B>,
<B>ISO-8859-1</B>,
<B>ISO-8859-2</B>,
<B>ISO-8859-3</B>,
<B>ISO-8859-4</B>,
<B>ISO-8859-5</B>,
<B>ISO-8859-6</B>,
<B>ISO-8859-7</B>,
<B>ISO-8859-8</B>,
<B>ISO-8859-9</B>,
<B>ISO-8859-10</B>,
<B>ISO-8859-11</B>,
<B>ISO-8859-13</B>,
<B>ISO-8859-14</B>,
<B>ISO-8859-15</B>,
<B>ISO-8859-16</B>,
<B>KOI8-R</B>,
<B>KOI8-U</B>,
<B>TIS-620</B> and
<B>VISCII</B>.
The special value
<B>guess</B>
is also recognized in which case the system command
<B><A HREF="/cgi-bin/man/man2html?1+locale">locale</A></B>(1)
will be used to guess the desired encoding (currently this works
reliably only with
<FONT SIZE="-1">GNU</FONT>
libc).
<P>
<DT id="4"><B>CODESET</B>
<DD>
In most cases the special value
<B>guess</B>
can be used here in which case a suitable codeset will be guessed.
The codeset determines which symbols are supported by the font. Valid
small codesets are:
<B>Armenian</B>,
<B>CyrAsia</B>,
<B>CyrKoi</B>,
<B>CyrSlav</B>,
<B>Georgian</B>,
<B>Greek</B>,
<B>Hebrew</B>,
<B>Lao</B>,
<B>Lat15</B>,
<B>Lat2</B>,
<B>Lat38</B>,
<B>Lat7</B> and
<B>Thai</B>.
Valid big codesets are:
<B>Arabic</B>,
<B>Ethiopian</B>,
<B>Uni1</B>,
<B>Uni2</B>,
<B>Uni3</B> and
<B>Vietnamese</B>.
Only small codesets can be used on FreeBSD. See below the section
entitled ``CODESETS'' for detailed description of each of these
codesets.
<P>
<DT id="5"><B>FONTFACE</B> and <B>FONTSIZE</B>
<DD>
Valid font faces are:
<B>VGA</B> (sizes <B>8x8</B>, <B>8x14</B>, <B>8x16</B>, <B>16x28</B> and <B>16x32</B>),
<B>Terminus</B> (sizes <B>6x12</B>, <B>8x14</B>, <B>8x16</B>, <B>10x20</B>, <B>12x24</B>, <B>14x28</B> and <B>16x32</B>),
<B>TerminusBold</B> (sizes <B>8x14</B>, <B>8x16</B>, <B>10x20</B>, <B>12x24</B>, <B>14x28</B> and <B>16x32</B>),
<B>TerminusBoldVGA</B> (sizes <B>8x14</B> and <B>8x16</B>),
and
<B>Fixed</B> (sizes <B>8x13</B>, <B>8x14</B>, <B>8x15</B>, <B>8x16</B> and <B>8x18</B>).
If however
<B>CODESET</B>=<B>Ethiopian</B>,
then the available font faces are
<B>Goha</B> and <B>GohaClassic</B>,
each in sizes
<B>8x12</B>, <B>8x14</B> and <B>8x16</B>.
<P>
Set
<B>FONTFACE</B>
and
<B>FONTSIZE</B>
to empty strings if you want to configure only the keyboard and to
leave the console font unchanged.
<P>
<DT id="6"><B>VIDEOMODE</B>
<DD>
Set
<B>VIDEOMODE</B>
to an empty string to avoid setting up the video mode. On FreeBSD you
can run
<PRE>
vidcontrol -i mode
</PRE>
in order to see all possible video modes. On Linux
<B><A HREF="/cgi-bin/man/man2html?1+fbset">fbset</A></B>(1)
is used to configure the video mode but very often this doesn't work
because the default framebuffer driver (VesaFB) is rather limited and
doesn't allow changes of the video mode.
<P>
<DT id="7"><B>FONT</B>, <B>FONT_MAP</B> and <B>CONSOLE_MAP</B>
<DD>
If set, specify that a non standard font is to be used. The value of
the variable
<B>FONT</B>
consists of one or more space separated font file names. On Linux,
when the font doesn't contain embedded Unicode map, an external map
can be specified with the variable
<B>FONT_MAP</B>.
The value of
<B>CONSOLE_MAP</B>
is a file that specifies a translation map from the user's 8-bit
encoding to Unicode (Linux only) or directly to font positions.
<P>
<DT id="8"><B>SCREEN_WIDTH</B> and <B>SCREEN_HEIGHT</B>
<DD>
If set, these variables specify a screen size that
<B><A HREF="/cgi-bin/man/man2html?1+setupcon">setupcon</A></B>(1)
will enforce with
<B><A HREF="/cgi-bin/man/man2html?1+stty">stty</A></B>(1).
This can be useful with some braille devices that are only 40 cells
wide. The screen size can not exceed what the current screen
resolution can display according to the size of the loaded font.
<P>
<DT id="9"><B>BEEP</B>
<DD>
This variable controls the style of the system beep on the console. When unset or when
<B>BEEP=default</B>
no changes to the system beep will be made. Other possible values of
<B>BEEP</B>
are:
<B>standard -</B>
set a standard beep;
<B>short -</B>
like the standard beep but somewhat shorter;
<B>shortest -</B>
even more short, suitable when your work generates lots of beeps;
<B>polite -</B>
a very short beep with low frequency, suitable when there are other
people in the room;
<B>attention -</B>
a very long beep, suitable when you want to warn yourself about an
occurring event;
<B>annoying -</B>
also a long beep, suitable when you want to warn somebody else about
an occurring event; and
<B>off -</B>
disable the system beep on the console.
<P>
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>CODESETS</H2>
There are two kinds of codesets - small (up to 256&nbsp;symbols) and big
(up to 512&nbsp;symbols). Only small codesets can be used on FreeBSD.
When the screen is in text mode (i.e. framebuffer is not used) then
fonts covering big codesets will reduce the number of available
foreground colors.
<P>
<A NAME="lbAF">&nbsp;</A>
<H3>Arabic (a big codeset)</H3>
Supported languages: Arabic, Kurdish in Iran, Pashto, Persian and Urdu.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (size <B>8x16</B>) and <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAG">&nbsp;</A>
<H3>Armenian</H3>
Supported language: Armenian.
<P>
Completely covered by the following font faces:
<B>Fixed</B>
(all sizes).
<P>
<A NAME="lbAH">&nbsp;</A>
<H3>CyrAsia</H3>
This codeset supports some of the non-Slavic Cyrillic languages -
Abkhazia, Avaric, Azerbaijani, Bashkir, Buryat, Chechen, Chuvash,
Inupiaq (Eskimo), Kara-Kalpak, Kazakh, Kirgiz, Komi, Kumyk, Kurdish,
Lezghian, Mari (Cheremis), Mongolian, Ossetic, Selkup
(Ostyak-Samoyed), Tajik, Tatar, Turkmen, Tuvinian, Uzbek and Yakut.
<P>
Completely supported by the following font faces:
<B>Fixed</B>
(all sizes).
<P>
<A NAME="lbAI">&nbsp;</A>
<H3>CyrKoi</H3>
Supports entirely the 8-bit encodings KOI8-R and KOI8-U. Suitable for
Russian and Ukrainian when one of these two encodings is used.
<P>
Completely covered by the following font faces (in all sizes):
<B>Fixed</B>, <B>Terminus</B>, <B>TerminusBold</B>, <B>TerminusBoldVGA</B> and <B>VGA</B>.
<P>
<A NAME="lbAJ">&nbsp;</A>
<H3>CyrSlav</H3>
Supports entirely the 8-bit encodings ISO-8859-5 and CP1251. Suitable
the Slavic Cyrillic languages - Belarusian, Bulgarian, Macedonian,
Russian, Serbian and Ukrainian. For Serbian both the Cyrillic and the
Latin alphabets are supported.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes), <B>Terminus</B> (all sizes), <B>TerminusBold</B> (all sizes), <B>TerminusBoldVGA</B> (all sizes), <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAK">&nbsp;</A>
<H3>Ethiopian (a big codeset)</H3>
Supports Amharic, Ethiopic (Geez), Tigre and Tigrinya.
<P>
This codeset is partially covered by the following font faces:
<B>Fixed</B> (sizes <B>8x15</B> and <B>8x18</B>), <B>Goha</B> (all sizes) and <B>GohaClassic</B> (all sizes).
<P>
<A NAME="lbAL">&nbsp;</A>
<H3>Georgian</H3>
Supported language: Georgian.
<P>
Completely covered by the following font faces:
<B>Fixed</B>
(all sizes).
<P>
<A NAME="lbAM">&nbsp;</A>
<H3>Greek</H3>
Supported language: Greek.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes) and <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAN">&nbsp;</A>
<H3>Hebrew</H3>
Supported languages: Hebrew and Yiddish.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (sizes <B>8x13</B>, <B>8x15</B>, <B>8x16</B> and <B>8x18</B>) and <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAO">&nbsp;</A>
<H3>Lao</H3>
Supported languages: Lao.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (sizes <B>8x15</B> and <B>8x16</B>).
<P>
<A NAME="lbAP">&nbsp;</A>
<H3>Lat15</H3>
Covers entirely ISO-8859-1, ISO-8859-9 and ISO-8859-15. Suitable for
the so called Latin1 and Latin5 languages - Afar, Afrikaans,
Albanian, Aragonese, Asturian, Aymara, Basque, Bislama, Breton,
Catalan, Chamorro, Danish, Dutch, English, Estonian, Faroese, Fijian, Finnish,
French, Frisian, Friulian, Galician, German, Hiri Motu, Icelandic,
Ido, Indonesian, Interlingua, Interlingue, Italian, Low Saxon, Lule
Sami, Luxembourgish, Malagasy, Manx Gaelic, Norwegian Bokmal,
Norwegian Nynorsk, Occitan, Oromo or Galla, Portuguese, Rhaeto-Romance
(Romansch), Scots Gaelic, Somali, South Sami, Spanish, Swahili,
Swedish, Tswana, Turkish, Volapuk, Votic, Walloon, Xhosa, Yapese and
Zulu.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes), <B>Terminus</B> (all sizes), <B>TerminusBold</B> (all sizes), <B>TerminusBoldVGA</B> (all sizes), <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAQ">&nbsp;</A>
<H3>Lat2</H3>
Covers entirely ISO-8859-2. The Euro sign and the Romanian letters
with comma below are also supported. Suitable for the so called
Latin2 languages - Bosnian, Croatian, Czech, Hungarian, Polish,
Romanian, Slovak, Slovenian and Sorbian (lower and upper).
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes), <B>Terminus</B> (all sizes), <B>TerminusBold</B> (all sizes), <B>TerminusBoldVGA</B> (all sizes), <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAR">&nbsp;</A>
<H3>Lat38</H3>
Covers entirely ISO-8859-3 and ISO-8859-14. Suitable for Chichewa
Esperanto, Irish, Maltese and Welsh.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes) and <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAS">&nbsp;</A>
<H3>Lat7</H3>
Covers entirely ISO-8859-13. Suitable for Lithuanian, Latvian, Maori
and Marshallese.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes), <B>Terminus</B> (all sizes), <B>TerminusBold</B> (all sizes), <B>TerminusBoldVGA</B> (all sizes), <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAT">&nbsp;</A>
<H3>Thai</H3>
Supported language: Thai.
<P>
Completely covered by the following font faces:
<B>Fixed</B>
(all sizes).
<P>
<A NAME="lbAU">&nbsp;</A>
<H3>Uni1 (a big codeset)</H3>
Supports most of the Latin languages, the Slavic Cyrillic
languages, Hebrew and barely Arabic.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (sizes <B>8x15</B> and <B>8x16</B>) and <B>VGA</B> (all sizes).
<P>
<A NAME="lbAV">&nbsp;</A>
<H3>Uni2 (a big codeset)</H3>
Supports most of the Latin languages, the Slavic Cyrillic languages
and Greek.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (all sizes) and <B>VGA</B> (sizes <B>8x16</B> and <B>16x32</B>).
<P>
<A NAME="lbAW">&nbsp;</A>
<H3>Uni3 (a big codeset)</H3>
Supports most of the Latin and Cyrillic languages.
<P>
Completely covered by the following font faces:
<B>Fixed</B>
(all sizes).
<P>
<A NAME="lbAX">&nbsp;</A>
<H3>Vietnamese (a big codeset)</H3>
Supported language: Vietnamese.
<P>
Completely covered by the following font faces:
<B>Fixed</B> (sizes <B>8x13</B>, <B>8x15</B>, <B>8x16</B> and <B>8x18</B>).
<P>
<A NAME="lbAY">&nbsp;</A>
<H2>FILES</H2>
The standard location of the
<B>console-setup</B>
configuration file is
<I>/etc/default/console-setup</I>.
The keyboard configuration is in
<I>/etc/default/keyboard</I>.
Fonts that can be used with the variable
<B>FONT</B>
are usually installed in
<I>/usr/share/consolefonts/</I> or <I>/usr/share/syscons/fonts/</I>.
Translation maps that can be used with the variable CONSOLE_MAP are
usually installed in
<I>/usr/share/consoletrans/</I> or <I>/usr/share/syscons/scrnmaps/</I>.
<P>
<A NAME="lbAZ">&nbsp;</A>
<H2>NOTES</H2>
The aim of the Terminus font is to reduce the eyes-fatigue when one
has to read a lot. Currently this font supports only the Latin, the
Cyrillic and the Greek scripts (the
<B>Lat15</B>, <B>Lat2</B>, <B>Lat7</B>, <B>CyrAsia</B>, <B>CyrKoi</B>, <B>CyrSlav</B>, <B>Greek</B>, <B>Uni2</B> and <B>Uni3</B>
codesets).
<P>
The fonts with font face
<B>TerminusBoldVGA</B>
are optimized for use with regular text video modes. They should not
be used with framebuffer video modes. The fonts with font face
<B>TerminusBold</B>
are optimized for use with the framebuffer video modes. The fonts
with font face
<B>Terminus</B>
can be used in all video modes.
<P>
<A NAME="lbBA">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+setupcon">setupcon</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+keyboard">keyboard</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?8+setfont">setfont</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?1+vidcontrol">vidcontrol</A></B>(1)
<P>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
<DT id="11"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAD">OPTIONS</A><DD>
<DT id="13"><A HREF="#lbAE">CODESETS</A><DD>
<DL>
<DT id="14"><A HREF="#lbAF">Arabic (a big codeset)</A><DD>
<DT id="15"><A HREF="#lbAG">Armenian</A><DD>
<DT id="16"><A HREF="#lbAH">CyrAsia</A><DD>
<DT id="17"><A HREF="#lbAI">CyrKoi</A><DD>
<DT id="18"><A HREF="#lbAJ">CyrSlav</A><DD>
<DT id="19"><A HREF="#lbAK">Ethiopian (a big codeset)</A><DD>
<DT id="20"><A HREF="#lbAL">Georgian</A><DD>
<DT id="21"><A HREF="#lbAM">Greek</A><DD>
<DT id="22"><A HREF="#lbAN">Hebrew</A><DD>
<DT id="23"><A HREF="#lbAO">Lao</A><DD>
<DT id="24"><A HREF="#lbAP">Lat15</A><DD>
<DT id="25"><A HREF="#lbAQ">Lat2</A><DD>
<DT id="26"><A HREF="#lbAR">Lat38</A><DD>
<DT id="27"><A HREF="#lbAS">Lat7</A><DD>
<DT id="28"><A HREF="#lbAT">Thai</A><DD>
<DT id="29"><A HREF="#lbAU">Uni1 (a big codeset)</A><DD>
<DT id="30"><A HREF="#lbAV">Uni2 (a big codeset)</A><DD>
<DT id="31"><A HREF="#lbAW">Uni3 (a big codeset)</A><DD>
<DT id="32"><A HREF="#lbAX">Vietnamese (a big codeset)</A><DD>
</DL>
<DT id="33"><A HREF="#lbAY">FILES</A><DD>
<DT id="34"><A HREF="#lbAZ">NOTES</A><DD>
<DT id="35"><A HREF="#lbBA">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:02 GMT, March 31, 2021
</BODY>
</HTML>