|
NAMEsyscons , sc —
the console driver
SYNOPSISoptions MAXCONS=N
options SC_ALT_MOUSE_IMAGE
options SC_CUT_SEPCHARS=_characters_
options SC_CUT_SPACES2TABS
options SC_DFLT_TERM
options SC_DISABLE_KDBKEY
options SC_DISABLE_REBOOT
options SC_HISTORY_SIZE=N
options SC_MOUSE_CHAR=C
options SC_NO_CUTPASTE
options SC_NO_FONT_LOADING
options SC_NO_HISTORY
options SC_NO_PALETTE_LOADING
options SC_NO_SUSPEND_VTYSWITCH
options SC_NO_SYSMOUSE
options SC_NO_TERM_DUMB
options SC_NO_TERM_SC
options SC_NO_TERM_SCTEKEN
options SC_PIXEL_MODE
options SC_TWOBUTTON_MOUSE
options SC_NORM_ATTR=_attribute_
options SC_NORM_REV_ATTR=_attribute_
options SC_KERNEL_CONS_ATTR=_attribute_
options SC_KERNEL_CONS_ATTRS=_attributes_
options SC_KERNEL_CONS_REV_ATTR=_attribute_
options SC_DFLT_FONT
makeoptions SC_DFLT_FONT=_font_name_
device sc
In /boot/device.hints:
In /boot/loader.conf:
DESCRIPTIONThesyscons driver provides multiple virtual terminals.
It resembles the SCO color console driver.
The There can be only one Virtual TerminalsThesyscons driver provides multiple virtual terminals
which appear as if they were separate terminals. One virtual terminal is
considered current and exclusively occupies the screen and the keyboard; the
other virtual terminals are placed in the background.
In order to use virtual terminals, they must be individually marked ``on'' in /etc/ttys so that getty(8) will recognize them to be active and run login(1) to let the user log in to the system. By default, only the first eight virtual terminals are activated in /etc/ttys. You press the Alt-F1 ttyv0 Alt-F7 ttyv6 Shift-Alt-F1 ttyva Alt-F2 ttyv1 Alt-F8 ttyv7 Shift-Alt-F2 ttyvb Alt-F3 ttyv2 Alt-F9 ttyv8 Shift-Alt-F3 ttyvc Alt-F4 ttyv3 Alt-F10 ttyv9 Shift-Alt-F4 ttyvd Alt-F5 ttyv4 Alt-F11 ttyva Shift-Alt-F5 ttyve Alt-F6 ttyv5 Alt-F12 ttyvb Shift-Alt-F6 ttyvf You can also use the ``nscr'' key (usually the
The default number of available virtual terminals is 16. This can
be changed with the kernel configuration option
Note that the X server usually requires a virtual terminal for display purposes, so at least one terminal must be left unused by getty(8) so that it can be used by the X server. Key Definitions and Function Key StringsThesyscons driver, in conjunction with the keyboard
driver, allows the user to change key definitions and function key strings.
The
kbdcontrol(1)
command will load a key definition file (known as ``keymap'' file), dump the
current keymap, and assign a string to a function key. See
keyboard(4)
and
kbdmap(5)
for the keymap file.
You may want to set the keymap variable in /etc/rc.conf.local to the desired keymap file so that it will be automatically loaded when the system starts up. Software FontFor most modern video cards, e.g., VGA, thesyscons
driver and the video card driver allow the user to change the font used on the
screen. The
vidcontrol(1)
command can be used to load a font file from
/usr/share/syscons/fonts.
The font comes in various sizes: 8x8, 8x14 and 8x16. The 8x16 font is typically used for the VGA card in the 80-column-by-25-line mode. Other video modes may require different font sizes. It is better to always load all three sizes of the same font. You may set font8x8, font8x14 and font8x16 variables in /etc/rc.conf to the desired font files so that they will be automatically loaded when the system starts up. Optionally you can specify a particular font file as the default.
See the Screen MapIf your video card does not support software fonts, you may still be able to achieve a similar effect by re-mapping the font built into your video card. Use vidcontrol(1) to load a screen map file which defines the mapping between character codes.Mouse Support and Copy-and-PasteYou can use your mouse to copy text on the screen and paste it as if it was typed by hand. You must be running the mouse daemon moused(8) and enable the mouse cursor in the virtual terminal via vidcontrol(1).Pressing mouse button 1 (usually the left button) will start selection. Releasing button 1 will end the selection process. The selected text will be marked by inverting foreground and background colors. You can press button 3 (usually the right button) to extend the selected region. The selected text is placed in the copy buffer and can be pasted at the cursor position by pressing button 2 (usually the middle button) as many times as you like. If your mouse has only two buttons, you may want to use the
Back ScrollingThesyscons driver allows the user to browse the output
which has ``scrolled off'' the top of the screen.
Press the ``slock'' key (usually The size of the scrollback buffer can be set by the
Screen SaverThesyscons driver can be made to put up the screen
saver if the current virtual terminal is idle, that is, the user is not typing
on the keyboard nor moving the mouse. See
splash(4)
and
vidcontrol(1)
for more details.
DRIVER CONFIGURATIONKernel Configuration OptionsThe following kernel configuration options control thesyscons driver.
The following options will remove some features from the
Driver FlagsThe following driver flags can be used to control thesyscons driver. Driver flags can be set with the
hint.sc.0.flags tunable, either in
/boot/device.hints, or else at the loader prompt (see
loader(8)).
Loader TunablesThese settings can be entered at the loader(8) prompt or in loader.conf(5).FILES
EXAMPLESAs thesyscons driver requires the keyboard driver and
the video card driver, the kernel configuration file should contain the
following lines.
device atkbdc device atkbd device vga device sc device splash You also need the following lines in /boot/device.hints for these drivers. hint.atkbdc.0.at="isa" hint.atkbdc.0.port="0x060" hint.atkbd.0.at="atkbdc" hint.atkbd.0.irq="1" hint.vga.0.at="isa" hint.sc.0.at="isa" If you do not intend to load the splash image or use the screen saver, the last line is not necessary, and can be omitted. Note that the keyboard controller driver
The following lines will set the default colors. The normal text will be green on black background. The reversed text will be yellow on green background. Note that you cannot put any white space inside the quoted string, because of the current implementation of config(8). options
SC_NORM_ATTR=(FG_GREEN|BG_BLACK) options
SC_NORM_REV_ATTR=(FG_YELLOW|BG_GREEN) The following lines will set the default colors of the kernel message. The kernel message will be printed bright red on black background. The reversed message will be black on red background. options
SC_KERNEL_CONS_ATTR=(FG_LIGHTRED|BG_BLACK) options
SC_KERNEL_CONS_REV_ATTR=(FG_BLACK|BG_RED) Provided options
SC_KERNEL_CONS_ATTRS=\"\x0c\x04\x40\x0e\" The default scheme is probably better for up to 8 CPUs. Use a long string to get unique colors for more than 8 CPUs. To turn off all per-CPU coloring of kernel messages, set SC_KERNEL_CONS_ATTR to a non-default value, or use the default in a pattern of length 1. options
SC_KERNEL_CONS_ATTRS=\"\x0f\" The following example adds the font files cp850-8x16.fnt, cp850-8x14.font and cp850-8x8.font to the kernel. options SC_DFLT_FONT makeoptions
SC_DFLT_FONT=cp850 device sc SEE ALSOkbdcontrol(1), login(1), vidcontrol(1), atkbd(4), atkbdc(4), keyboard(4), screen(4), splash(4), ukbd(4), vga(4), vt(4), kbdmap(5), rc.conf(5), ttys(5), config(8), getty(8), kldload(8), moused(8)HISTORYThesyscons driver first appeared in
FreeBSD 1.0.
AUTHORSThesyscons driver was written by
Søren Schmidt
<sos@FreeBSD.org>. This
manual page was written by Kazutaka Yokota
<yokota@FreeBSD.org>.
CAVEATSThe amount of data that is possible to insert from the cut buffer is limited by the {MAX_INPUT }, a system limit on the number of bytes
that may be stored in the terminal input queue - usually 1024 bytes (see
termios(4)).
BUGSThis manual page is incomplete and urgently needs revision.
Visit the GSP FreeBSD Man Page Interface. |