setupcon

SETUPCON(1)               Console-setup User's Manual              SETUPCON(1)

NAME
       setupcon - sets up the font and the keyboard on the console

SYNOPSIS
       setupcon [OPTION]... [VARIANT]

DESCRIPTION
       setupcon  is a program for fast and easy setup of the font and the key-
       board on the console.  Most of the time  you  invoke  setupcon  without
       arguments.   The  keyboard configuration is specified in ~/.keyboard or
       /etc/default/keyboard.  The font configuration is specified in  ~/.con-
       sole-setup or /etc/default/console-setup.  Consult keyboard(5) and con-
       sole-setup(5) for instructions how to configure these two files.

       If you have to switch often between different encodings,  keyboards  or
       languages,  you can prepare several alternative configuration files for
       setupcon.  Suppose that most of the time you will  use  Greek  language
       with  Greek  keyboard  layout, but sometimes you need to type in German
       with German keyboard layout.  In this situation  you  should  customize
       the  main  configuration  files (keyboard and console-setup) for Greek.
       Create  also  alternative  configuration   files   for   German   named
       keyboard.german  and  console-setup.german.  Then in order to configure
       the console for Greek you will simply run the  command  with  no  argu-
       ments:  setupcon  and  in order to configure the console for German you
       will use setupcon german.

OPTIONS
       -v, --verbose
              Be more verbose.   Use this option if something  goes  wrong  or
              while experimenting with the configuration files.

       -k, --keyboard-only
              Setup the keyboard only, do not setup the font.

       -f, --font-only
              Setup the font only, do not setup the keyboard.

       --force
              Do not check whether we are on the console.  Notice that you can
              be forced to hard-reboot your computer if you run setupcon  with
              this option and the screen is controlled by a X server.

       --save This  option  can be useful if you want to use setupcon early in
              the boot process while /usr is not yet mounted and the  required
              data are not available.  This option will make setupcon copy the
              required files in /etc/console-setup/  in  order  to  make  them
              available  before /usr is mounted.  If you use setupcon early in
              the boot process, then you should run it with this option  after
              every change of the console configuration.

       --save-only
              The  same  as  --save,  but  does not setup the keyboard and the
              font.  This option can be useful if you want  to  save  the  re-
              quired files while the screen is controlled by a X server.

       -h, --help
              Display usage information.

       VARIANT
              Specifies  which configuration file to use.  By default the con-
              figuration files of setupcon are named  console-setup  and  key-
              board  but if you use e.g.  chukchi as VARIANT then the configu-
              ration files will be console-setup.chukchi and keyboard.chukchi.
              In  this  way you can have easy access to several different con-
              figurations - for example one for the Chukchi language  and  an-
              other for the default configuration.

FILES
       ~/.console-setup
       ~/.keyboard
       /etc/default/console-setup
       /etc/default/keyboard
       /etc/default/console-setup.VARIANT
       /etc/default/keyboard.VARIANT
       /etc/console-setup/

SEE ALSO
       keyboard(5), console-setup(5)

console-setup                     2011-03-17                       SETUPCON(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2021 Hurricane Electric. All Rights Reserved.