1SETUPCON(1)               Console-setup User's Manual              SETUPCON(1)
2
3
4

NAME

6       setupcon - sets up the font and the keyboard on the console
7
8

SYNOPSIS

10       setupcon [OPTION]... [VARIANT]
11
12

DESCRIPTION

14       setupcon  is a program for fast and easy setup of the font and the key‐
15       board on the console.  Most of the time  you  invoke  setupcon  without
16       arguments.   The  keyboard configuration is specified in ~/.keyboard or
17       /etc/default/keyboard.  The font configuration is specified in  ~/.con‐
18       sole-setup or /etc/default/console-setup.  Consult keyboard(5) and con‐
19       sole-setup(5) for instructions how to configure these two files.
20
21       If you have to switch often between different encodings,  keyboards  or
22       languages,  you can prepare several alternative configuration files for
23       setupcon.  Suppose that most of the time you will  use  Greek  language
24       with  Greek  keyboard  layout, but sometimes you need to type in German
25       with German keyboard layout.  In this situation  you  should  customize
26       the  main  configuration  files (keyboard and console-setup) for Greek.
27       Also,  create  alternative  configuration  files   for   German   named
28       keyboard.german  and  console-setup.german.  Then in order to configure
29       the console for Greek you will simply run the  command  with  no  argu‐
30       ments:  setupcon  and  in order to configure the console for German you
31       will use setupcon german.
32
33
34

OPTIONS

36       VARIANT
37              Specifies which configuration file to use.  With no variant, the
38              configuration files of setupcon are named console-setup and key‐
39              board.  On the other hand, if you use e.g.  chukchi  as  VARIANT
40              then  the configuration files are console-setup.chukchi and key‐
41              board.chukchi.  In this way you can have easy access to  several
42              different  configurations - for example one for the Chukchi lan‐
43              guage and another for the default configuration.
44
45
46       -v, --verbose
47              Be more verbose.   Use this option if something  goes  wrong  or
48              while experimenting with the configuration files.
49
50
51       -k, --keyboard-only
52              Setup  the keyboard only, do not setup the font or the terminal.
53              On Linux it is enough to do this configuration only once.
54
55
56       -f, --font-only
57              Setup the font only, do not setup the keyboard or the  terminal.
58              On  Linux  this configuration should be repeated each time a new
59              console driver is activated (for example when the  frame  buffer
60              becomes active).
61
62
63       -t, --terminal-only
64              Setup the terminal only, do not setup the keyboard or the font.
65
66
67       --current-tty
68              Setup the only the current virtual terminal.
69
70
71       --force
72              Do not check whether we are on the console.  Notice that you can
73              be forced to hard-reboot your computer if you run setupcon  with
74              this option and the screen is controlled by a X server.
75
76
77       --save This  option  can be useful if you want to use setupcon early in
78              the boot process while /usr is not yet mounted and the  required
79              data are not available.  This option will make setupcon copy the
80              required files in /etc/console-setup/  in  order  to  make  them
81              available  before /usr is mounted.  If you use setupcon early in
82              the boot process, then you should run it with this option  after
83              every change of the console configuration.
84
85
86       --save-only
87              The  same  as  --save, but does not setup anything.  This option
88              can be useful if you want to save the required files  while  the
89              screen is controlled by a X server.
90
91
92       --save-keyboard FILE
93              For use by initrd builders.  Do not configure anything.  Save an
94              usable keyboard layout in FILE.
95
96
97       --setup-dir DIR
98              For use by initrd builders.  Do not configure anything.  Arrange
99              in  the directory DIR everything necessary in order to configure
100              the console.  The file DIR/morefiles lists all binaries the ini‐
101              trd builder has to install in the initrd image.  All other files
102              in DIR have to be copied unchanged in the initrd.  In  order  to
103              configure  the  console one has to run the script DIR/bin/setup‐
104              con.
105
106
107       -h, --help
108              Display usage information.
109
110

FILES

112       ~/.console-setup
113       ~/.keyboard
114       /etc/default/console-setup
115       /etc/default/keyboard
116       /etc/default/console-setup.VARIANT
117       /etc/default/keyboard.VARIANT
118       /etc/console-setup/
119
120

SEE ALSO

122       keyboard(5), console-setup(5)
123
124
125
126console-setup                     2011-03-17                       SETUPCON(1)
Impressum