Dr Andrew Scott G7VAV

MBCS, MIET, Member ACM, Member IEEE

Senior Lecturer
School of Computing
and Communications

D35 InfoLab21
Lancaster University
Lancaster, LA1 4WA
United Kingdom

setupcon

Section: User Manuals (1)
Updated: APR 2007
Index Return to Main Contents

NAME

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

setupcon [ option ]... [ variant ... ]

setupcon is a program for fast and easy setup of the font and the keyboard on the Linux console.

-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 you are on a X server.
-v, --verbose: Be more verbose. Use this option if something goes wrong.
--save: If you want to use setupcon early in the boot process, it is possible that /usr is not yet mounted and the required data are not available. This option makes setupcon copy the required data in /etc/console-setup in order to make it available before /usr is mounted. If you use setupcon early in the boot process, then use this option whenever you change the console configuration.
--save-only: Same like --save, but do not setup the keyboard and the font. This option can be useful if you run setupcon in a X server.
-h, --help: Display usage information.
variant: Specifies which configuration file to use. By default the configuration file of setupcon is /etc/default/console-setup but if you use e.g. "chukchi" as variant then the configuration file will be /etc/default/console-setup.chukchi. This allows you to have several different configurations - for example one for the Chukchi language and another in /etc/default/console-setup for your default configuration.

Most of the time you invoke setupcon without arguments. Please look at the README file for more information.

for client (none)

Andrew Scott