2000-12-01 01:01:32 +01:00
|
|
|
.\" $XFree86: xc/programs/Xserver/hw/kdrive/vesa/Xvesa.man,v 1.3 2000/10/20 00:19:50 keithp Exp $
|
2000-08-28 17:29:19 +02:00
|
|
|
.TH Xvesa 1
|
|
|
|
.SH NAME
|
2000-12-01 01:01:32 +01:00
|
|
|
Xvesa \- VESA Bios Extensions tiny X server
|
2000-08-28 17:29:19 +02:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B Xvesa
|
|
|
|
.RI [ :display ]
|
|
|
|
.RI [ option ...]
|
|
|
|
.SH DESCRIPTION
|
2000-09-03 07:11:46 +02:00
|
|
|
.B Xvesa
|
|
|
|
is a generic X server for Linux on the x86 platform.
|
|
|
|
.B Xvesa
|
|
|
|
doesn't know about any particular hardware, and sets the video mode by
|
2000-10-20 02:19:51 +02:00
|
|
|
running the video BIOS in VM86 mode.
|
2000-09-03 07:11:46 +02:00
|
|
|
.B Xvesa
|
2000-12-01 01:01:32 +01:00
|
|
|
can use both standard VGA BIOS modes and any modes advertised by a
|
|
|
|
VESA BIOS if available.
|
2000-10-20 02:19:51 +02:00
|
|
|
.B Xvesa
|
2000-12-01 01:01:32 +01:00
|
|
|
runs untrusted code with full privileges, and is therefore a fairly
|
|
|
|
insecure X server.
|
2000-08-28 17:29:19 +02:00
|
|
|
.B Run at your own risk.
|
|
|
|
.SH OPTIONS
|
2000-12-01 01:01:32 +01:00
|
|
|
In addition to the normal KDrive server's options (see Xkdrive(1)),
|
2000-08-28 17:29:19 +02:00
|
|
|
.B Xvesa
|
|
|
|
accepts the following command line switches:
|
|
|
|
.TP 8
|
|
|
|
.B -mode \fIn\fB
|
|
|
|
specifies the VESA video mode to use. If mode
|
|
|
|
.I n
|
|
|
|
is not supported by your BIOS and hardware,
|
|
|
|
.B Xvesa
|
2000-12-01 01:01:32 +01:00
|
|
|
will fail, hang your system, or cause your monitor to explode; you are
|
|
|
|
on your own. This option overrides any
|
2000-09-03 07:11:46 +02:00
|
|
|
.B -screen
|
2000-10-20 02:19:51 +02:00
|
|
|
options.
|
2000-08-28 17:29:19 +02:00
|
|
|
.TP 8
|
|
|
|
.B -listmodes
|
2000-12-01 01:01:32 +01:00
|
|
|
list all supported video modes. If
|
2000-08-28 17:29:19 +02:00
|
|
|
.B -force
|
|
|
|
was specified before
|
|
|
|
.BR -listmodes ,
|
|
|
|
lists all the modes that your BIOS claims to support, even those that
|
|
|
|
the
|
|
|
|
.B Xvesa
|
|
|
|
server won't be able to use.
|
|
|
|
.TP 8
|
|
|
|
.B -force
|
2000-12-01 01:01:32 +01:00
|
|
|
disable some sanity checks and use the specified mode even if the
|
2000-09-03 07:11:46 +02:00
|
|
|
BIOS claims not to support it.
|
|
|
|
.TP 8
|
|
|
|
.B -shadow
|
|
|
|
use a shadow framebuffer even if it is not strictly necessary. This
|
2000-12-01 01:01:32 +01:00
|
|
|
may dramatically improve performance on some hardware.
|
2000-09-03 07:11:46 +02:00
|
|
|
.TP 8
|
|
|
|
.B -nolinear
|
|
|
|
don't use a linear framebuffer even if one is available. You don't
|
|
|
|
want to use this option.
|
|
|
|
.TP 8
|
|
|
|
.B -swaprgb
|
2000-10-20 02:19:51 +02:00
|
|
|
pass RGB values in the order that works on broken BIOSes. Use this if
|
2000-12-01 01:01:32 +01:00
|
|
|
the colours are wrong in PseudoColor and 16 colour modes.
|
2000-10-20 02:19:51 +02:00
|
|
|
.TP 8
|
|
|
|
.B -verbose
|
|
|
|
emit diagnostic messages during BIOS initialization and teardown.
|
2000-08-28 17:29:19 +02:00
|
|
|
.SH KEYBOARD
|
2000-12-01 01:01:32 +01:00
|
|
|
To be written.
|
2000-08-28 17:29:19 +02:00
|
|
|
.SH BUGS
|
|
|
|
.B Xvesa
|
2000-12-01 01:01:32 +01:00
|
|
|
opens all IO ports and runs your VESA BIOS, which may be assumed to be
|
|
|
|
buggy. Allowing your users to run
|
2000-08-28 17:29:19 +02:00
|
|
|
.B Xvesa
|
2000-12-01 01:01:32 +01:00
|
|
|
is probably a security hole.
|
|
|
|
|
2000-10-20 02:19:51 +02:00
|
|
|
.B Xvesa
|
|
|
|
records the current BIOS mode when it starts and restores that mode on
|
|
|
|
termination; if the video card has been reprogrammed by another application,
|
|
|
|
the display will almost certainly be trashed. The alternative of saving and
|
|
|
|
restoring the complete video card state has proven unreliable on most video
|
|
|
|
cards.
|
2000-08-28 17:29:19 +02:00
|
|
|
.SH SEE ALSO
|
2000-12-01 01:01:32 +01:00
|
|
|
X(1), Xserver(1), Xkdrive(1), xdm(1), xinit(1).
|
2000-08-28 17:29:19 +02:00
|
|
|
.SH AUTHORS
|
2000-12-01 01:01:32 +01:00
|
|
|
The VESA driver was written by Juliusz Chroboczek who didn't realise
|
|
|
|
what he was doing until it was too late. Keith Packard then added
|
|
|
|
support for standard VGA BIOS modes and is especially proud of 320x200
|
|
|
|
16 colour mode.
|