Linux "setupcon" Command Line Options and Examples
sets up the font and the keyboard on the console

setupcon is a program for fast and easy setup of the font and the keyboard on the console. Most of the time you invoke setupcon without arguments. The keyboard configuration is specified in ~/.


Usage:

setupcon [OPTION]... [VARIANT]




Command Line Options:

-v
Be more verbose. Use this option if something goes wrong or while experimenting with the configura‐tion files.
setupcon -v ...
-k
Setup the keyboard only, do not setup the font or the terminal. On Linux it is enough to do this con‐figuration only once.
setupcon -k ...
-f
Setup the font only, do not setup the keyboard or the terminal. On Linux this configuration should berepeated each time a new console driver is activated (for example when the frame buffer becomes ac‐tive).
setupcon -f ...
-t
Setup the terminal only, do not setup the keyboard or the font.
setupcon -t ...
--current-tty
Setup the only the current virtual terminal.
setupcon --current-tty ...
--force
Do not check whether we are on the console. Notice that you can be forced to hard-reboot your computerif you run setupcon with this option and the screen is controlled by a X server.
setupcon --force ...
--save-only
The same as --save, but does not setup anything. This option can be useful if you want to save the re‐quired files while the screen is controlled by a X server.
setupcon --save-only ...
--save-keyboard
For use by initrd builders. Do not configure anything. Save an usable keyboard layout in FILE.
setupcon --save-keyboard ...
--setup-dir
For use by initrd builders. Do not configure anything. Arrange in the directory DIR everything neces‐sary in order to configure the console. The file DIR/morefiles lists all binaries the initrd builderhas to install in the initrd image. All other files in DIR have to be copied unchanged in the initrd.In order to configure the console one has to run the script DIR/bin/setupcon.
setupcon --setup-dir ...
-h
Display usage information.FILES~/.console-setup~/.keyboard/etc/default/console-setup/etc/default/keyboard/etc/default/console-setup.VARIANT/etc/default/keyboard.VARIANT/etc/console-setup/
setupcon -h ...