Initial. Don't... just don't ask.
This commit is contained in:
Ryan McGrath
commit
00bae13bba
586 changed files with 129057 additions and 0 deletions
80
doc/man1/convfont.1
Normal file
80
doc/man1/convfont.1
Normal file
|
|
@ -0,0 +1,80 @@
|
|||
.TH convfont 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
convfont \- convert font files for svgalib
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI convfont " fontfile fontheight vgafontfile"
|
||||
|
||||
.SH DESCRIPTION
|
||||
convert the standard format binary fontfile name
|
||||
.I fontfile
|
||||
to the codepage format required by
|
||||
.BR restorefont (1).
|
||||
The converted font is written to
|
||||
.IR vgafontfile .
|
||||
|
||||
A binary font file of any number of characters up to 256 can be used, although
|
||||
at least defining the first 128 characters is a good idea. The
|
||||
.I fontheight
|
||||
must be in the range
|
||||
.BR 1 " - " 32 .
|
||||
|
||||
The
|
||||
.I fontfile
|
||||
file consist of
|
||||
.I fontheight
|
||||
bytes stored sequentially (top to bottom) for each character in your
|
||||
font, starting with the character with code 0.
|
||||
|
||||
The format of
|
||||
.I vgafontfile
|
||||
is that required by
|
||||
.BR restorefont (1)
|
||||
and described there.
|
||||
|
||||
This utility is part of svgalib and can be found in the
|
||||
.I utils/
|
||||
subdirectory of the original svgalib distribution. However, it is not installed
|
||||
by default, s.t. it is unclear where you can find it if your svgalib was install
|
||||
linux distribution.
|
||||
|
||||
In case of any such problem, simply get an svgalib distribution from the net. You
|
||||
don't need to install it. Just
|
||||
.B make
|
||||
in the
|
||||
.I utils/
|
||||
subdirecty. As of this writing,
|
||||
.I svgalib-1.2.12.tar.gz
|
||||
is the latest version and can be retrieved by ftp from
|
||||
.IR "sunsite.unc.edu" " at " "/pub/Linux/libs/graphics"
|
||||
and
|
||||
.IR "tsx-11.mit.edu" " at " "/pub/linux/sources/libs"
|
||||
which will most probably be mirrored by a site close to you.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR dumpreg (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR restorefont (1),
|
||||
.BR restorepalette (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
54
doc/man1/dumpreg.1
Normal file
54
doc/man1/dumpreg.1
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
.TH dumpreg 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
dumpreg \- dump the state of the card as the svgalib chipset driver sees it.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI dumpreg
|
||||
.br
|
||||
.BI "dumpreg < /dev/tty" N
|
||||
|
||||
.SH DESCRIPTION
|
||||
The chipset drivers of svgalib inquire the mode of the graphic card when the application
|
||||
is started and restore it when the svgalib application quits.
|
||||
.B dumpreg
|
||||
prints this information to stdout.
|
||||
|
||||
This is useful for debugging or adding modes to a device driver. For example you can
|
||||
use Xfree86 to setup a given mode timing, then run
|
||||
.B dumpreg
|
||||
and use it's stdout to make your chipset driver use exactly this timing.
|
||||
|
||||
However, the recent change of svgalib to hunt an own free virtual console does not allow
|
||||
this, because it will make Xfree86 return to textmode first. You can avoid this by using
|
||||
the second form where
|
||||
.I N
|
||||
is the number of the virtual console on which Xfree86 runs (usually 7) as root.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR vga_dumpregs (3),
|
||||
.BR convfont (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR restorefont (1),
|
||||
.BR restorepalette (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
91
doc/man1/fix132x43.1
Normal file
91
doc/man1/fix132x43.1
Normal file
|
|
@ -0,0 +1,91 @@
|
|||
.TH fix132x43 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
fix132x43 \- fix problems with certain (132 column) graphics modes
|
||||
dump the state of the card as the svgalib chipset driver sees it.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI fix132x43 " options"
|
||||
|
||||
.SH DESCRIPTION
|
||||
This program tries to fix problems with extended textmodes on some cards. The problem is that for
|
||||
132x43 textmode, some BIOS's set the vertical display end register to 349 (350), instead of 343
|
||||
(344 = 3 * 8 scanlines). Because in Linux textmode video memory is usually filled with old text
|
||||
that has already scrolled away (this includes the area below the 43rd textmode line, which changes
|
||||
when the console scrolls), the top half of a constantly changing irrelevant text line is visible
|
||||
at the bottom of the screen, which is very annoying.
|
||||
|
||||
This program sets the VGA Vertical Display End register to the proper value.
|
||||
|
||||
This problem is at least present in the BIOS of most Cirrus Logic 542x based cards, and
|
||||
some WD90C03x based cards.
|
||||
|
||||
The
|
||||
.B LINES
|
||||
environment variable is used to detect 43 or 44 line consoles.
|
||||
|
||||
.SH OPTIONS
|
||||
You have to specify exactly one of the following options:
|
||||
.TP
|
||||
.B -f
|
||||
Fix problem of annoying changing line of text at bottom of screen.
|
||||
.TP
|
||||
.B -v
|
||||
Switch to 9 line characters (400 line frame, 70 Hz).
|
||||
.TP
|
||||
.B -w
|
||||
Switch to 11 line characters (480 line frame, 60 Hz).
|
||||
|
||||
.B fix132x43
|
||||
does not usually provide this option but it can be enabled in the source of
|
||||
.BR fix132x43.
|
||||
|
||||
.TP
|
||||
.B -r
|
||||
Switch to 8 line characters again (350 line frame, 70 Hz).
|
||||
.PP
|
||||
This utility is part of svgalib and can be found in the
|
||||
.I utils/
|
||||
subdirectory of the original svgalib distribution. However, it is not installed
|
||||
by default, s.t. it is unclear where you can find it if your svgalib was install
|
||||
linux distribution.
|
||||
|
||||
In case of any such problem, simply get an svgalib distribution from the net. You
|
||||
don't need to install it. Just
|
||||
.B make
|
||||
in the
|
||||
.I utils/
|
||||
subdirecty. As of this writing,
|
||||
.I svgalib-1.2.12.tar.gz
|
||||
is the latest version and can be retrieved by ftp from
|
||||
.IR "sunsite.unc.edu" " at " "/pub/Linux/libs/graphics"
|
||||
and
|
||||
.IR "tsx-11.mit.edu" " at " "/pub/linux/sources/libs"
|
||||
which will most probably be mirrored by a site close to you.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR convfont (1),
|
||||
.BR dumpreg (1),
|
||||
.BR restorefont (1),
|
||||
.BR restorepalette (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
125
doc/man1/restorefont.1
Normal file
125
doc/man1/restorefont.1
Normal file
|
|
@ -0,0 +1,125 @@
|
|||
.TH restorefont 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
restorefont \- save or restore the SVGA font for textmode.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI "restorefont {-r|-w} " filename
|
||||
|
||||
.SH DESCRIPTION
|
||||
The font used by SVGA when in textmode is written to or restored from
|
||||
.IR filename
|
||||
using the
|
||||
.BR vga_gettextfont "(3) and "
|
||||
.BR vga_puttextfont (3)
|
||||
functions.
|
||||
|
||||
.SH FILE FORMAT
|
||||
The VGA font file
|
||||
.I filename
|
||||
has the following format:
|
||||
|
||||
.RS
|
||||
.BR Offset:
|
||||
.br
|
||||
.BR " 0 - 31 " "Character 0"
|
||||
.br
|
||||
.BR " ... " " ..."
|
||||
.br
|
||||
.BR "8164 - 8195 " "Character 255"
|
||||
.RE
|
||||
|
||||
Each row of a character bitmap is stored as a byte (8 pixels).
|
||||
The space that is left from the 32-byte buffer for each character
|
||||
is ignored, e.g. a 16 line font uses only offsets 0 - 15 of each character.
|
||||
|
||||
Linux textmode screen resolutions:
|
||||
|
||||
.BR 80x25 " 16 line font 400 scanlines"
|
||||
.br
|
||||
.BR 80x28 " 14 line font 400 scanlines"
|
||||
.br
|
||||
.BR 80x50 " 8 line font 400 scanlines"
|
||||
|
||||
The font sizes and resolutions of extended textmodes depend on the
|
||||
video card type and BIOS:
|
||||
|
||||
.BR 132x25 " 14 line font 350 scanlines (ugly)"
|
||||
.br
|
||||
.BR 132x25 " 16 line font 400 scanlines"
|
||||
.br
|
||||
.BR 132x43 " 8 line font 350 scanlines (use fix132x43 to fix/improve)"
|
||||
.br
|
||||
.BR 132x50 " 8 line font 400 scanlines"
|
||||
.br
|
||||
|
||||
Using a font that has less lines per character than the textmode works, but
|
||||
the characters are smaller. Using a font that is bigger than the textmode
|
||||
font results in the bottom part of characters being cut off.
|
||||
|
||||
The svgalib distribution contains sample fonts with 8, 14 and 16 line characters
|
||||
in the files
|
||||
.IR utils/font8 ", " utils/font14 ", and " utils/font16 .
|
||||
|
||||
The
|
||||
.BR convfont
|
||||
(1) program can be used to convert fonts straightforwardly stored
|
||||
character-after-character (i.e. each character only uses 8/14/whatever
|
||||
bytes), to the 32-byte per character format that
|
||||
.B restorefont
|
||||
requires.
|
||||
|
||||
The purpose of this program is usually to recover from a crashed console due to an
|
||||
svgalib, Xfree or other program bug. First save the state of the SVGA card when on a
|
||||
text console. After the crash restore this state. The
|
||||
.BR savetextmode (1)
|
||||
and
|
||||
.BR textmode (1)
|
||||
script makes this procedure very easy.
|
||||
|
||||
The national/fontpak packages, which include kernel patches, allow different
|
||||
textmode fonts to be used in different virtual consoles. These have been
|
||||
superseded by the kbd package (in the kernel since ages). See the
|
||||
.BR setfont (8)
|
||||
utility of the kbd package as a starting point.
|
||||
|
||||
Recent kernels support up to 2 fonts with 512 chars each. Recent versions
|
||||
of svgalib take this into account and extend the size of the datafile accordingly.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.BI "-w " filename
|
||||
write the font to the file
|
||||
.IR filename .
|
||||
.TP
|
||||
.BI "-r " filename
|
||||
restore the font from the file
|
||||
.IR filename .
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR setfont (8),
|
||||
.BR vga_gettextfont (3),
|
||||
.BR vga_puttextfont (3),
|
||||
.BR dumpreg (1),
|
||||
.BR convfont (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR restorepalette (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
107
doc/man1/restorepalette.1
Normal file
107
doc/man1/restorepalette.1
Normal file
|
|
@ -0,0 +1,107 @@
|
|||
.TH restorepalette 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
restorepalette \- set the color palette for textmode.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI "restorepalette [" filename ]
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B restorepalette
|
||||
without arguments sets the standard VGA palette. This can be useful
|
||||
if it is somehow messed up.
|
||||
|
||||
With a
|
||||
.I filename
|
||||
argument a custom palette can be loaded (feature added by Charles Blake
|
||||
<chuckb@alice.wonderland.caltech.edu>).
|
||||
|
||||
This allow a user to set up a file that looks like this one
|
||||
(These color map definitions are the same as the default VGA ones.
|
||||
Alter to suite personal tastes). The first column contains the number of
|
||||
the color to set, then follow three integers in range 0 - 63 (lowest to
|
||||
highest intensity) for red, green, blue.
|
||||
|
||||
.RS
|
||||
.B " 0 0 0 0 # black"
|
||||
.br
|
||||
.B " 1 0 0 42 # blue"
|
||||
.br
|
||||
.B " 2 0 42 0 # green"
|
||||
.br
|
||||
.B " 3 0 42 42 # cyan"
|
||||
.br
|
||||
.B " 4 42 0 0 # red"
|
||||
.br
|
||||
.B " 5 42 0 42 # magenta"
|
||||
.br
|
||||
.B " 6 42 21 0 # brown"
|
||||
.br
|
||||
.B " 7 42 42 42 # white"
|
||||
.br
|
||||
.B " 8 21 21 21 # bright black"
|
||||
.br
|
||||
.B " 9 21 21 63 # bright blue"
|
||||
.br
|
||||
.B "10 21 63 21 # bright green"
|
||||
.br
|
||||
.B "11 21 63 63 # bright cyan"
|
||||
.br
|
||||
.B "12 63 21 21 # bright red"
|
||||
.br
|
||||
.B "13 63 21 63 # bright magenta"
|
||||
.br
|
||||
.B "14 63 63 21 # bright brown"
|
||||
.br
|
||||
.B "15 63 63 63 # bright white"
|
||||
.RE
|
||||
|
||||
The inline comments are the
|
||||
only kind of allowed, as I use a little
|
||||
.BR fscanf (3)
|
||||
trick to get them. Blank lines
|
||||
are ok, but not pure comment lines. See the comments in my code, also.
|
||||
|
||||
This allows people to set up custom palettes for use in virtual console text
|
||||
modes. I use it all the time. When combined with a color-syntax editor like
|
||||
jed-0.97+ or color-ls, etc., being able to choose your own text-mode palette is
|
||||
quite a bonus. I set mine up via
|
||||
.B restorepalette /etc/palette
|
||||
in my
|
||||
.IR /etc/rc .
|
||||
If the program is given the correct permissions, then individual users can
|
||||
have
|
||||
.B restorepalette ~/.palette
|
||||
or some such thing in their shell startup
|
||||
files.
|
||||
Of course, it shouldn't be done when starting remote shells or when
|
||||
under X, so some kind of test that
|
||||
.B TERM
|
||||
is a virtual console is needed for that case.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR vga_setpalvec (3),
|
||||
.BR dumpreg (1),
|
||||
.BR convfont (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR restorefont (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
66
doc/man1/restoretextmode.1
Normal file
66
doc/man1/restoretextmode.1
Normal file
|
|
@ -0,0 +1,66 @@
|
|||
.TH restoretextmode 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
restoretextmode \- save or restore the SVGA registers for textmode.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI "restoretextmode {-r|-w} " filename
|
||||
|
||||
.SH DESCRIPTION
|
||||
The state of the SVGA is written to or restored from
|
||||
.IR filename
|
||||
using the
|
||||
.BR vga_gettextmoderegs "(3) and "
|
||||
.BR vga_settextmoderegs (3)
|
||||
functions.
|
||||
|
||||
As of this writing this file is 385 bytes long but this might change with future versions.
|
||||
|
||||
Please do not fiddle with the contents of the file except when you know what you do. It
|
||||
might even result in hardware damage. Because of that, you should think twice to make
|
||||
this command available to all users on your system.
|
||||
|
||||
The purpose of this program is usually to recover from a crashed console due to an
|
||||
svgalib, Xfree or other program bug. First save the state of the SVGA card when on a
|
||||
text console. After the crash restore this state. The
|
||||
.BR savetextmode (1)
|
||||
and
|
||||
.BR textmode (1)
|
||||
script makes this procedure very easy.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.BI "-w " filename
|
||||
write the SVGA state to the file
|
||||
.IR filename .
|
||||
.TP
|
||||
.BI "-r " filename
|
||||
restore the SVGA state from the file
|
||||
.IR filename .
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR vga_gettextmoderegs (3),
|
||||
.BR vga_settextmoderegs (3),
|
||||
.BR dumpreg (1),
|
||||
.BR convfont (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR restorefont (1),
|
||||
.BR restorepalette (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
104
doc/man1/runx.1
Normal file
104
doc/man1/runx.1
Normal file
|
|
@ -0,0 +1,104 @@
|
|||
.TH runx 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
runx \- try to overcome problems of Xfree96 restoring textmode using svgalib.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI runx
|
||||
|
||||
.SH DESCRIPTION
|
||||
If XFree86 corrupts your textmode font, try putting
|
||||
.BR restorefont (1)
|
||||
in your path and use the shell script
|
||||
.B runx
|
||||
to run X.
|
||||
.B runx
|
||||
saves the VGA font data in
|
||||
.IR /tmp/fontdata ,
|
||||
and restores it when you exit X.
|
||||
|
||||
The
|
||||
.B runx
|
||||
script actually is:
|
||||
|
||||
.RS
|
||||
.B #!/bin/sh
|
||||
.br
|
||||
.B echo Saving font in /tmp/fontdata
|
||||
.br
|
||||
.B restorefont -w /tmp/fontdata
|
||||
.br
|
||||
.B startx
|
||||
.br
|
||||
.B echo Restoring font from /tmp/fontdata
|
||||
.br
|
||||
.B restorefont -r /tmp/fontdata
|
||||
.RE
|
||||
|
||||
Note that this doesn't help with syncing problems.
|
||||
|
||||
A more rigorous alternative is to run the
|
||||
.BR savetextmode (1)
|
||||
script before running X, and
|
||||
.BR textmode (1)
|
||||
after. This will restore the textmode registers and the VGA palette in addition to the VGA font.
|
||||
|
||||
Assuming that
|
||||
.BR savetextmode (1)
|
||||
and
|
||||
.BR textmode (1)
|
||||
are in your
|
||||
.BR PATH
|
||||
the
|
||||
.B runx
|
||||
script would then look like:
|
||||
|
||||
.RS
|
||||
.B #!/bin/sh
|
||||
.br
|
||||
.B echo Saving SVGA state
|
||||
.br
|
||||
.B savetextmode
|
||||
.br
|
||||
.B startx
|
||||
.br
|
||||
.B echo restoring SVGA state
|
||||
.br
|
||||
.B textmode
|
||||
.RE
|
||||
|
||||
.PP
|
||||
This utility is part of svgalib and can be found in the
|
||||
.I utils/
|
||||
subdirectory of the original svgalib distribution. However, it is not installed
|
||||
by default, s.t. it is unclear where you can find it if your svgalib was install
|
||||
by a linux distribution.
|
||||
|
||||
However, this is no big deal as it was printed out above already ;-).
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR convfont (1),
|
||||
.BR dumpreg (1),
|
||||
.BR restorefont (1),
|
||||
.BR restorepalette (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR savetextmode (1),
|
||||
.BR setmclk (1),
|
||||
.BR textmode (1).
|
||||
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
71
doc/man1/savetextmode.1
Normal file
71
doc/man1/savetextmode.1
Normal file
|
|
@ -0,0 +1,71 @@
|
|||
.TH savetextmode 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
savetextmode, textmode \- save or restore the complete SVGA status for textmode.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.B savetextmode
|
||||
.br
|
||||
.B textmode
|
||||
|
||||
.SH DESCRIPTION
|
||||
These are simple scripts to save the SVGA register state when in textmode to the
|
||||
files
|
||||
.IR /tmp/fontdata " and " /tmp/textregs
|
||||
or to restore it from these files.
|
||||
|
||||
The actual utilities used are
|
||||
.BR restorefont (1),
|
||||
.BR restoretextmode "(1), and "
|
||||
.BR restorepalette (1).
|
||||
|
||||
The purpose of these scripts program is usually to recover from a crashed console due to an
|
||||
svgalib, Xfree or other program bug.
|
||||
|
||||
You do this by being a smart guy and running
|
||||
.B savetextmode
|
||||
right after booting of your machine,
|
||||
.B prior
|
||||
to any problems. Then, in case the SVGA state is hosed and you sit in front of a blank or
|
||||
useless console, change VC (maybe login) to get to a shell. Or exist the currently running
|
||||
program with
|
||||
.BR <Ctrl>-C ", "
|
||||
.BR <Ctrl>-<Alt>-<Backspace> ,
|
||||
or whatever applies. Once you got a shell, run
|
||||
.B textmode
|
||||
and it will hopefully render your console useable again.
|
||||
|
||||
To make it clear: You do all this while not seeing anything on your console screen, you
|
||||
enter this information blindly or after logging in from a network. Also, if the keyboard is
|
||||
left in raw mode, nothing can really help you as you cannot enter anything which a shell
|
||||
will understand.
|
||||
|
||||
.SH FILES
|
||||
.I /tmp/fontdata
|
||||
.br
|
||||
.I /tmp/textregs
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR dumpreg (1),
|
||||
.BR convfont (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR restorefont (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR restorepalette (1),
|
||||
.BR runx (1),
|
||||
.BR setmclk (1),
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
90
doc/man1/setmclk.1
Normal file
90
doc/man1/setmclk.1
Normal file
|
|
@ -0,0 +1,90 @@
|
|||
.TH setmclk 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
setmclk \- adjust the memory timing of certain Cirrus cards.
|
||||
.SH SYNOPSIS
|
||||
|
||||
.BI setmclk
|
||||
|
||||
.SH DESCRIPTION
|
||||
This program sets the
|
||||
.B memory clock
|
||||
of Cirrus 5424/26/28 cards.
|
||||
|
||||
The first three values could be set by utility programs that
|
||||
came with my card (AVGA3), but somewhat higher values seem to work (on my
|
||||
card at least). It may be that better and more recent Cirrus cards use a
|
||||
higher value as boot-up default. It should depend on DRAM speed, but it
|
||||
seems to be more dependant on the card logic.
|
||||
|
||||
I have the impression that many Cirrus 542x cards suffer from horrible
|
||||
BIOS version/DRAM timing misconfigurations. Perhaps even some versions of
|
||||
MS-Windows drivers change the MCLK register. In any case, the boot-up BIOS
|
||||
default (0x1c) may be inappropriately low for the type of DRAM timing most
|
||||
cards use.
|
||||
|
||||
Using a higher memory clock gives a very significant performance improvement;
|
||||
with high dot clock modes (like 640x480x16M or 1150x900x256) performance can
|
||||
be more than twice that of the standard 50 MHz clock. This goes for both
|
||||
(VLB) framebuffer access and accelerated features (bitblt). This also helps
|
||||
XFree86 server performance, but only if the XFree86 Cirrus driver doesn't
|
||||
set the memory clock register (it should work for XFree86 1.3 and 2.0).
|
||||
Use at your own risk!
|
||||
|
||||
Note that the
|
||||
.B dot clock
|
||||
is something entirely different. There does not
|
||||
seem to be much correlation between the two (i.e. if a high dot clock gives
|
||||
screen problems, using a high memory clock is not likely to fix it, other
|
||||
than improving speed).
|
||||
|
||||
The actual
|
||||
.B memory clock
|
||||
is hard compiled into the program. It defaults to 0x1c. You can change this value
|
||||
and some suggestiong come in th source of the utility.
|
||||
|
||||
This utility is part of svgalib and can be found in the
|
||||
.I utils/
|
||||
subdirectory of the original svgalib distribution. However, it is not installed
|
||||
by default, s.t. it is unclear where you can find it if your svgalib was install
|
||||
linux distribution.
|
||||
|
||||
In case of any such problem, simply get an svgalib distribution from the net. You
|
||||
don't need to install it. Just
|
||||
.B make
|
||||
in the
|
||||
.I utils/
|
||||
subdirecty. As of this writing,
|
||||
.I svgalib-1.2.12.tar.gz
|
||||
is the latest version and can be retrieved by ftp from
|
||||
.IR "sunsite.unc.edu" " at " "/pub/Linux/libs/graphics"
|
||||
and
|
||||
.IR "tsx-11.mit.edu" " at " "/pub/linux/sources/libs"
|
||||
which will most probably be mirrored by a site close to you.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.BR svgalib (7),
|
||||
.BR vgagl (7),
|
||||
.BR libvga.config (5),
|
||||
.BR convfont (1),
|
||||
.BR dumpreg (1),
|
||||
.BR restorefont (1),
|
||||
.BR restorepalette (1),
|
||||
.BR restoretextmode (1),
|
||||
.BR runx (1),
|
||||
.BR savetextmode (1),
|
||||
.BR fix132x43 (1),
|
||||
.BR textmode (1).
|
||||
|
||||
.SH AUTHOR
|
||||
|
||||
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||||
exact source of the referenced utility as well as of the original documentation is
|
||||
unknown.
|
||||
|
||||
It is very likely that both are at least to some extent are due to
|
||||
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||||
|
||||
Occasionally this might be wrong. I hereby
|
||||
asked to be excused by the original author and will happily accept any additions or corrections
|
||||
to this first version of the svgalib manual.
|
||||
41
doc/man1/svgakeymap.1
Normal file
41
doc/man1/svgakeymap.1
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
.TH svgakeymap 1 "3 July 1998" "Svgalib 1.3.0" "Svgalib User Manual"
|
||||
.SH NAME
|
||||
svgakeymap \- generates keymaps for svgalib
|
||||
|
||||
.SH SYNOPSIS
|
||||
.BI "svgakeymap [" "physical_table" " [" program_table "]] > " output.keymap
|
||||
|
||||
.SH DESCRIPTION
|
||||
Generates a keymap conversion file for
|
||||
.BR svgalib (7)
|
||||
from two keytable definitions. Keytables are searched for in
|
||||
.I /usr/lib/kbd/keytables
|
||||
and are automatically filtered through
|
||||
.BR gzip (1)
|
||||
if necessary.
|
||||
|
||||
If only one keytable is specified, a keymap is generated that performs no
|
||||
conversion but contains the proper key names for that layout. If no keytables
|
||||
are specified, the standard US QWERTY keyboard is used.
|
||||
|
||||
The generated keymap is sent to the standard output and may be redirected
|
||||
or piped in any creative manner you wish.
|
||||
|
||||
.SH FILES
|
||||
.I /usr/lib/kbd/keytables/*.map[.gz]
|
||||
.RS
|
||||
The system keytable files used by
|
||||
.BR loadkeys "(1)."
|
||||
.RE
|
||||
|
||||
.SH BUGS
|
||||
Can get confused if there is more than one key with a given name or if names
|
||||
do not match properly between keytables. Keymaps may require manual editing.
|
||||
|
||||
.SH AUTHOR
|
||||
Brion Vibber <brion@pobox.com>
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR libvga.config (5)
|
||||
|
||||
.IR README.keymap " from the svgalib distribution"
|
||||
1
doc/man1/textmode.1
Normal file
1
doc/man1/textmode.1
Normal file
|
|
@ -0,0 +1 @@
|
|||
.so man1/savetextmode.1
|
||||
Loading…
Add table
Add a link
Reference in a new issue