XCOMM $XdotOrg$ XCOMM XCOMM Copyright (c) 1994-1998 by The XFree86 Project, Inc. XCOMM XCOMM Permission is hereby granted, free of charge, to any person obtaining a XCOMM copy of this software and associated documentation files (the "Software"), XCOMM to deal in the Software without restriction, including without limitation XCOMM the rights to use, copy, modify, merge, publish, distribute, sublicense, XCOMM and/or sell copies of the Software, and to permit persons to whom the XCOMM Software is furnished to do so, subject to the following conditions: XCOMM XCOMM The above copyright notice and this permission notice shall be included in XCOMM all copies or substantial portions of the Software. XCOMM XCOMM THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR XCOMM IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, XCOMM FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XCOMM THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, XCOMM WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF XCOMM OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE XCOMM SOFTWARE. XCOMM XCOMM Except as contained in this notice, the name of the XFree86 Project shall XCOMM not be used in advertising or otherwise to promote the sale, use or other XCOMM dealings in this Software without prior written authorization from the XCOMM XFree86 Project. XCOMM XCOMM $XConsortium: XF86Conf.cpp /main/22 1996/10/23 11:43:51 kaleb $ XCOMM ********************************************************************** XCOMM This is a sample configuration file only, intended to illustrate XCOMM what a config file might look like. Refer to the XF86Config(4/5) XCOMM man page for details about the format of this file. This man page XCOMM is installed as MANPAGE XCOMM ********************************************************************** XCOMM The ordering of sections is not important in version 4.0 and later. XCOMM ********************************************************************** XCOMM Files section. This allows default font and rgb paths to be set XCOMM ********************************************************************** Section "Files" XCOMM Multiple FontPath entries are allowed (which are concatenated together), XCOMM as well as specifying multiple comma-separated entries in one FontPath XCOMM command (or a combination of both methods) FontPath LOCALFONTPATH FontPath MISCFONTPATH FontPath T1FONTPATH FontPath TRUETYPEFONTPATH FontPath DPI75FONTPATH FontPath DPI100FONTPATH XCOMM ModulePath can be used to set a search path for the X server modules. XCOMM The default path is shown here. XCOMM ModulePath MODULEPATH EndSection XCOMM ********************************************************************** XCOMM Module section -- this is an optional section which is used to specify XCOMM which run-time loadable modules to load when the X server starts up. XCOMM ********************************************************************** Section "Module" XCOMM This loads the DBE extension module. Load "dbe" XCOMM This loads the miscellaneous extensions module, and disables XCOMM initialisation of the XFree86-DGA extension within that module. SubSection "extmod" Option "omit xfree86-dga" EndSubSection XCOMM This loads the Type1 and FreeType font modules Load "type1" Load "freetype" EndSection XCOMM ********************************************************************** XCOMM Server flags section. This contains various server-wide Options. XCOMM ********************************************************************** Section "ServerFlags" XCOMM Uncomment this to cause a core dump at the spot where a signal is XCOMM received. This may leave the console in an unusable state, but may XCOMM provide a better stack trace in the core dump to aid in debugging XCOMM Option "NoTrapSignals" XCOMM Uncomment this to disable the VT switch sequence XCOMM (where n is 1 through 12). This allows clients to receive these key XCOMM events. XCOMM Option "DontVTSwitch" XCOMM Uncomment this to disable the server abort sequence XCOMM This allows clients to receive this key event. XCOMM Option "DontZap" XCOMM Uncomment this to disable the / mode switching XCOMM sequences. This allows clients to receive these key events. XCOMM Option "DontZoom" XCOMM Uncomment this to disable tuning with the xvidtune client. With XCOMM it the client can still run and fetch card and monitor attributes, XCOMM but it will not be allowed to change them. If it tries it will XCOMM receive a protocol error. XCOMM Option "DisableVidModeExtension" XCOMM Uncomment this to enable the use of a non-local xvidtune client. XCOMM Option "AllowNonLocalXvidtune" XCOMM Uncomment this to disable dynamically modifying the input device XCOMM (mouse and keyboard) settings. XCOMM Option "DisableModInDev" XCOMM Uncomment this to enable the use of a non-local client to XCOMM change the keyboard or mouse settings (currently only xset). XCOMM Option "AllowNonLocalModInDev" XCOMM Set the basic blanking screen saver timeout. Option "blank time" "10" # 10 minutes XCOMM Set the DPMS timeouts. These are set here because they are global XCOMM rather than screen-specific. These settings alone don't enable DPMS. XCOMM It is enabled per-screen (or per-monitor), and even then only when XCOMM the driver supports it. Option "standby time" "20" Option "suspend time" "30" Option "off time" "60" XCOMM On some platform the server needs to estimate the sizes of PCI XCOMM memory and pio ranges. This is done by assuming that PCI ranges XCOMM don't overlap. Some broken BIOSes tend to set ranges of inactive XCOMM devices wrong. Here one can adjust how aggressive the assumptions XCOMM should be. Default is 0. XCOMM Option "EstimateSizesAggresively" "0" EndSection XCOMM ********************************************************************** XCOMM Input devices XCOMM ********************************************************************** XCOMM ********************************************************************** XCOMM Core keyboard's InputDevice section XCOMM ********************************************************************** Section "InputDevice" Identifier "Keyboard1" Driver "kbd" XCOMM Set the keyboard auto repeat parameters. Not all platforms implement XCOMM this. Option "AutoRepeat" "500 5" XCOMM Specifiy which keyboard LEDs can be user-controlled (eg, with xset(1)). XCOMM Option "Xleds" "1 2 3" XCOMM To disable the XKEYBOARD extension, uncomment XkbDisable. XCOMM Option "XkbDisable" XCOMM To customise the XKB settings to suit your keyboard, modify the XCOMM lines below (which are the defaults). For example, for a European XCOMM keyboard, you will probably want to use one of: XCOMM XCOMM Option "XkbModel" "pc102" XCOMM Option "XkbModel" "pc105" XCOMM XCOMM If you have a Microsoft Natural keyboard, you can use: XCOMM XCOMM Option "XkbModel" "microsoft" XCOMM XCOMM If you have a US "windows" keyboard you will want: XCOMM XCOMM Option "XkbModel" "pc104" XCOMM XCOMM Then to change the language, change the Layout setting. XCOMM For example, a german layout can be obtained with: XCOMM XCOMM Option "XkbLayout" "de" XCOMM XCOMM or: XCOMM XCOMM Option "XkbLayout" "de" XCOMM Option "XkbVariant" "nodeadkeys" XCOMM XCOMM If you'd like to switch the positions of your capslock and XCOMM control keys, use: XCOMM XCOMM Option "XkbOptions" "ctrl:swapcaps" XCOMM These are the default XKB settings for xorg XCOMM XCOMM Option "XkbRules" "xorg" XCOMM Option "XkbModel" "pc101" XCOMM Option "XkbLayout" "us" XCOMM Option "XkbVariant" "" XCOMM Option "XkbOptions" "" EndSection XCOMM ********************************************************************** XCOMM Core Pointer's InputDevice section XCOMM ********************************************************************** Section "InputDevice" XCOMM Identifier and driver Identifier "Mouse1" Driver "mouse" XCOMM The mouse protocol and device. The device is normally set to /dev/mouse, XCOMM which is usually a symbolic link to the real device. Option "Protocol" "Microsoft" Option "Device" "/dev/mouse" XCOMM On platforms where PnP mouse detection is supported the following XCOMM protocol setting can be used when using a newer PnP mouse: XCOMM Option "Protocol" "Auto" XCOMM When using mouse connected to a PS/2 port (aka "MousePort"), set the XCOMM the protocol as follows. On some platforms some other settings may XCOMM be available. XCOMM Option "Protocol" "PS/2" XCOMM Baudrate and SampleRate are only for some older Logitech mice. In XCOMM almost every case these lines should be omitted. XCOMM Option "BaudRate" "9600" XCOMM Option "SampleRate" "150" XCOMM Emulate3Buttons is an option for 2-button mice XCOMM Emulate3Timeout is the timeout in milliseconds (default is 50ms) XCOMM Option "Emulate3Buttons" XCOMM Option "Emulate3Timeout" "50" XCOMM ChordMiddle is an option for some 3-button Logitech mice, or any XCOMM 3-button mouse where the middle button generates left+right button XCOMM events. XCOMM Option "ChordMiddle" EndSection Section "InputDevice" Identifier "Mouse2" Driver "mouse" Option "Protocol" "MouseMan" Option "Device" "/dev/mouse2" EndSection XCOMM Some examples of extended input devices XCOMM Section "InputDevice" XCOMM Identifier "spaceball" XCOMM Driver "magellan" XCOMM Option "Device" "/dev/cua0" XCOMM EndSection XCOMM XCOMM Section "InputDevice" XCOMM Identifier "spaceball2" XCOMM Driver "spaceorb" XCOMM Option "Device" "/dev/cua0" XCOMM EndSection XCOMM XCOMM Section "InputDevice" XCOMM Identifier "touchscreen0" XCOMM Driver "microtouch" XCOMM Option "Device" "/dev/ttyS0" XCOMM Option "MinX" "1412" XCOMM Option "MaxX" "15184" XCOMM Option "MinY" "15372" XCOMM Option "MaxY" "1230" XCOMM Option "ScreenNumber" "0" XCOMM Option "ReportingMode" "Scaled" XCOMM Option "ButtonNumber" "1" XCOMM Option "SendCoreEvents" XCOMM EndSection XCOMM XCOMM Section "InputDevice" XCOMM Identifier "touchscreen1" XCOMM Driver "elo2300" XCOMM Option "Device" "/dev/ttyS0" XCOMM Option "MinX" "231" XCOMM Option "MaxX" "3868" XCOMM Option "MinY" "3858" XCOMM Option "MaxY" "272" XCOMM Option "ScreenNumber" "0" XCOMM Option "ReportingMode" "Scaled" XCOMM Option "ButtonThreshold" "17" XCOMM Option "ButtonNumber" "1" XCOMM Option "SendCoreEvents" XCOMM EndSection XCOMM ********************************************************************** XCOMM Monitor section XCOMM ********************************************************************** XCOMM Any number of monitor sections may be present Section "Monitor" XCOMM The identifier line must be present. Identifier "Generic Monitor" XCOMM HorizSync is in kHz unless units are specified. XCOMM HorizSync may be a comma separated list of discrete values, or a XCOMM comma separated list of ranges of values. XCOMM NOTE: THE VALUES HERE ARE EXAMPLES ONLY. REFER TO YOUR MONITOR'S XCOMM USER MANUAL FOR THE CORRECT NUMBERS. XCOMM HorizSync 31.5 # typical for a single frequency fixed-sync monitor XCOMM HorizSync 30-64 # multisync XCOMM HorizSync 31.5, 35.2 # multiple fixed sync frequencies XCOMM HorizSync 15-25, 30-50 # multiple ranges of sync frequencies XCOMM VertRefresh is in Hz unless units are specified. XCOMM VertRefresh may be a comma separated list of discrete values, or a XCOMM comma separated list of ranges of values. XCOMM NOTE: THE VALUES HERE ARE EXAMPLES ONLY. REFER TO YOUR MONITOR'S XCOMM USER MANUAL FOR THE CORRECT NUMBERS. XCOMM VertRefresh 60 # typical for a single frequency fixed-sync monitor XCOMM VertRefresh 50-100 # multisync XCOMM VertRefresh 60, 65 # multiple fixed sync frequencies XCOMM VertRefresh 40-50, 80-100 # multiple ranges of sync frequencies XCOMM Modes can be specified in two formats. A compact one-line format, or XCOMM a multi-line format. XCOMM A generic VGA 640x480 mode (hsync = 31.5kHz, refresh = 60Hz) XCOMM These two are equivalent XCOMM ModeLine "640x480" 25.175 640 664 760 800 480 491 493 525 Mode "640x480" DotClock 25.175 HTimings 640 664 760 800 VTimings 480 491 493 525 EndMode XCOMM These two are equivalent XCOMM ModeLine "1024x768i" 45 1024 1048 1208 1264 768 776 784 817 Interlace XCOMM Mode "1024x768i" XCOMM DotClock 45 XCOMM HTimings 1024 1048 1208 1264 XCOMM VTimings 768 776 784 817 XCOMM Flags "Interlace" XCOMM EndMode XCOMM If a monitor has DPMS support, that can be indicated here. This will XCOMM enable DPMS when the monitor is used with drivers that support it. XCOMM Option "dpms" XCOMM If a monitor requires that the sync signals be superimposed on the XCOMM green signal, the following option will enable this when used with XCOMM drivers that support it. Only a relatively small range of hardware XCOMM (and drivers) actually support this. XCOMM Option "sync on green" EndSection XCOMM ********************************************************************** XCOMM Graphics device section XCOMM ********************************************************************** XCOMM Any number of graphics device sections may be present Section "Device" XCOMM The Identifier must be present. Identifier "Generic VGA" XCOMM The Driver line must be present. When using run-time loadable driver XCOMM modules, this line instructs the server to load the specified driver XCOMM module. Even when not using loadable driver modules, this line XCOMM indicates which driver should interpret the information in this section. Driver "vga" XCOMM The chipset line is optional in most cases. It can be used to override XCOMM the driver's chipset detection, and should not normally be specified. XCOMM Chipset "generic" XCOMM Various other lines can be specified to override the driver's automatic XCOMM detection code. In most cases they are not needed. XCOMM VideoRam 256 XCOMM Clocks 25.2 28.3 XCOMM The BusID line is used to specify which of possibly multiple devices XCOMM this section is intended for. When this line isn't present, a device XCOMM section can only match up with the primary video device. For PCI XCOMM devices a line like the following could be used. This line should not XCOMM normally be included unless there is more than one video device XCOMM intalled. XCOMM BusID "PCI:0:10:0" XCOMM Various option lines can be added here as required. Some options XCOMM are more appropriate in Screen sections, Display subsections or even XCOMM Monitor sections. XCOMM Option "hw cursor" "off" EndSection Section "Device" Identifier "any supported Trident chip" Driver "trident" EndSection Section "Device" Identifier "MGA Millennium I" Driver "mga" Option "hw cursor" "off" BusID "PCI:0:10:0" EndSection Section "Device" Identifier "MGA G200 AGP" Driver "mga" BusID "PCI:1:0:0" Option "pci retry" EndSection XCOMM ********************************************************************** XCOMM Screen sections. XCOMM ********************************************************************** XCOMM Any number of screen sections may be present. Each describes XCOMM the configuration of a single screen. A single specific screen section XCOMM may be specified from the X server command line with the "-screen" XCOMM option. Section "Screen" XCOMM The Identifier, Device and Monitor lines must be present Identifier "Screen 1" Device "Generic VGA" Monitor "Generic Monitor" XCOMM The favoured Depth and/or Bpp may be specified here DefaultDepth 8 SubSection "Display" Depth 8 Modes "640x480" ViewPort 0 0 Virtual 800 600 EndSubsection SubSection "Display" Depth 4 Modes "640x480" EndSubSection SubSection "Display" Depth 1 Modes "640x480" EndSubSection EndSection Section "Screen" Identifier "Screen MGA1" Device "MGA Millennium I" Monitor "Generic Monitor" Option "no accel" DefaultDepth 16 XCOMM DefaultDepth 24 SubSection "Display" Depth 8 Modes "1280x1024" Option "rgb bits" "8" Visual "StaticColor" EndSubSection SubSection "Display" Depth 16 Modes "1280x1024" EndSubSection SubSection "Display" Depth 24 Modes "1280x1024" EndSubSection EndSection Section "Screen" Identifier "Screen MGA2" Device "MGA G200 AGP" Monitor "Generic Monitor" DefaultDepth 8 SubSection "Display" Depth 8 Modes "1280x1024" Option "rgb bits" "8" Visual "StaticColor" EndSubSection EndSection XCOMM ********************************************************************** XCOMM ServerLayout sections. XCOMM ********************************************************************** XCOMM Any number of ServerLayout sections may be present. Each describes XCOMM the way multiple screens are organised. A specific ServerLayout XCOMM section may be specified from the X server command line with the XCOMM "-layout" option. In the absence of this, the first section is used. XCOMM When now ServerLayout section is present, the first Screen section XCOMM is used alone. Section "ServerLayout" XCOMM The Identifier line must be present Identifier "Main Layout" XCOMM Each Screen line specifies a Screen section name, and optionally XCOMM the relative position of other screens. The four names after XCOMM primary screen name are the screens to the top, bottom, left and right XCOMM of the primary screen. In this example, screen 2 is located to the XCOMM right of screen 1. Screen "Screen MGA 1" "" "" "" "Screen MGA 2" Screen "Screen MGA 2" "" "" "Screen MGA 1" "" XCOMM Each InputDevice line specifies an InputDevice section name and XCOMM optionally some options to specify the way the device is to be XCOMM used. Those options include "CorePointer", "CoreKeyboard" and XCOMM "SendCoreEvents". In this example, "Mouse1" is the core pointer, XCOMM and "Mouse2" is an extended input device that also generates core XCOMM pointer events (i.e., both mice will move the standard pointer). InputDevice "Mouse1" "CorePointer" InputDevice "Mouse2" "SendCoreEvents" InputDevice "Keyboard1" "CoreKeyboard" EndSection Section "ServerLayout" Identifier "another layout" Screen "Screen 1" Screen "Screen MGA 1" InputDevice "Mouse1" "CorePointer" InputDevice "Keyboard1" "CoreKeyboard" EndSection Section "ServerLayout" Identifier "simple layout" Screen "Screen 1" InputDevice "Mouse1" "CorePointer" InputDevice "Keyboard1" "CoreKeyboard" EndSection