Provided by: libsvga1_1.4.3-27_i386 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>.