xorg-server-1.4/hw/xfree86/xorgconf.cpp

   1 XCOMM $XdotOrg$
   2 XCOMM
   3 XCOMM Copyright (c) 1994-1998 by The XFree86 Project, Inc.
   4 XCOMM
   5 XCOMM Permission is hereby granted, free of charge, to any person obtaining a
   6 XCOMM copy of this software and associated documentation files (the "Software"),
   7 XCOMM to deal in the Software without restriction, including without limitation
   8 XCOMM the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9 XCOMM and/or sell copies of the Software, and to permit persons to whom the
  10 XCOMM Software is furnished to do so, subject to the following conditions:
  11 XCOMM
  12 XCOMM The above copyright notice and this permission notice shall be included in
  13 XCOMM all copies or substantial portions of the Software.
  14 XCOMM
  15 XCOMM THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16 XCOMM IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17 XCOMM FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18 XCOMM THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  19 XCOMM WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
  20 XCOMM OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  21 XCOMM SOFTWARE.
  22 XCOMM
  23 XCOMM Except as contained in this notice, the name of the XFree86 Project shall
  24 XCOMM not be used in advertising or otherwise to promote the sale, use or other
  25 XCOMM dealings in this Software without prior written authorization from the
  26 XCOMM XFree86 Project.
  27 XCOMM
  28 XCOMM $XConsortium: XF86Conf.cpp /main/22 1996/10/23 11:43:51 kaleb $
  29
  30 XCOMM **********************************************************************
  31 XCOMM This is a sample configuration file only, intended to illustrate
  32 XCOMM what a config file might look like.  Refer to the XF86Config(4/5)
  33 XCOMM man page for details about the format of this file. This man page
  34 XCOMM is installed as MANPAGE
  35 XCOMM **********************************************************************
  36
  37 XCOMM The ordering of sections is not important in version 4.0 and later.
  38
  39 XCOMM **********************************************************************
  40 XCOMM Files section.  This allows default font and rgb paths to be set
  41 XCOMM **********************************************************************
  42
  43 Section "Files"
  44
  45 XCOMM The location of the RGB database.  Note, this is the name of the
  46 XCOMM file minus the extension (like ".txt" or ".db").  There is normally
  47 XCOMM no need to change the default.
  48
  49     RgbPath     RGBPATH
  50
  51 XCOMM Multiple FontPath entries are allowed (which are concatenated together),
  52 XCOMM as well as specifying multiple comma-separated entries in one FontPath
  53 XCOMM command (or a combination of both methods)
  54
  55     FontPath    LOCALFONTPATH
  56     FontPath    MISCFONTPATH
  57     FontPath    T1FONTPATH
  58     FontPath    TRUETYPEFONTPATH
  59     FontPath    DPI75FONTPATH
  60     FontPath    DPI100FONTPATH
  61
  62 XCOMM ModulePath can be used to set a search path for the X server modules.
  63 XCOMM The default path is shown here.
  64
  65 XCOMM    ModulePath     MODULEPATH
  66
  67 EndSection
  68
  69 XCOMM **********************************************************************
  70 XCOMM Module section -- this is an optional section which is used to specify
  71 XCOMM which run-time loadable modules to load when the X server starts up.
  72 XCOMM **********************************************************************
  73
  74 Section "Module"
  75
  76 XCOMM This loads the DBE extension module.
  77
  78     Load        "dbe"
  79
  80 XCOMM This loads the miscellaneous extensions module, and disables
  81 XCOMM initialisation of the XFree86-DGA extension within that module.
  82
  83     SubSection  "extmod"
  84         Option  "omit xfree86-dga"
  85     EndSubSection
  86
  87 XCOMM This loads the Type1 and FreeType font modules
  88
  89     Load        "type1"
  90     Load        "freetype"
  91
  92 EndSection
  93
  94
  95 XCOMM **********************************************************************
  96 XCOMM Server flags section.  This contains various server-wide Options.
  97 XCOMM **********************************************************************
  98
  99 Section "ServerFlags"
 100
 101 XCOMM Uncomment this to cause a core dump at the spot where a signal is
 102 XCOMM received.  This may leave the console in an unusable state, but may
 103 XCOMM provide a better stack trace in the core dump to aid in debugging
 104
 105 XCOMM    Option "NoTrapSignals"
 106
 107 XCOMM Uncomment this to disable the <Crtl><Alt><Fn> VT switch sequence
 108 XCOMM (where n is 1 through 12).  This allows clients to receive these key
 109 XCOMM events.
 110
 111 XCOMM    Option "DontVTSwitch"
 112
 113 XCOMM Uncomment this to disable the <Crtl><Alt><BS> server abort sequence
 114 XCOMM This allows clients to receive this key event.
 115
 116 XCOMM    Option "DontZap"
 117
 118 XCOMM Uncomment this to disable the <Crtl><Alt><KP_+>/<KP_-> mode switching
 119 XCOMM sequences.  This allows clients to receive these key events.
 120
 121 XCOMM    Option "DontZoom"
 122
 123 XCOMM Uncomment this to disable tuning with the xvidtune client. With
 124 XCOMM it the client can still run and fetch card and monitor attributes,
 125 XCOMM but it will not be allowed to change them. If it tries it will
 126 XCOMM receive a protocol error.
 127
 128 XCOMM    Option "DisableVidModeExtension"
 129
 130 XCOMM Uncomment this to enable the use of a non-local xvidtune client.
 131
 132 XCOMM    Option "AllowNonLocalXvidtune"
 133
 134 XCOMM Uncomment this to disable dynamically modifying the input device
 135 XCOMM (mouse and keyboard) settings.
 136
 137 XCOMM    Option "DisableModInDev"
 138
 139 XCOMM Uncomment this to enable the use of a non-local client to
 140 XCOMM change the keyboard or mouse settings (currently only xset).
 141
 142 XCOMM    Option "AllowNonLocalModInDev"
 143
 144 XCOMM Set the basic blanking screen saver timeout.
 145
 146     Option      "blank time"    "10"    # 10 minutes
 147
 148 XCOMM Set the DPMS timeouts.  These are set here because they are global
 149 XCOMM rather than screen-specific.  These settings alone don't enable DPMS.
 150 XCOMM It is enabled per-screen (or per-monitor), and even then only when
 151 XCOMM the driver supports it.
 152
 153     Option      "standby time"  "20"
 154     Option      "suspend time"  "30"
 155     Option      "off time"      "60"
 156
 157 XCOMM On some platform the server needs to estimate the sizes of PCI
 158 XCOMM memory and pio ranges. This is done by assuming that PCI ranges
 159 XCOMM don't overlap. Some broken BIOSes tend to set ranges of inactive
 160 XCOMM devices wrong. Here one can adjust how aggressive the assumptions
 161 XCOMM should be. Default is 0.
 162
 163 XCOMM Option   "EstimateSizesAggresively" "0"
 164
 165 EndSection
 166
 167 XCOMM **********************************************************************
 168 XCOMM Input devices
 169 XCOMM **********************************************************************
 170
 171 XCOMM **********************************************************************
 172 XCOMM Core keyboard's InputDevice section
 173 XCOMM **********************************************************************
 174
 175 Section "InputDevice"
 176
 177     Identifier  "Keyboard1"
 178     Driver      "kbd"
 179
 180 XCOMM Set the keyboard auto repeat parameters.  Not all platforms implement
 181 XCOMM this.
 182
 183     Option      "AutoRepeat"    "500 5"
 184
 185 XCOMM Specifiy which keyboard LEDs can be user-controlled (eg, with xset(1)).
 186
 187 XCOMM    Option "Xleds" "1 2 3"
 188
 189 XCOMM To disable the XKEYBOARD extension, uncomment XkbDisable.
 190
 191 XCOMM    Option "XkbDisable"
 192
 193 XCOMM To customise the XKB settings to suit your keyboard, modify the
 194 XCOMM lines below (which are the defaults).  For example, for a European
 195 XCOMM keyboard, you will probably want to use one of:
 196 XCOMM
 197 XCOMM    Option "XkbModel"      "pc102"
 198 XCOMM    Option "XkbModel"      "pc105"
 199 XCOMM
 200 XCOMM If you have a Microsoft Natural keyboard, you can use:
 201 XCOMM
 202 XCOMM    Option "XkbModel"      "microsoft"
 203 XCOMM
 204 XCOMM If you have a US "windows" keyboard you will want:
 205 XCOMM
 206 XCOMM    Option "XkbModel"      "pc104"
 207 XCOMM
 208 XCOMM Then to change the language, change the Layout setting.
 209 XCOMM For example, a german layout can be obtained with:
 210 XCOMM
 211 XCOMM    Option "XkbLayout"     "de"
 212 XCOMM
 213 XCOMM or:
 214 XCOMM
 215 XCOMM    Option "XkbLayout"     "de"
 216 XCOMM    Option "XkbVariant"    "nodeadkeys"
 217 XCOMM
 218 XCOMM If you'd like to switch the positions of your capslock and
 219 XCOMM control keys, use:
 220 XCOMM
 221 XCOMM    Option "XkbOptions"    "ctrl:swapcaps"
 222
 223
 224 XCOMM These are the default XKB settings for xorg
 225 XCOMM
 226 XCOMM    Option "XkbRules"      "xorg"
 227 XCOMM    Option "XkbModel"      "pc101"
 228 XCOMM    Option "XkbLayout"     "us"
 229 XCOMM    Option "XkbVariant"    ""
 230 XCOMM    Option "XkbOptions"    ""
 231
 232 EndSection
 233
 234
 235 XCOMM **********************************************************************
 236 XCOMM Core Pointer's InputDevice section
 237 XCOMM **********************************************************************
 238
 239 Section "InputDevice"
 240
 241 XCOMM Identifier and driver
 242
 243     Identifier  "Mouse1"
 244     Driver      "mouse"
 245
 246 XCOMM The mouse protocol and device.  The device is normally set to /dev/mouse,
 247 XCOMM which is usually a symbolic link to the real device.
 248
 249     Option      "Protocol"      "Microsoft"
 250     Option      "Device"        "/dev/mouse"
 251
 252 XCOMM On platforms where PnP mouse detection is supported the following
 253 XCOMM protocol setting can be used when using a newer PnP mouse:
 254
 255 XCOMM    Option "Protocol"      "Auto"
 256
 257 XCOMM When using mouse connected to a PS/2 port (aka "MousePort"), set the
 258 XCOMM the protocol as follows.  On some platforms some other settings may
 259 XCOMM be available.
 260
 261 XCOMM    Option "Protocol"      "PS/2"
 262
 263 XCOMM Baudrate and SampleRate are only for some older Logitech mice.  In
 264 XCOMM almost every case these lines should be omitted.
 265
 266 XCOMM    Option "BaudRate"      "9600"
 267 XCOMM    Option "SampleRate"    "150"
 268
 269 XCOMM Emulate3Buttons is an option for 2-button mice
 270 XCOMM Emulate3Timeout is the timeout in milliseconds (default is 50ms)
 271
 272 XCOMM    Option "Emulate3Buttons"
 273 XCOMM    Option "Emulate3Timeout"       "50"
 274
 275 XCOMM ChordMiddle is an option for some 3-button Logitech mice, or any
 276 XCOMM 3-button mouse where the middle button generates left+right button
 277 XCOMM events.
 278
 279 XCOMM    Option "ChordMiddle"
 280
 281 EndSection
 282
 283 Section "InputDevice"
 284     Identifier  "Mouse2"
 285     Driver      "mouse"
 286     Option      "Protocol"      "MouseMan"
 287     Option      "Device"        "/dev/mouse2"
 288 EndSection
 289
 290 XCOMM Some examples of extended input devices
 291
 292 XCOMM Section "InputDevice"
 293 XCOMM    Identifier     "spaceball"
 294 XCOMM    Driver "magellan"
 295 XCOMM    Option "Device"        "/dev/cua0"
 296 XCOMM EndSection
 297 XCOMM
 298 XCOMM Section "InputDevice"
 299 XCOMM    Identifier     "spaceball2"
 300 XCOMM    Driver "spaceorb"
 301 XCOMM    Option "Device"        "/dev/cua0"
 302 XCOMM EndSection
 303 XCOMM
 304 XCOMM Section "InputDevice"
 305 XCOMM    Identifier     "touchscreen0"
 306 XCOMM    Driver "microtouch"
 307 XCOMM    Option "Device"        "/dev/ttyS0"
 308 XCOMM    Option "MinX"          "1412"
 309 XCOMM    Option "MaxX"          "15184"
 310 XCOMM    Option "MinY"          "15372"
 311 XCOMM    Option "MaxY"          "1230"
 312 XCOMM    Option "ScreenNumber"  "0"
 313 XCOMM    Option "ReportingMode" "Scaled"
 314 XCOMM    Option "ButtonNumber"  "1"
 315 XCOMM    Option "SendCoreEvents"
 316 XCOMM EndSection
 317 XCOMM
 318 XCOMM Section "InputDevice"
 319 XCOMM    Identifier     "touchscreen1"
 320 XCOMM    Driver "elo2300"
 321 XCOMM    Option "Device"        "/dev/ttyS0"
 322 XCOMM    Option "MinX"          "231"
 323 XCOMM    Option "MaxX"          "3868"
 324 XCOMM    Option "MinY"          "3858"
 325 XCOMM    Option "MaxY"          "272"
 326 XCOMM    Option "ScreenNumber"  "0"
 327 XCOMM    Option "ReportingMode" "Scaled"
 328 XCOMM    Option "ButtonThreshold"       "17"
 329 XCOMM    Option "ButtonNumber"  "1"
 330 XCOMM    Option "SendCoreEvents"
 331 XCOMM EndSection
 332
 333 XCOMM **********************************************************************
 334 XCOMM Monitor section
 335 XCOMM **********************************************************************
 336
 337 XCOMM Any number of monitor sections may be present
 338
 339 Section "Monitor"
 340
 341 XCOMM The identifier line must be present.
 342
 343     Identifier  "Generic Monitor"
 344
 345 XCOMM HorizSync is in kHz unless units are specified.
 346 XCOMM HorizSync may be a comma separated list of discrete values, or a
 347 XCOMM comma separated list of ranges of values.
 348 XCOMM NOTE: THE VALUES HERE ARE EXAMPLES ONLY.  REFER TO YOUR MONITOR'S
 349 XCOMM USER MANUAL FOR THE CORRECT NUMBERS.
 350
 351 XCOMM    HorizSync      31.5  # typical for a single frequency fixed-sync monitor
 352 XCOMM    HorizSync      30-64         # multisync
 353 XCOMM    HorizSync      31.5, 35.2    # multiple fixed sync frequencies
 354 XCOMM    HorizSync      15-25, 30-50  # multiple ranges of sync frequencies
 355
 356 XCOMM VertRefresh is in Hz unless units are specified.
 357 XCOMM VertRefresh may be a comma separated list of discrete values, or a
 358 XCOMM comma separated list of ranges of values.
 359 XCOMM NOTE: THE VALUES HERE ARE EXAMPLES ONLY.  REFER TO YOUR MONITOR'S
 360 XCOMM USER MANUAL FOR THE CORRECT NUMBERS.
 361
 362 XCOMM    VertRefresh    60  # typical for a single frequency fixed-sync monitor
 363
 364 XCOMM    VertRefresh    50-100        # multisync
 365 XCOMM    VertRefresh    60, 65        # multiple fixed sync frequencies
 366 XCOMM    VertRefresh    40-50, 80-100 # multiple ranges of sync frequencies
 367
 368 XCOMM Modes can be specified in two formats.  A compact one-line format, or
 369 XCOMM a multi-line format.
 370
 371 XCOMM A generic VGA 640x480 mode (hsync = 31.5kHz, refresh = 60Hz)
 372 XCOMM These two are equivalent
 373
 374 XCOMM    ModeLine "640x480" 25.175 640 664 760 800 480 491 493 525
 375
 376     Mode "640x480"
 377         DotClock        25.175
 378         HTimings        640 664 760 800
 379         VTimings        480 491 493 525
 380     EndMode
 381
 382 XCOMM These two are equivalent
 383
 384 XCOMM    ModeLine "1024x768i" 45 1024 1048 1208 1264 768 776 784 817 Interlace
 385
 386 XCOMM    Mode "1024x768i"
 387 XCOMM        DotClock   45
 388 XCOMM        HTimings   1024 1048 1208 1264
 389 XCOMM        VTimings   768 776 784 817
 390 XCOMM        Flags              "Interlace"
 391 XCOMM    EndMode
 392
 393 XCOMM If a monitor has DPMS support, that can be indicated here.  This will
 394 XCOMM enable DPMS when the monitor is used with drivers that support it.
 395
 396 XCOMM    Option "dpms"
 397
 398 XCOMM If a monitor requires that the sync signals be superimposed on the
 399 XCOMM green signal, the following option will enable this when used with
 400 XCOMM drivers that support it.  Only a relatively small range of hardware
 401 XCOMM (and drivers) actually support this.
 402
 403 XCOMM    Option "sync on green"
 404
 405 EndSection
 406
 407 XCOMM **********************************************************************
 408 XCOMM Graphics device section
 409 XCOMM **********************************************************************
 410
 411 XCOMM Any number of graphics device sections may be present
 412
 413 Section "Device"
 414
 415 XCOMM The Identifier must be present.
 416
 417     Identifier  "Generic VGA"
 418
 419 XCOMM The Driver line must be present.  When using run-time loadable driver
 420 XCOMM modules, this line instructs the server to load the specified driver
 421 XCOMM module.  Even when not using loadable driver modules, this line
 422 XCOMM indicates which driver should interpret the information in this section.
 423
 424     Driver      "vga"
 425
 426 XCOMM The chipset line is optional in most cases.  It can be used to override
 427 XCOMM the driver's chipset detection, and should not normally be specified.
 428
 429 XCOMM    Chipset        "generic"
 430
 431 XCOMM Various other lines can be specified to override the driver's automatic
 432 XCOMM detection code.  In most cases they are not needed.
 433
 434 XCOMM    VideoRam       256
 435 XCOMM    Clocks 25.2 28.3
 436
 437 XCOMM The BusID line is used to specify which of possibly multiple devices
 438 XCOMM this section is intended for.  When this line isn't present, a device
 439 XCOMM section can only match up with the primary video device.  For PCI
 440 XCOMM devices a line like the following could be used.  This line should not
 441 XCOMM normally be included unless there is more than one video device
 442 XCOMM intalled.
 443
 444 XCOMM    BusID  "PCI:0:10:0"
 445
 446 XCOMM Various option lines can be added here as required.  Some options
 447 XCOMM are more appropriate in Screen sections, Display subsections or even
 448 XCOMM Monitor sections.
 449
 450 XCOMM    Option "hw cursor" "off"
 451
 452 EndSection
 453
 454 Section "Device"
 455     Identifier  "any supported Trident chip"
 456     Driver      "trident"
 457 EndSection
 458
 459 Section "Device"
 460     Identifier  "MGA Millennium I"
 461     Driver      "mga"
 462     Option      "hw cursor" "off"
 463     BusID       "PCI:0:10:0"
 464 EndSection
 465
 466 Section "Device"
 467     Identifier  "MGA G200 AGP"
 468     Driver      "mga"
 469     BusID       "PCI:1:0:0"
 470     Option      "pci retry"
 471 EndSection
 472
 473
 474 XCOMM **********************************************************************
 475 XCOMM Screen sections.
 476 XCOMM **********************************************************************
 477
 478 XCOMM Any number of screen sections may be present.  Each describes
 479 XCOMM the configuration of a single screen.  A single specific screen section
 480 XCOMM may be specified from the X server command line with the "-screen"
 481 XCOMM option.
 482
 483 Section "Screen"
 484
 485 XCOMM The Identifier, Device and Monitor lines must be present
 486
 487     Identifier  "Screen 1"
 488     Device      "Generic VGA"
 489     Monitor     "Generic Monitor"
 490
 491 XCOMM The favoured Depth and/or Bpp may be specified here
 492
 493     DefaultDepth 8
 494
 495     SubSection "Display"
 496         Depth           8
 497         Modes           "640x480"
 498         ViewPort        0 0
 499         Virtual         800 600
 500     EndSubsection
 501
 502     SubSection "Display"
 503         Depth           4
 504         Modes           "640x480"
 505     EndSubSection
 506
 507     SubSection "Display"
 508         Depth           1
 509         Modes           "640x480"
 510     EndSubSection
 511
 512 EndSection
 513
 514
 515 Section "Screen"
 516     Identifier          "Screen MGA1"
 517     Device              "MGA Millennium I"
 518     Monitor             "Generic Monitor"
 519     Option              "no accel"
 520     DefaultDepth        16
 521 XCOMM    DefaultDepth   24
 522
 523     SubSection "Display"
 524         Depth           8
 525         Modes           "1280x1024"
 526         Option          "rgb bits" "8"
 527         Visual          "StaticColor"
 528     EndSubSection
 529     SubSection "Display"
 530         Depth           16
 531         Modes           "1280x1024"
 532     EndSubSection
 533     SubSection "Display"
 534         Depth           24
 535         Modes           "1280x1024"
 536     EndSubSection
 537 EndSection
 538
 539
 540 Section "Screen"
 541     Identifier          "Screen MGA2"
 542     Device              "MGA G200 AGP"
 543     Monitor             "Generic Monitor"
 544     DefaultDepth        8
 545
 546     SubSection "Display"
 547         Depth           8
 548         Modes           "1280x1024"
 549         Option          "rgb bits" "8"
 550         Visual          "StaticColor"
 551     EndSubSection
 552 EndSection
 553
 554
 555 XCOMM **********************************************************************
 556 XCOMM ServerLayout sections.
 557 XCOMM **********************************************************************
 558
 559 XCOMM Any number of ServerLayout sections may be present.  Each describes
 560 XCOMM the way multiple screens are organised.  A specific ServerLayout
 561 XCOMM section may be specified from the X server command line with the
 562 XCOMM "-layout" option.  In the absence of this, the first section is used.
 563 XCOMM When now ServerLayout section is present, the first Screen section
 564 XCOMM is used alone.
 565
 566 Section "ServerLayout"
 567
 568 XCOMM The Identifier line must be present
 569
 570     Identifier  "Main Layout"
 571
 572 XCOMM Each Screen line specifies a Screen section name, and optionally
 573 XCOMM the relative position of other screens.  The four names after
 574 XCOMM primary screen name are the screens to the top, bottom, left and right
 575 XCOMM of the primary screen.  In this example, screen 2 is located to the
 576 XCOMM right of screen 1.
 577
 578     Screen      "Screen MGA 1"  ""      ""      ""      "Screen MGA 2"
 579     Screen      "Screen MGA 2"  ""      ""      "Screen MGA 1"  ""
 580
 581 XCOMM Each InputDevice line specifies an InputDevice section name and
 582 XCOMM optionally some options to specify the way the device is to be
 583 XCOMM used.  Those options include "CorePointer", "CoreKeyboard" and
 584 XCOMM "SendCoreEvents".  In this example, "Mouse1" is the core pointer,
 585 XCOMM and "Mouse2" is an extended input device that also generates core
 586 XCOMM pointer events (i.e., both mice will move the standard pointer).
 587
 588     InputDevice "Mouse1" "CorePointer"
 589     InputDevice "Mouse2" "SendCoreEvents"
 590     InputDevice "Keyboard1" "CoreKeyboard"
 591
 592 EndSection
 593
 594
 595 Section "ServerLayout"
 596     Identifier  "another layout"
 597     Screen      "Screen 1"
 598     Screen      "Screen MGA 1"
 599     InputDevice "Mouse1" "CorePointer"
 600     InputDevice "Keyboard1" "CoreKeyboard"
 601 EndSection
 602
 603
 604 Section "ServerLayout"
 605     Identifier  "simple layout"
 606     Screen      "Screen 1"
 607     InputDevice "Mouse1" "CorePointer"
 608     InputDevice "Keyboard1" "CoreKeyboard"
 609 EndSection
 610