XF86_VGA16(1)                                       XF86_VGA16(1)



NAME

       XF86_VGA16  - 4 bit non-accelerated X Window System server
       for UNIX on x86 platforms


SYNOPSIS

       XF86_VGA16 [:displaynumber] [ option ] ...


DESCRIPTION

       XF86_VGA16 is a 4-bit color server  for  VGA  cards.   The
       default  root  visual  for this server is StaticColor.  It
       also includes support for  the  non-VGA  monochrome  cards
       described  in the XF86_Mono(1) manual page.  It may be run
       in a dual-headed configuration.



CONFIGURATIONS

       The XF86_VGA16 server supports the following popular  SVGA
       chipsets in 16-colour mode.

            ATI:
                18800,   18800-1,   28800-2,   28800-4,  28800-5,
                28800-6,  68800-3,  68800-6,  68800AX,   68800LX,
                88800GX-C,   88800GX-D,   88800GX-E,   88800GX-F,
                88800CX, 264CT, 264ET, 264VT,  264GT  (a.k.a.  3D
                Rage),  264VT-B,  264VT3, 264VT4, 264GT-B (a.k.a.
                3D Rage II), 264GT-IIc, 264GT3  (a.k.a.  3D  Rage
                Pro), 264LT, 264LT-Pro

            Tseng:
                ET4000

            Trident:
                TVGA8800CS,   TVGA8900B,  TVGA8900C,  TVGA8900CL,
                TVGA9000

            Cirrus:
                CL6410, CL6412, CL6420, CL6440

            Oak:
                OTI067, OTI077, OTI087

       Additionally it supports generic VGA cards.

       XF86_VGA16 does not support the accelerated  functions  of
       the supported chipsets.


OPTIONS

       In  addition to the normal server options described in the
       Xserver(1) manual page, XF86_VGA16 accepts some more  com­
       mand  line  switches,  as described in the XFree86(1) man­
       page.


SETUP

       XFree86 uses a configuration file  called  XF86Config  for



XFree86                   Version 3.3.5                         1





XF86_VGA16(1)                                       XF86_VGA16(1)


       its  initial  setup.   See the XF86Config(4/5) manpage for
       general details. Here only the XF86_VGA16  specific  parts
       are explained.

       The  Driver  entry in the Screen section of the XF86Config
       file should be set to vga16.  To run in  dual-headed  con­
       figuration, there should also be a Screen section with the
       Driver entry set to mono.

       Entries for the Device  section  in  the  XF86Config  file
       include:

       chipset "name"
               specifies  a  chipset so the correct driver can be
               used.  Possible chipsets are:


                      ATI:
                          ati  (see  README.ati  for   additional
                          recoginzed names)

                      Tseng:
                          et4000,      et4000w32,     et4000w32i,
                          et4000w32p

                      Trident:
                          tvga8800cs,    tvga8900b,    tvga8900c,
                          tvga8900cl, tvga9000

                      Cirrus:
                          cl6410, cl6412, cl6420, cl6440

                      Oak:
                          oti067, oti077, oti087

                      Generic VGA:
                          generic

       Option "optionstring"
               allows the user to select certain options provided
               by the drivers.  Currently the  following  strings
               are recognized:

               legend  -  for  Sigma  Legend ET4000-based boards.
               This  option  enables  a  special  clock-selection
               algorithm used on Legend boards, and MUST be spec­
               ified for these boards to function correctly.

               hibit_low, hibit_high - for Tseng ET4000 chipsets.
               With  some ET4000 cards, the server has difficulty
               getting the state of the high-order clocks  select
               bit right when started from a high-resolution text
               mode.  These options  allow  the  correct  initial
               state  of  that  bit to be specified.  To find out



XFree86                   Version 3.3.5                         2





XF86_VGA16(1)                                       XF86_VGA16(1)


               what the  correct  initial  state  is,  start  the
               server  from  an  80x25 text mode.  This option is
               only needed if the clocks reported by  the  server
               when started from a high-resolution text mode dif­
               fer from those reported when it is started from an
               80x25 text mode.

               clkdiv2 - for all chipsets using a set of discrete
               clocks (i.e. not using a programmable ClockChip or
               a  ClockProg).  With  this option enabled, the VGA
               driver can also use all the clocks  mentionned  in
               the  clocks  line  divided  by  2,  presenting the
               server with twice as many clocks to  choose  from,
               especially in the low- and mid-range. This is use­
               ful for creating very low  resolution  modes  like
               320x200,  because  the  lowest  available clock on
               many cards (25.175 MHz) is too high  to  create  a
               standard  320x200 mode. A few VGA chips don't sup­
               port this option, causing a distorted screen.

               power_saver - This option enables  the  server  to
               use the power saving features of VESA DPMS compat­
               ible monitors.  The suspend level is currently not
               supported.   Refer  to  the XF86Config(4/5) manual
               page for details of how to set  the  timeouts  for
               the different levels of operation.  This option is
               experimental.

       Note that XFree86 has some internal capabilities to deter­
       mine  what  hardware  it  is running on. Thus normally the
       keywords chipset, clocks, and videoram don't  have  to  be
       specified.   But  there may be occasions when this autode­
       tection mechanism fails, (for example, too high of load on
       the  machine  when  you start the server).  For cases like
       this, one should  first  run  XF86_VGA16  on  an  unloaded
       machine,  look  at  the results of the autodetection (that
       are printed out during server startup) and then explicitly
       specify these parameters in the configuration file.  It is
       recommended that all parameters, especially Clock  values,
       be specified in the XF86Config file.


FILES

       <XRoot>/bin/XF86_VGA16        The 16 colour X server

       /etc/XF86Config               Server configuration file

       <XRoot>/lib/X11/XF86Config    Server configuration file

       Note:  <XRoot> refers to the root of the X11 install tree.


SEE ALSO

       X(1),     Xserver(1),     XFree86(1),     XF86Config(4/5),
       XF86_Mono(1), xf86config(1), xvidtune(1), xdm(1), xinit(1)




XFree86                   Version 3.3.5                         3





XF86_VGA16(1)                                       XF86_VGA16(1)



CONTACT INFO

       XFree86  source  is  available   from   the   FTP   server
       ftp.XFree86.org.   Send  email  to XFree86@XFree86.org for
       details.


AUTHORS

       The primary developer of this server is

       Gertjan Akkerman,  akkerman@dutiba.twi.tudelft.nl

       See also the XFree86(1) manual page.














































XFree86                   Version 3.3.5                         4



Man(1) output converted with man2html