272 lines
5.8 KiB
HTML
272 lines
5.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of SETUPCON</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>SETUPCON</H1>
|
|
Section: Console-setup User's Manual (1)<BR>Updated: 2011-03-17<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<P>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
setupcon - sets up the font and the keyboard on the console
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>setupcon</B>
|
|
|
|
[<I>OPTION</I>]... [<I>VARIANT</I>]
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>setupcon</B>
|
|
|
|
is a program for fast and easy setup of the font and the keyboard on
|
|
the console. Most of the time you invoke
|
|
<B>setupcon</B>
|
|
|
|
without arguments. The keyboard configuration is specified in
|
|
<I>~/.keyboard</I>
|
|
|
|
or
|
|
<I>/etc/default/keyboard</I>.
|
|
|
|
The font configuration is specified in
|
|
<I>~/.console-setup</I>
|
|
|
|
or
|
|
<I>/etc/default/console-setup</I>.
|
|
|
|
Consult
|
|
<B><A HREF="/cgi-bin/man/man2html?5+keyboard">keyboard</A></B>(5)
|
|
|
|
and
|
|
<B><A HREF="/cgi-bin/man/man2html?5+console-setup">console-setup</A></B>(5)
|
|
|
|
for instructions how to configure these two files.
|
|
<P>
|
|
|
|
If you have to switch often between different encodings, keyboards or
|
|
languages, you can prepare several alternative configuration files for
|
|
<B>setupcon</B>.
|
|
|
|
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
|
|
|
|
(<I>keyboard</I> and <I>console-setup</I>)
|
|
|
|
|
|
for Greek. Also, create alternative configuration files for German
|
|
named
|
|
|
|
<I>keyboard.german</I> and <I>console-setup.german</I>.
|
|
|
|
|
|
Then in order to configure the console for Greek you will simply run
|
|
the command with no arguments:
|
|
<I>setupcon</I>
|
|
|
|
and in order to configure the console for German you will use
|
|
|
|
<I>setupcon german</I>.
|
|
|
|
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1"><I>VARIANT</I>
|
|
|
|
<DD>
|
|
Specifies which configuration file to use. With no variant,
|
|
the configuration files of
|
|
<B>setupcon</B>
|
|
|
|
are named
|
|
<I>console-setup</I> and <I>keyboard</I>.
|
|
|
|
On the other hand, if you use e.g.
|
|
<I>chukchi</I>
|
|
|
|
as
|
|
<I>VARIANT</I>
|
|
|
|
then the configuration files are
|
|
<I>console-setup.chukchi</I> and <I>keyboard.chukchi</I>.
|
|
|
|
In this way you can have easy access to several different
|
|
configurations - for example one for the Chukchi language and another
|
|
for the default configuration.
|
|
<P>
|
|
<DT id="2"><B>-v</B>, <B>--verbose</B>
|
|
|
|
<DD>
|
|
Be more verbose. Use this option if something goes wrong or while
|
|
experimenting with the configuration files.
|
|
<P>
|
|
<DT id="3"><B>-k</B>, <B>--keyboard-only</B>
|
|
|
|
<DD>
|
|
Setup the keyboard only, do not setup the font or the terminal. On
|
|
Linux it is enough to do this configuration only once.
|
|
<P>
|
|
<DT id="4"><B>-f</B>, <B>--font-only</B>
|
|
|
|
<DD>
|
|
Setup the font only, do not setup the keyboard or the terminal. On
|
|
Linux this configuration should be repeated each time a new console
|
|
driver is activated (for example when the frame buffer becomes
|
|
active).
|
|
<P>
|
|
<DT id="5"><B>-t</B>, <B>--terminal-only</B>
|
|
|
|
<DD>
|
|
Setup the terminal only, do not setup the keyboard or the font.
|
|
<P>
|
|
<DT id="6"><B>--current-tty</B>
|
|
|
|
<DD>
|
|
Setup the only the current virtual terminal.
|
|
<P>
|
|
<DT id="7"><B>--force</B>
|
|
|
|
<DD>
|
|
Do not check whether we are on the console. Notice that you can be
|
|
forced to hard-reboot your computer if you run
|
|
<B>setupcon</B>
|
|
|
|
with this option and the screen is controlled by a X server.
|
|
<P>
|
|
<DT id="8"><B>--save</B>
|
|
|
|
<DD>
|
|
This option can be useful if you want to use
|
|
<B>setupcon</B>
|
|
|
|
early in the boot process while
|
|
<I>/usr</I>
|
|
|
|
is not yet mounted and the required data are not available. This
|
|
option will make
|
|
<B>setupcon</B>
|
|
|
|
copy the required files in
|
|
<I>/etc/console-setup/</I>
|
|
|
|
in order to make them available before
|
|
<I>/usr</I>
|
|
|
|
is mounted. If you use
|
|
<B>setupcon</B>
|
|
|
|
early in the boot process, then you should run it with this option
|
|
after every change of the console configuration.
|
|
<P>
|
|
<DT id="9"><B>--save-only</B>
|
|
|
|
<DD>
|
|
The same as
|
|
<I>--save</I>,
|
|
|
|
but does not setup anything. This option can be useful if you want to
|
|
save the required files while the screen is controlled by a X server.
|
|
<P>
|
|
<DT id="10"><B>--save-keyboard </B><I>FILE</I>
|
|
|
|
<DD>
|
|
For use by initrd builders. Do not configure anything. Save an
|
|
usable keyboard layout in
|
|
<I>FILE</I>.
|
|
|
|
<P>
|
|
<DT id="11"><B>--setup-dir </B><I>DIR</I>
|
|
|
|
<DD>
|
|
For use by initrd builders. Do not configure anything. Arrange in
|
|
the directory
|
|
<I>DIR</I>
|
|
|
|
everything necessary in order to configure the console. The file
|
|
<I>DIR/morefiles</I>
|
|
|
|
lists all binaries the initrd builder has to install in the initrd
|
|
image. All other files in
|
|
<I>DIR</I>
|
|
|
|
have to be copied unchanged in the initrd. In order to configure the
|
|
console one has to run the script
|
|
<I>DIR/bin/setupcon</I>.
|
|
|
|
<P>
|
|
<DT id="12"><B>-h</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Display usage information.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<I>~/.console-setup</I>
|
|
|
|
<BR>
|
|
|
|
<I>~/.keyboard</I>
|
|
|
|
<BR>
|
|
|
|
<I>/etc/default/console-setup</I>
|
|
|
|
<BR>
|
|
|
|
<I>/etc/default/keyboard</I>
|
|
|
|
<BR>
|
|
|
|
<I>/etc/default/console-setup.VARIANT</I>
|
|
|
|
<BR>
|
|
|
|
<I>/etc/default/keyboard.VARIANT</I>
|
|
|
|
<BR>
|
|
|
|
<I>/etc/console-setup/</I>
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+keyboard">keyboard</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+console-setup">console-setup</A></B>(5)
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="17"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="18"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:27 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|