NAME<\/a> console-setup \u2212 configuration file for setupcon<\/p>\n The file console-setup<\/b> specifies the encoding and the font to be used by setupcon<\/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 keyboard<\/b>(5) instead.<\/p>\n The font specification consists of three parameters \u2212 codeset, font face and font size. The codeset specifies what characters will be supported by the font. There isn\u2019t one-to-one correspondence between codeset and encoding, for example the codeset Lat15<\/b> is suitable for ISO\u00a08859-1, ISO\u00a08859-9 and ISO\u00a08859-15. The codesets are two kinds \u2212 small and big. Only small codesets are supported on FreeBSD.<\/p>\n The font face determines the general look of the font. Each font face is available in certain possible sizes. On FreeBSD only 8×16<\/b>, 8×14<\/b> and 8×8<\/b> are valid sizes. On Linux if framebuffer is not used or consolechars<\/b>(1) is installed instead of setfont<\/b>(1), then the permitted sizes have the form 8xNUMBER<\/i>.<\/p>\n 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 setupcon<\/b>(1) will load the selected font face in all available sizes.<\/p>\n The file console-setup<\/b> consists of variable settings in POSIX<\/small> format:<\/p>\n VARIABLE<\/i>=\u2019VALUE<\/i>\u2019<\/p>\n Only one assignment is allowed per line. Comments (starting with \u2019#\u2019) are also allowed.<\/p>\n The following variables can be set. Specifies the device files in \/dev<\/i> of the virtual terminals to be configured. File name wild-cards (*<\/b>,\u00a0?<\/b>) are allowed. On Linux usually you can set this to \/dev\/tty[1-6]<\/b> and on FreeBSD a sensible value is \/dev\/ttyv[0-8]<\/b>. You can assign to this variable also the special value guess<\/b>. It will cause setupcon<\/b>(1) to attempt to guess the active virtual consoles by looking in configuration files such as \/etc\/inittab<\/i> and \/etc\/ttys<\/i>. This guessing is not always reliable.<\/p>\n CHARMAP<\/b><\/p>\n Specifies the desired encoding on the console. Valid values are: UTF-8<\/b>, ARMSCII-8<\/b>, CP1251<\/b>, CP1255<\/b>, CP1256<\/b>, GEORGIAN-ACADEMY<\/b>, GEORGIAN-PS<\/b>, IBM1133<\/b>, ISIRI-3342<\/b>, ISO-8859-1<\/b>, ISO-8859-2<\/b>, ISO-8859-3<\/b>, ISO-8859-4<\/b>, ISO-8859-5<\/b>, ISO-8859-6<\/b>, ISO-8859-7<\/b>, ISO-8859-8<\/b>, ISO-8859-9<\/b>, ISO-8859-10<\/b>, ISO-8859-11<\/b>, ISO-8859-13<\/b>, ISO-8859-14<\/b>, ISO-8859-15<\/b>, ISO-8859-16<\/b>, KOI8-R<\/b>, KOI8-U<\/b>, TIS-620<\/b> and VISCII<\/b>. The special value guess<\/b> is also recognized in which case the system command locale<\/b>(1) will be used to guess the desired encoding (currently this works reliably only with GNU<\/small> libc).<\/p>\n CODESET<\/b><\/p>\n In most cases the special value 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: Armenian<\/b>, CyrAsia<\/b>, CyrKoi<\/b>, CyrSlav<\/b>, Georgian<\/b>, Greek<\/b>, Hebrew<\/b>, Lao<\/b>, Lat15<\/b>, Lat2<\/b>, Lat38<\/b>, Lat7<\/b> and Thai<\/b>. Valid big codesets are: Arabic<\/b>, Ethiopian<\/b>, Uni1<\/b>, Uni2<\/b>, Uni3<\/b> and Vietnamese<\/b>. Only small codesets can be used on FreeBSD. See below the section entitled \u201cCODESETS\u201d for detailed description of each of these codesets.<\/p>\n FONTFACE<\/b> and FONTSIZE<\/b><\/p>\n Valid font faces are: VGA<\/b> (sizes 8×8<\/b>, 8×14<\/b>, 8×16<\/b>, 16×28<\/b> and 16×32<\/b>), Terminus<\/b> (sizes 6×12<\/b>, 8×14<\/b>, 8×16<\/b>, 10×20<\/b>, 12×24<\/b>, 14×28<\/b> and 16×32<\/b>), TerminusBold<\/b> (sizes 8×14<\/b>, 8×16<\/b>, 10×20<\/b>, 12×24<\/b>, 14×28<\/b> and 16×32<\/b>), TerminusBoldVGA<\/b> (sizes 8×14<\/b> and 8×16<\/b>), and Fixed<\/b> (sizes 8×13<\/b>, 8×14<\/b>, 8×15<\/b>, 8×16<\/b> and 8×18<\/b>). If however CODESET<\/b>=Ethiopian<\/b>, then the available font faces are Goha<\/b> and GohaClassic<\/b>, each in sizes 8×12<\/b>, 8×14<\/b> and 8×16<\/b>.<\/p>\n Set FONTFACE<\/b> and FONTSIZE<\/b> to empty strings if you want to configure only the keyboard and to leave the console font unchanged.<\/p>\n VIDEOMODE<\/b><\/p>\n Set VIDEOMODE<\/b> to an empty string to avoid setting up the video mode. On FreeBSD you can run<\/p>\n vidcontrol -i mode<\/p>\n in order to see all possible video modes. On Linux fbset<\/b>(1) is used to configure the video mode but very often this doesn\u2019t work because the default framebuffer driver (VesaFB) is rather limited and doesn\u2019t allow changes of the video mode.<\/p>\n FONT<\/b>, FONT_MAP<\/b> and CONSOLE_MAP<\/b><\/p>\n If set, specify that a non standard font is to be used. The value of the variable FONT<\/b> consists of one or more space separated font file names. On Linux, when the font doesn\u2019t contain embedded Unicode map, an external map can be specified with the variable FONT_MAP<\/b>. The value of CONSOLE_MAP<\/b> is a file that specifies a translation map from the user\u2019s 8-bit encoding to Unicode (Linux only) or directly to font positions.<\/p>\n SCREEN_WIDTH<\/b> and SCREEN_HEIGHT<\/b><\/p>\n If set, these variables specify a screen size that setupcon<\/b>(1) will enforce with stty<\/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>\n
DESCRIPTION<\/a>
OPTIONS<\/a>
CODESETS<\/a>
FILES<\/a>
NOTES<\/a>
SEE ALSO<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
OPTIONS <\/a> <\/h2>\n
ACTIVE_CONSOLES<\/b><\/p>\n