trusty (5) libvga.config.5.gz

Provided by: libsvga1_1.4.3-33_amd64 bug

NAME

       libvga.config, svgalibrc - the svgalib configuration file

DESCRIPTION

       The  svgalib  configuration  is  usually  located in /etc/vga/libvga.config though one can
       reconfigure this location when recompiling svgalib.

       In the configuration file, everything between a # and the end  of  the  line  is  ignored.
       Empty  lines  are  also  ignored.  Since  the  driver you will use may not know all config
       options here, unknown commands are silently ignored. Please think of that  when  something
       does  not  work  as  you expect. I know this is a nuisance because malformed configuration
       statements do not cause errors. Multiple commands are allowed in one  line,  and  commands
       can exceed lines.

       Actually,  svgalib  simply reads a list of whitespace separated tokens from the file until
       it finds one it knows and it then assumes the following tokens to  be  arguments  of  that
       command until one is encountered which may not be an argument.

       New  style  options are in general case insensitive whereas the old style options are case
       sensitive. The old style options are included to allow for old config  files  still  being
       used.  For  completeness  they are documented in the OBSOLETE COMMANDS section. You should
       not use them anymore.

       In addition,  svgalib(7)  parses  the  files  ~/.svgalibrc  and  the  file  given  in  the
       environment variable SVGALIB_CONFIG_FILE.

       Finally, the contents of the environment variable SVGALIB_CONFIG are parsed like the files
       before.

       Configuration commands which control hardware settings  that  might  cause  harm  to  your
       hardware  are  called  privileged.  By default the privileged commands can only be used in
       the main configuration file /etc/vga/libvga.config for safety (s.t. a non  root  user  can
       not cause any harm to your hardware by misconfiguring svgalib(7)).

       Enable  them  in  the  other locations as well with the command overrideenable in the main
       config file.  BEWARE!  This allows every user to change the monitor and clocks (and  other
       configs)  and  thus damaging the hardware. I strongly discourage the use of overrideenable
       except for debugging/testing purposes.

REQUIRED CONFIGURATION

       Please do not allow the vastness of options to confuse you. Generally  svgalib  uses  well
       chosen  defaults  and  is  able to autodetect everything. Thus generally you don't need to
       specify much. When installing svgalib it provides  a  sample  /etc/vga/libvga.config  file
       which contains most of the required configuration. Just edit it to your needs.

       Generally you only need to use:

       mouse  To specify if you use anything else then a Microsoft compatible mouse.

       mdev   If  the  mouse  device file is not /dev/input/mice which is the actual mouse device
              file. You will usually need to use this command if you want  to  use  the  SpaceTec
              Spaceball device (which is not your usual mouse).

       setRTS, clearRTS, leaveRTS, setDTR, clearDTR, and leaveDTR
              if your mouse needs it to enter your desired mouse protocol.

       monitor, or (better) HorizSync and VertRefresh
              to specify the capabilities of your monitor.

   If you use the EGA chipset driver
       monotext or colortext
              to specify if your EGA card is in monochrome or color configuration.

   If you use the Mach32 chipset driver
       You should consider reading svgalib.mach32(7).

       Clocks clock1 clock2 clock3 ...
              to  specify  the Mach32 clocks. This is mandatory. However, if you omit it. svgalib
              will autodetect clocks and modify your /etc/vga/libvga.config file and abort. After
              this, every svgalib application started will find the proper Clocks command.

       mach32eeprom /etc/vga/mach32.eeprom
              is  recommended  to  avoid slowish reads of the Mach32 EEPROM which will also cause
              annoying screen flickering.

   If you use the Mach64 chipset driver
       Chipset Mach64
              if you want to use the experimental pre-alpha driver

   If you use the S3 chipset driver
       I don't have much knowledge on the S3, but it seems to me that you need:

       Clocks clock1 clock2 ...
              to specify the clocks (take them from your Xfree86 configuration).

       or

       ClockChip icd2061a number
              if you have an Icd2061a clockchip.

       Ramdac chipname
              if your Ramdac is not detected properly.

       Dacspeed speed
              if the default chosen is not right (probably too restrictive).

       The remaining options are really only to be used in case  of  problems  which  you'll  not
       generally encounter.

   If you use the VESA chipset driver
       VesaText
              forces  the  driver  to  set 80x25 text mode, before any standard vga mode setting.
              Fixes text mode restoring with many cards, as well as standard VGA modes.

       VesaSave
              selects  the  bitmap  to  save  and  restore,  using  VESA  functions.   see   VESA
              documentation  for bits' meanings. The default is 1110 (=14) which is good for most
              cards, but some give better results with other numbers.

GENERAL OPTIONS (HANDLED BY THE MAIN MODULE)

   Mouse configuration
       mouse mousetype
              where mousetype is one of: Microsoft, MouseSystems, MMSeries,  Logitech,  Busmouse,
              PS2, MouseMan, gpm, Spaceball, none, IntelliMouse, or IMPS2.  mousetype can also be
              a number (0 - 9) for the keywords Microsoft - none.

              gpm allows for (hopefully) peaceful interaction with gpm, Spaceball enables support
              for  the  6-axes  Spacetec  Spaceball mouse (well, probably more like a trackball),
              IntelliMouse and IMPS2 refer to the Microsoft IntelliMouse or  Logitech  MouseMan+,
              where IntelliMouse is for serial port and IMPS2 for such a mouse on the PS/2 port.

              Note  that  it  is  not  possible to specify the Microsoft IntelliMouse or Logitech
              MouseMan+ by a number. This is due to historical and compatibility reasons.

       mouse_override
              This command is only available if ALLOW_MOUSE_OVERRIDE was set in Makefile.cfg when
              svgalib was compiled (which is the default).

              If  given,  svgalib  ignores any mouse type the program specifies but uses the type
              configured with the mouse command.

              For example, DOOM does not recognize MouseMan as a valid mouse  type  and  defaults
              the  mouse  type  to  MouseSystems.   This  command  allows  to make svgalib ignore
              whatever DOOM specifies and use MouseMan anyway.

       mdev mousedevice
              Usually /dev/input/mice (the default) will be the mouse device.  However, esp. with
              the Spacetec Spaceball you may want to specify a different device for svgalib(7) to
              use:

              mdev /dev/ttyS0 # mouse is at /dev/ttyS0

       Some multiprotocol mice use the state of RTS and DTR to find out which protocol to enable:

       setRTS set the RTS wire.

       clearRTS
              clear the RTS wire.

       leaveRTS
              leave the RTS wire alone (default) (Wire is usually set)

       setDTR set the DTR wire.

       clearDTR
              clear the DTR wire.

       leaveDTR
              leave the DTR wire alone (default) (Wire is usually set)

       For example my mouse can emulate Microsoft and MouseSystems.  It needs a  low  RTS  to  go
       into MouseSystems mode. Thus I use:

       mouse MouseSystems clearRTS

       Still  I  could  just  use mouse Microsoft and use the mouse with that protocol.. But then
       only 2 buttons instead of 3 are supported (not that I know many svgalib programs that uses
       more than 2 buttons.)

       Other mice might need clearDTR as well or one set and clear. Try yourself.

       Note: Having crtscts handshake enabled on the mouse tty may interfere with this option. Do
       not do that.

       Finally, a special goodie for wheel mice:

       mouse_fake_kbd_event upscancode downscancode
              sends a fake  keyboard  event  to  the  program  when  the  wheel  on  a  Microsoft
              IntelliMouse, Logitech MouseMan+, or similar wheel mouse is turned.

              The  up and down scancodes are the scancodes of the keys to simulate when the wheel
              is turned up and down, respectively.

              The following can be specified for the scancodes:  letters  (A-Z),  numbers  (0-9),
              function  keys (F1-F12), or any of the following - ESCAPE, MINUS, EQUAL, BACKSPACE,
              TAB, BRACKET_LEFT, BRACKET_RIGHT, ENTER, LEFTCONTROL, SEMICOLON, APOSTROPHE, GRAVE,
              LEFTSHIFT,  BACKSLASH,  COMMA,  PERIOD, SLASH, RIGHTSHIFT, KEYPADMULTIPLY, LEFTALT,
              SPACE, CAPSLOCK, NUMLOCK, SCROLLLOCK,  KEYPAD7,  CURSORUPLEFT,  KEYPAD8,  CURSORUP,
              KEYPAD9,   CURSORUPRIGHT,   KEYPADMINUS,  KEYPAD4,  CURSORLEFT,  KEYPAD5,  KEYPAD6,
              CURSORRIGHT, KEYPADPLUS, KEYPAD1,  CURSORDOWNLEFT,  KEYPAD2,  CURSORDOWN,  KEYPAD3,
              CURSORDOWNRIGHT,   KEYPAD0,   KEYPADPERIOD,  KEYPADCENTER,  RIGHTCONTROL,  CONTROL,
              KEYPADDIVIDE, PRINTSCREEN, RIGHTALT, BREAK, BREAK_ALTERNATIVE, HOME, CURSORBLOCKUP,
              PAGEUP, CURSORBLOCKLEFT, CURSORBLOCKRIGHT, END, CURSORBLOCKDOWN, PAGEDOWN, INSERT.

              Note  that this option has no effect unless the IntelliMouse or IMPS2 mouse type is
              used (see above). Also note that the simulated  keypresses  are  instantaneous,  so
              they  cannot be used for functions that require a key to be held down for a certain
              length of time.

              This example simulates a press of the left bracket ([) when the wheel is turned  up
              and  a  press  of  the  right  bracket  (]) when the wheel is turned down (good for
              selecting items in Quake II):

              mouse_fake_kbd_event BRACKET_LEFT BRACKET_RIGHT

   Mouse acceleration
       Svgalib versions 1.3.0 and later use the following commands  to  control  the  logarithmic
       mouse acceleration:

              mouse_force
                     If given, force use of input parameters even if they seem strange.

              mouse_maxdelta <integer>
                     Set max delta BEFORE acceleration.

              mouse_accel_maxdelta <integer>
                     Set max delta AFTER acceleration.

              mouse_accel_thresh <integer>
                     Set acceleration threshold.

              mouse_accel_power <float>
                     Set input variable for power mode.

              mouse_accel_mult <float>
                     Set acceleration factor.

              mouse_accel_type {0|off|normal|power|linear}
                     Set the type of acceleration. The following strings are valid values:

                     0 or off
                            No acceleration.

                     normal No  acceleration  while  delta  is  less  than mouse_accel_thresh but
                            multiplied by mouse_accel_mult if more.
                            Originally done by Mike Chapman <mike@paranoia.com>.

                     power  The acceleration factor is a power function of delta until it reaches
                            mouse_accel_mult  After  that it's a simple multiplication. Basically
                            it's like the normal mode but the acceleration factor  grows  as  you
                            move  your mouse faster and faster, not just turns in and out. If the
                            acceleration factor reaches mouse_accel_mult it turns  into  a  plain
                            multiplication.

                            Threshold  has the same meaning as in normal mode.  The one I use for
                            *uaking... :)

                            It is calculated like this:

                            if (abs(dx) > 1) /* to prevent losing resolution */
                              dx = (abs(dx) >=
                                     mouse_accel_thresh ) ?
                                   (float)dx *
                                    mouse_accel_mult :
                                   (float)dx *
                                    m_accel_powertable[abs(dx)];

                     linear The acceleration factor grows linear with the delta until it  reaches
                            mouse_accel_thresh.   After  that  it is a simple multiplication.  (I
                            know that it can be done with setting mouse_accel_power to 1, but  it
                            was one minute to implement... and uses no memory... and...)

                            It is calculated like this:

                            if (abs(dx) > 1)
                              dx = (abs(dx) >=
                                     mouse_accel_thresh ) ?
                                   (float)dx *
                                    mouse_accel_mult :
                                   (float)dx * abs(dx) *
                                    mouse_accel_mult /
                                    mouse_accel_thresh ;

              The     enhanced    acceleration    was    done    by    101    (Attila    Lendvai)
              <101@kempelen.inf.bme.hu>

   Joystick configuration
       As of now, svgalib supports up to four joystick devices. You must have joystick support in
       your kernel to support this.

       joystick0 device
              sets  the  device name to use for joystick 0. The commands joystick1, joystick2 and
              joystick3 configure the other joysticks. By default the names  /dev/js0,  /dev/js1,
              /dev/js2 and /dev/js3 are used.

   Keyboard configuration
       kbd_fake_mouse_event scancode [flag(s)] command [argument]
              ,  as it says, sends a fake mouse event to the program.  Scancode is a raw scancode
              as you can find them in <keyboard/vgakeyboard.h>.

              Supported flag(s) are:

              down   trigger event when the key is pressed (default).

              up     the opposite.

              both   trigger in both case, if pressed or released.

              repeat repeat events if the key is kept pressed (off by default).

              Supported commands are:

              delta[xyz]
                     send a fake delta event as if you have moved your mouse. If the parameter is
                     off  or  on  it  will  turn  off/on  the  respective  mouse axis (requires a
                     parameter, of course)

              button[123]
                     send a fake event that the mouse button is pressed or released as  given  by
                     the parameter (pressed or released)

              Here are some examples:

              This  is  one I use in *uake: it turns around, looks down a bit and when the key is
              released it does the opposite, so it gets back to the starting  state.   With  this
              one  and  the  help of a rocket you can fly though the whole map :) (Scancode 28 is
              <Enter>):

                  kbd_fake_mouse_event 28 both deltax 8182
                                          down deltay -1500
                                          up deltay 1500

              This one will switch off the y axis of the mouse while the key <Right Ctrl> is kept
              pressed.

                  kbd_fake_mouse_event 97 down deltay off
                                          up deltay on

              This  one  is  the  same as if you were pressing the left mouse button. (But if you
              move your mouse then the button state will reset even  if  you  keep  <Right  Ctrl>
              down...)

                  kbd_fake_mouse_event 97 down button1 pressed
                                          up button1 released

              NOTE: This does only work when the keyboard is in raw keyboard mode!

              Yet    another    feature    brought    to    you    by    101   (Attila   Lendvai)
              <101@kempelen.inf.bme.hu>

       nosigint
              This command disables generation of a SIGINT signal when <Ctrl-C> is pressed.

              This works regardless of ordinary or raw keyboard mode (albeit the hot key might be
              different from <Ctrl-C> in the first case).

              Note  that  this  is  a  very  dangerous  option. Disabling SIGINT will lock you in
              programs which can only by quit by <Ctrl-C>!  However, there were  request  for  it
              for Quake playing.

       sigint (default)
              Enables generation of SIGINT.

   Monitor configuration
       HorizSync min_kHz max_kHz
       VertRefresh min_Hz max_Hz
              specifies  the  range of frequencies acceptable to your monitor.  They obsolete the
              monitor settings below, and this shouldn't be used if HorizSync and VertRefresh are
              defined. Examples:

              HorizSync 31.5 35.5
              VertRefresh 50 70

       monitor monitor_class
              where  monitor_class  is  a digit 0 - 6 or the maximal horizontal frequency in kHz.
              Examples:

              monitor 0 # Max horizontal sync is 31.5 kHz
              monitor 1 # Max horizontal sync is 35.1 kHz
              monitor 2 # Max horizontal sync is 35.5 kHz
              monitor 3 # Max horizontal sync is 37.9 kHz
              monitor 4 # Max horizontal sync is 48.3 kHz
              monitor 5 # Max horizontal sync is 56.0 kHz
              monitor 6 # No restrictions.

              For your convenience you may  specify  the  max  horizontal  sync  explicitly.  The
              correct  class  will  the  be chosen. You may use floats consisting of digits and a
              decimal point for this too:

              monitor 40.0 # equivalent to monitor 3

              This command is privileged.

   Mode timings
       It is now possible to define modetimings for some cards (see the  info  on  your  card  in
       svgalib(7)).  The syntax is:

       modeline label pxcl HDsp HSS HSE HTot VDsp VSS VSE VTot flags

              label  string
                     (ignored  by  svgalib) mainly there to be compatible with XF86Config.  I use
                     the format "Width  x  Height  @  Vert.Refresh",  but  that's  just  personal
                     taste...

              pxcl   float
                     the pixel clock in MHz

              HDsp
              VDsp   integer
                     size of the visible area (horizontal/vertical)

              HSS
              VSS    integer
                     Sync start (horizontal/vertical)

              HSE
              VSE    integer
                     Sync end (horizontal/vertical)

              HTot
              VTot   integer
                     Total width/height (end of back porch)

              flags  +hsync -hsync +vsync -vsync interlace interlaced
                     doublescan Sync polarity, interlace mode

       Everything should be on one line.  The values for the horizontal timings must be multiples
       of eight.

       These are preferred over the default timings (if monitor and  chipset  can  handle  them).
       The  format  is identical to the one used by XFree86, but the label following the modeline
       keyword is ignored by vgalib.

       Here some examples:

       modeline 640x480@100 43 640 664 824 848 480 483 490 504
       modeline 800x600@73 50 800 856 976 1024 600 637 643 666
       modeline 1024x768@75 85 1024 1048 1376 1400 768 771 780 806

       IMPORTANT!  Not all drivers, that is SVGA  cards,  use  the  values.  Only  drivers  using
       timing.c.  As  of  this  writing,  drivers  using  this  feature are: Ark, Cirrus, Chips &
       Technologies, Et6000, S3.

       The Mach32 driver provides a similar feature  separately,  you  have  to  use  the  define
       command described below.

       ET4000  (and  to  some extent EGA) allow one to use a binary file created by some utility.
       All other chipset driver use predefined timings  that  are  hardcoded  in  register  dumps
       within the drivers. See svgalib.et4000(7) for more information.

   Chipset detection
       Usually  svgalib  does  a good job autodetecting your hardware. However, if auto detection
       fails (or you want to fall back to a simpler driver, say VGA, as a bug work  around),  you
       may force detection of your chipset with

       chipset type
              where  type is (currently) one of: VGA, ET4000, Cirrus, TVGA, Oak, EGA, S3, ET3000,
              Mach32, GVGA6400, ARK, ATI, ALI, Mach64, C&T, APM, NV3, ET6000, VESA, MX, PARADISE,
              and RAGE.

              You can also specify a number in range 1  -  22 to specify the type-th chipset type
              or 0 to enforce autodetection.

              Warning, incorrect settings may damage your hardware.  This command is privileged.

       chipset type param1 param2
              use this form if the size of  memory  or  an  additional  configuration  option  is
              misdetected. For example:

              chipset Mach32 0 2048

              Note  that  always  two  integers have to be specified. Usually (Mach32) the second
              parameter is the memory amount. Look at the *_init function of the specific  device
              driver sources or information on that type of cards in svgalib(7).

              Note  that  there  is  a more convenient command setuplinear for enforcing specific
              memory-aperture configurations for Mach32

              This command is privileged.

   Specific options required for the EGA-driver.
       monotext
              Card is in monochrome emulation mode

       colortext
              Card is in color emulation mode

              This command is privileged.

   RAMDAC configuration
       Some chipsets (e.g. S3 and ARK) allow specifying a RAMDAC type.  If  your  RAMDAC  is  not
       autodetected, you can try specifying it:

       Ramdac Sierra32K
       Ramdac SC15025
       Ramdac SDAC
              S3 SDAC
       Ramdac GenDAC
              S3 GenDAC
       Ramdac ATT20C490
              AT&T 20C490, 491, 492 (and compatibles)
       Ramdac ATT20C498
              AT&T 20C498
       Ramdac IBMRGB52x
              IBM RGB524, 526, 528 (and compatibles)

       BEWARE!  The Mach32 driver features an own ramdac command (which is usually not required).
       If you have a Mach32, see svgalib.mach32(7).

       Dacspeed speed
              speed is a floating point number in MHz  (like  in  Dacspeed40.0")  specifying  the
              maximal  allowable  pixel clock of the Ramdac in use. Currently this option is only
              supported by the S3 driver.  The  Mach32  driver  supports  maxclock8,  maxclock16,
              maxclock24,  and maxclock32 commands which have a similar effect. Nevertheless, the
              Mach32 has a very good idea on the capabilities of the Ramdac in use. The  settings
              are more intended to specify the VGA memory bandwidth.

   Pixel clocks
       Clocks list of clock values as floats or ints

              Some  chipsets  need  a list of dot clocks for optimum operation.  Some includes or
              supports a programmable clock chip.  You'll need to specify them here.

              Fixed clocks example: (The following is just an example, get the  values  for  your
              card from you X setup)

              Clocks 25.175 28.3 40 70 50 75 36 44.9 0 118 77 31.5 110 65 72 93.5

              BEWARE!   The  Clocks  command  for the Mach32 features only integer clocks. Please
              round your clocks to the next integer data. The Mach32 only uses  these  values  to
              check monitor requirements and to compare the quality of modes. The rounding errors
              are of no importance there as the difference in the resulting  monitor  timings  is
              barely measurable. See the Mach32 section below.

       Clockchip ICD2061A
              Configure  for  a programmable clockchip.  ICD2061A is the only one supported right
              now.

   Miscellaneous options
       security revoke-all-privs
              Make sure it is impossible to regain root  access  after  vga_init(3)  was  called.
              (default)

       security compat
              For compatibility to pre 1.2.11, do not close a security hole using saved uids.

       verbose
              Mach32: show messages while processing all info to build up a mode table.

       quiet  Turn verbose messages off (default).

       nolinear
              Inhibit use of a linear mmaped frame buffer.

       linear Allow (not enforce!) use of a linear mmaped frame buffer.

       overrideenable
              Allow privileged commands outside the main configuration file.

   Common options currently used by Mach32 only
       Options  that  may  be  useful for all drivers, but currently are only supported by Mach32
       (Please read svgalib.mach32(7) if you use one):

       maxclock16 maxclk
              The maximum pixel clock to use for 16bpp modes. This is used by Mach32 to find  out
              which  settings  may be used for 16bpp modes.  the Mach32 default for this is 2000,
              thus it is effectively switched off.  maxclk must be an integer.

       maxclock24 maxclk
              The maximum clock to use for 24bpp modes. (see above) Experience  showed  that  the
              Mach32 default 49 is good for my 2MB VRAM card.

       maxclock32 maxclk
              The  same  for  32bpp modes (24bpp with one fill byte for faster memory access (not
              fully implemented (esp. for Mach32) yet).  Mach32 default (good for my  VRAM  card)
              is 39.

       maxclock8 maxclk
              Just for completeness the same for 8bpp modes (I doubt anyone needs it), default is
              2000 to disable this feature.

       The maxclock commands are privileged.

       clocks list of clocks
              Sets the frequencies of the clocks the chips can generate. Exactly 16  values  have
              to be specified for mach32.  Use 0 to disable a specific clock.

              Note  that the mach32 can divide clocks by 2. Thus there are actually 32 clocks And
              you can also use the divided clocks in a define command.  On contrary to Xfree96 or
              the clocks command above only integers are allowed for Mach32. Simply round them to
              the nearest integer.

              This line is mandatory for Mach32. If it is not there it will be auto detected  and
              added  at the beginning of the config file. The program will then exit and when you
              start it next, everything should be ok.

              Common clock values for Mach32:

              Clock chip 18811-0:
                     clocks 43 49 92 36 50 56 0 45
                            30 32 110 80 40 45 75 65

              Clock chip 18811-1:
                     due to Xfree86 info valid for: Ultra pro ISA,  Ultra  pro  EISA,  Ultra  pro
                     VLB(68800-3)

                     clocks 100 126 92 36 50 56 0 45
                            135 32 110 80 40 45 75 65

              Clock chip 1881 (ICS2494):
                     due to Xfree86 info valid for: Ultra pro VLB (6880006)

                     clocks 18 22 25 28 36 44 50 56
                            30 32 37 39 40 0 75 65

              In my own correspondence with ATI they say every Mach32 would have a 18811-1, so it
              should be possible just to take the 18811-1 line.  However I have  now  reports  of
              third party cards and motherboards with on board Mach32 chips, so be careful.

              Please read svgalib.mach32(7) for additional info on clocks.

              The clocks command is privileged.

       variablelinelength
              Sometimes a mode cannot be realized with the logical linelength = pixels in a row *
              bytes per pixel. (definitely true for Mach32  800x600).  The  default  behavior  of
              Mach32   is   to   adjust   xbytes  (see  vga_getmodeinfo(3))  in  the  info  table
              appropriately.

              This command enforces this default operation and adjusts xbytes appropriately, thus
              overriding  the  standard svgalib mode. This may yield to problems with ..umm.. not
              well designed applications.

       duplicatelinelength
              Don't touch the standard mode but create an exact copy, a dynamic  mode,  with  the
              adjusted  xbytes  value.   Expect noise at some pixels in 800x600 for more than 256
              colors on Mach32 when not using the dynamic mode.

       strictlinelength
              Same as above but delete the standard mode thus creating the non conforming  xbytes
              modes only as dynamic modes.

       To enforce the standard linelength for non-conforming modes use setlinelength below.

       The linelength commands are not privileged.

       In  the  following commands a mode is specified with horzXvertXcolors.  Valid settings for
       colors in the mach32 driver are: 256, 32K, 64K, 16M, 16M4.  16M4 is  for  the  16M  colors
       with 32bpp modes. These are expected to support slightly faster drawing.

       Examples: 640x480x256, 1024x768x64K, etc...

       inhibit mode1 [mode2 mode3...]
              Switch the specified SVGA-Modes off. For example:

              inhibit 800x600x32K 800x600x64K 800x600x16M

              disallows the maybe toasted mach32 800x600 modes.

              The inhibit command is not privileged.

       setlinelength length mode1 [mode2 mode3...]
              Force  the  logical  line  length (xbytes) in the given modes to length pixels (not
              bytes!). See also  variablelinelength,  strictlinelength,  and  duplicatelinelength
              above. For example:

              setlinelength 800 800x600x32K 800x600x64K 800x600x16M

              sets  the  linelength,  and thus xbytes, for the 800x600 modes to the equivalent of
              800 pixels. For Mach32 this will give badly designed applications an  800x600  with
              which they can cope. However, the Mach32 will generate a noisy video signal in some
              configurations.

              The setlinelength command is not privileged.

       define mode1 [mode2 mode3...] clock horz_timing vert_timing flags
              where clock is a clock in MHz (as an integer! Has to be known by the driver.   (one
              of  the  set  clocks,  or  the exact half of one)). Only clocks in a clocks command
              issued before the define can be used.

              You may use :n to specify the n-thclock (n = 0 .. 31 for mach32).

              horz_timing is four integers: hdisp h_sync_strt h_sync_wid h_total.

              vert_timing has the same format but for vertical.

              You may specify one or more flags out of: Interlace,  +vsync,  -vsync,  +hsync,  or
              -hsync to select interlace mode and polarity of sync signals. This format is almost
              the same Xfree uses, s.t. you may use their mode table and the modegen  spreadsheet
              package  for mode creation. You simple need to round the clock to the next integer,
              add the resolution instead of the timing name for Xfree and  replace  the  modeline
              keyword with define.  Here is a 1024x768x256 mode as example:

              define 1024x768x256 80 1024 1024 1184 1312
                     768 768 772 791 +vsync -hsync

              or

              define 1024x768x256 1024x768x32K 1024x768x64K
                     :11 1024 1024 1184 1312 768 768 772 791

              (yes any whitespace in a command is allowed, even a newline !)

              Both  commands  define  the  same  timings (if the 11-th clock is 80) but the first
              explicitly specifies the polarity of sync signals whereas the second declares  that
              these timings are also to be used for a 32K and 64K mode.

              The define command is privileged.

       There is one really dangerous option (except faking clocks). Please use it only if you are
       sure what you are doing. Wrong setup will lead to multiple components accessing  your  bus
       at once and thus to probable hardware damage:

       setuplinear address size
              Sets  up  a  linear frame buffer at address of size size (both are given in MB). If
              the values make sense (for example address <16MB for ISA cards) the linear aperture
              is  setup.  Since  the  Mach32-driver  auto  detects  configured  address itself, I
              strongly discourage use of this command. However I was asked for  it  as  some  PCI
              mach32-cards didn't setup the linear aperture correctly.

              Please  ensure  that the address range from address to address + size (exclusively)
              is not used in your system. Obey that due to memory remapping for example 16MB  Ram
              may exceed the 16MB address limit.

              Valid  Mach32 values for size are 1 and 4 (only 4 in PCI configurations), address +
              size have to be below 16MB for ISA,  4GB  for  multiplexed  PCI,  and  128MB  else.
              Example: (my setup)

              setuplinear 64 4

              for a 4MB linear frame buffer at address 0x4000000.

              It  is  also  valid  to  specify  setuplinear  0 0.  This will actually disable/de-
              configure any linear frame buffer. Useful to disable mach32 aperture even if it  is
              enabled in the EEPROM.

              The setuplinear command is privileged.

       blit subcommand1 subcommand2 ...
              This is a command to control the Mach32 support for oldstyle accelerator functions.

              Valid subcommands are bit, fill, image, and hlinelist.  They enable support for the
              corresponding blit functions. Precede them with no to turn them off (no space after
              no  allowed).  Use  memimage  to  emulate the image blit using a linearframebuffer,
              which is usually much  faster  for  Mach32.   Use  nomemimage  to  never  use  this
              emulation.  On  the  Mach32 this emulation can be used in more resolutions than the
              actual imageblit accelerator function.  Again order is vital! (esp. for the  *image
              commands).

              As  the  Mach32  now has also new style vga_accel(3) support there are now also the
              subcommands:   settrans,   setrop,   fillbox,   screencopy,   drawline,   putimage,
              drawhlinelist,   putbitmap,   screencopymono,  setmode,  polyline,  polyhline,  and
              polyfillmode.  Which are also supported with a leading no.  They allow  to  control
              support  for  the  subfunctions  of  vga_accel(3).  In addition, memimage emulation
              applies to putimage as well.

              Some examples:

              blit image nomemimage
                     Use IO-style imageblt where possible. Don't emulate it in any resolution.

              blit image memimage
                     Use emulated imageblt where possible.

              blit memimage image
                     Use IO-style imageblt where possible, and the emulation  where  possible  in
                     the remaining modes.

              blit noimage
                     Disable support for imageblt.

              Mach32 default is:

              blit bit fill image hlinelist settrans setrop
                   fillbox screencopy drawline putimage
                   drawhlinelist putbitmap screencopymono
                   setmode polyline polyhline polyfillmode
                   memimage

              The blit command is not privileged.

       The  Mach32  has  also a few intermediate debug options for low level timing adjust.  They
       are:

       vfifo8 number
       vfifo16 number
       vfifo24 number
       vfifo32 number
       blank number
       latch number

       There also options which are useful to support broken Mach32 cards or third party hardware
       based on Mach32 which does not follow the ATI specifications completely. For example:

       vendor ati
       misc_ctl keep-off
       svgaclocks 9
       ramdac auto

       For details about these options see svgalib.mach32(7).  All of them are privileged.

OBSOLETE COMMANDS

       Very  old  svgalib  versions used a different style configuration file. For compatibility,
       svgalib can still parse these old options. Generally the options consist of one  character
       (case  sensitive) followed by a number. Whitespace characters (space, tab, newline) can be
       used after the characters m and M and the number.

       The old svgalib versions actually allowed a  new  option  character  to  follow  a  number
       immediately.  The current parser requires white space after the numbers.

       Of course, you should not use these cryptic forms anymore. The obsolete commands are:

       mnumber
              Specify the mouse type like mouse number does.

       Mclass Specify the monitor class like monitor class does.

       Cnumber
              Force  usage  of  the  number-th  chipset driver from the list of supported drivers
              VGA(1), ET4000(2), Cirrus(3), TVGA(4), Oak(5), EGA(6), S3(7), ET3000(8), Mach32(9),
              GVGA6400(10),  ARK(11),  ATI(12),  ALI(13),  Mach64(14), C&T(15), APM(16), NV3(17),
              ET6000(18), VESA(19), MX(20), PARADISE(21), and RAGE(22).

              C0 reenables auto detection of the chipset (default).

       cflag  When using the EGA chipset driver, the card is in  monochrome  emulation  mode  for
              flag = 0 and in color emulation mode for flag = 1.

FILES

       /etc/vga/libvga.config
       /etc/vga/libvga.et4000

SEE ALSO

       svgalib(7), svgalib.et4000(7), svgalib.chips(7), svgalib.mach32(7),

AUTHOR

       The  newstyle  configuration  file  was first implemented and documented by Michael Weller
       <eowmob@exp-math.uni-essen.de>. However, other people added new features.

       Finally this page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>.