xserver pixman mesa git update 19 jan 2011

1 files changed, 0 insertions, 2478 deletions

diff --git a/xorg-server/hw/xfree86/doc/man/xorg.conf.man.pre b/xorg-server/hw/xfree86/doc/man/xorg.conf.man.pre
deleted file mode 100644
index 2267a0a1a..000000000
--- a/xorg-server/hw/xfree86/doc/man/xorg.conf.man.pre
+++ /dev/null
@@ -1,2478 +0,0 @@
-.\" shorthand for double quote that works everywhere.

-.ds q \N'34'

-.TH __xconfigfile__ __filemansuffix__ __vendorversion__

-.SH NAME

-__xconfigfile__ and __xconfigdir__ \- configuration files for

-__xservername__ X server

-.SH INTRODUCTION

-.B __xservername__

-supports several mechanisms for supplying/obtaining configuration and

-run-time parameters: command line options, environment variables, the

-__xconfigfile__ and __xconfigdir__ configuration files, auto-detection,

-and fallback defaults. When the same information is supplied in more

-than one way, the highest precedence mechanism is used. The list of

-mechanisms is ordered from highest precedence to lowest. Note that not

-all parameters can be supplied via all methods. The available command

-line options and environment variables (and some defaults) are

-described in the Xserver(__appmansuffix__) and

-__xservername__(__appmansuffix__) manual pages. Most configuration file

-parameters, with their defaults, are described below. Driver and module

-specific configuration parameters are described in the relevant driver

-or module manual page.

-.SH DESCRIPTION

-.B __xservername__

-uses a configuration file called

-.I __xconfigfile__

-and files ending in the suffix

-.I .conf

-from the directory

-.I __xconfigdir__

-for its initial setup.

-The

-.I __xconfigfile__

-configuration file is searched for in the following places when the

-server is started as a normal user:

-.PP

-.RS 4

-.nf

-.IR /etc/X11/ <cmdline>

-.IR __projectroot__/etc/X11/ <cmdline>

-.IB /etc/X11/ $XORGCONFIG

-.IB __projectroot__/etc/X11/ $XORGCONFIG

-.I /etc/X11/__xconfigfile__

-.I /etc/__xconfigfile__

-.IR __projectroot__/etc/X11/__xconfigfile__. <hostname>

-.I __projectroot__/etc/X11/__xconfigfile__

-.IR __projectroot__/lib/X11/__xconfigfile__. <hostname>

-.I __projectroot__/lib/X11/__xconfigfile__

-.fi

-.RE

-.PP

-where

-.I <cmdline>

-is a relative path (with no \(lq..\(rq components) specified with the

-.B \-config

-command line option,

-.B $XORGCONFIG

-is the relative path (with no \(lq..\(rq components) specified by that

-environment variable, and

-.I <hostname>

-is the machine's hostname as reported by

-.BR gethostname (__libmansuffix__).

-.PP

-When the __xservername__ server is started by the \(lqroot\(rq user, the config file

-search locations are as follows:

-.PP

-.RS 4

-.nf

-<cmdline>

-.IR /etc/X11/ <cmdline>

-.IR __projectroot__/etc/X11/ <cmdline>

-.B $XORGCONFIG

-.IB /etc/X11/ $XORGCONFIG

-.IB __projectroot__/etc/X11/ $XORGCONFIG

-.I /etc/X11/__xconfigfile__

-.I /etc/__xconfigfile__

-.IR __projectroot__/etc/X11/__xconfigfile__. <hostname>

-.I __projectroot__/etc/X11/__xconfigfile__

-.IR __projectroot__/lib/X11/__xconfigfile__. <hostname>

-.I __projectroot__/lib/X11/__xconfigfile__

-.fi

-.RE

-.PP

-where

-.I <cmdline>

-is the path specified with the

-.B \-config

-command line option (which may be absolute or relative),

-.B $XORGCONFIG

-is the path specified by that

-environment variable (absolute or relative),

-.B $HOME

-is the path specified by that environment variable (usually the home

-directory), and

-.I <hostname>

-is the machine's hostname as reported by

-.BR gethostname (__libmansuffix__).

-.PP

-Additional configuration files are searched for in the following

-directories when the server is started as a normal user:

-.PP

-.RS 4

-.nf

-.IR /etc/X11/ <cmdline>

-.IR __sysconfdir__/X11/ <cmdline>

-.I /etc/X11/__xconfigdir__

-.I __sysconfdir__/X11/__xconfigdir__

-.fi

-.RE

-.PP

-where

-.I <cmdline>

-is a relative path (with no \(lq..\(rq components) specified with the

-.B \-configdir

-command line option.

-.PP

-When the __xservername__ server is started by the \(lqroot\(rq user, the

-config directory search locations are as follows:

-.PP

-.RS 4

-.nf

-<cmdline>

-.IR /etc/X11/ <cmdline>

-.IR __sysconfdir__/X11/ <cmdline>

-.I /etc/X11/__xconfigdir__

-.I __sysconfdir__/X11/__xconfigdir__

-.fi

-.RE

-.PP

-where

-.I <cmdline>

-is the path specified with the

-.B \-configdir

-command line option (which may be absolute or relative).

-.PP

-Finally, configuration files will also be searched for in directories

-reserved for system use. These are to separate configuration files from

-the vendor or 3rd party packages from those of local administration.

-These files are found in the following directories:

-.PP

-.RS 4

-.nf

-.I /usr/share/X11/__xconfigdir__

-.I __datadir__/X11/__xconfigdir__

-.fi

-.RE

-.PP

-The

-.I __xconfigfile__

-and

-.I __xconfigdir__

-files are composed of a number of sections which may be present in any order,

-or omitted to use default configuration values.

-Each section has the form:

-.PP

-.RS 4

-.nf

-.BI "Section  \*q" SectionName \*q

-.RI "    " SectionEntry

-    ...

-.B EndSection

-.fi

-.RE

-.PP

-The section names are:

-.PP

-.RS 4

-.nf

-.BR "Files          " "File pathnames"

-.BR "ServerFlags    " "Server flags"

-.BR "Module         " "Dynamic module loading"

-.BR "Extensions     " "Extension enabling"

-.BR "InputDevice    " "Input device description"

-.BR "InputClass     " "Input class description"

-.BR "Device         " "Graphics device description"

-.BR "VideoAdaptor   " "Xv video adaptor description"

-.BR "Monitor        " "Monitor description"

-.BR "Modes          " "Video modes descriptions"

-.BR "Screen         " "Screen configuration"

-.BR "ServerLayout   " "Overall layout"

-.BR "DRI            " "DRI\-specific configuration"

-.BR "Vendor         " "Vendor\-specific configuration"

-.fi

-.RE

-.PP

-The following obsolete section names are still recognised for compatibility

-purposes.

-In new config files, the

-.B InputDevice

-section should be used instead.

-.PP

-.RS 4

-.nf

-.BR "Keyboard       " "Keyboard configuration"

-.BR "Pointer        " "Pointer/mouse configuration"

-.fi

-.RE

-.PP

-The old

-.B XInput

-section is no longer recognised.

-.PP

-The

-.B ServerLayout

-sections are at the highest level.

-They bind together the input and output devices that will be used in a session.

-The input devices are described in the

-.B InputDevice

-sections.

-Output devices usually consist of multiple independent components (e.g.,

-a graphics board and a monitor).

-These multiple components are bound together in the

-.B Screen

-sections, and it is these that are referenced by the

-.B ServerLayout

-section.

-Each

-.B Screen

-section binds together a graphics board and a monitor.

-The graphics boards are described in the

-.B Device

-sections, and the monitors are described in the

-.B Monitor

-sections.

-.PP

-Config file keywords are case\-insensitive, and \(lq_\(rq characters are

-ignored.

-Most strings (including

-.B Option

-names) are also case-insensitive, and insensitive to white space and

-\(lq_\(rq characters.

-.PP

-Each config file entry usually takes up a single line in the file.  They

-consist of a keyword, which is possibly followed by one or more arguments,

-with the number and types of the arguments depending on the keyword.

-The argument types are:

-.PP

-.RS 4

-.nf

-.BR "Integer     " "an integer number in decimal, hex or octal"

-.BR "Real        " "a floating point number"

-.BR "String      " "a string enclosed in double quote marks (\*q)"

-.fi

-.RE

-.PP

-Note: hex integer values must be prefixed with \(lq0x\(rq, and octal values

-with \(lq0\(rq.

-.PP

-A special keyword called

-.B Option

-may be used to provide free\-form data to various components of the server.

-The

-.B Option

-keyword takes either one or two string arguments.

-The first is the option name, and the optional second argument is the

-option value.

-Some commonly used option value types include:

-.PP

-.RS 4

-.nf

-.BR "Integer     " "an integer number in decimal, hex or octal"

-.BR "Real        " "a floating point number"

-.BR "String      " "a sequence of characters"

-.BR "Boolean     " "a boolean value (see below)"

-.BR "Frequency   " "a frequency value (see below)"

-.fi

-.RE

-.PP

-Note that

-.I all

-.B Option

-values, not just strings, must be enclosed in quotes.

-.PP

-Boolean options may optionally have a value specified.

-When no value is specified, the option's value is

-.BR TRUE .

-The following boolean option values are recognised as

-.BR TRUE :

-.PP

-.RS 4

-.BR 1 ,

-.BR on ,

-.BR true ,

-.B yes

-.RE

-.PP

-and the following boolean option values are recognised as

-.BR FALSE :

-.PP

-.RS 4

-.BR 0 ,

-.BR off ,

-.BR false ,

-.B no

-.RE

-.PP

-If an option name is prefixed with

-.RB \*q No \*q,

-then the option value is negated.

-.PP

-Example: the following option entries are equivalent:

-.PP

-.RS 4

-.nf

-.B "Option \*qAccel\*q   \*qOff\*q"

-.B "Option \*qNoAccel\*q"

-.B "Option \*qNoAccel\*q \*qOn\*q"

-.B "Option \*qAccel\*q   \*qfalse\*q"

-.B "Option \*qAccel\*q   \*qno\*q"

-.fi

-.RE

-.PP

-Frequency option values consist of a real number that is optionally

-followed by one of the following frequency units:

-.PP

-.RS 4

-.BR Hz ,

-.BR k ,

-.BR kHz ,

-.BR M ,

-.B MHz

-.RE

-.PP

-When the unit name is omitted, the correct units will be determined from

-the value and the expectations of the appropriate range of the value.

-It is recommended that the units always be specified when using frequency

-option values to avoid any errors in determining the value.

-.SH "FILES SECTION"

-The

-.B Files

-section is used to specify some path names required by the server.

-Some of these paths can also be set from the command line (see

-.BR Xserver (__appmansuffix__)

-and

-.BR __xservername__ (__appmansuffix__)).

-The command line settings override the values specified in the config

-file.

-The

-.B Files

-section is optional, as are all of the entries that may appear in it.

-.PP

-The entries that can appear in this section are:

-.TP 7

-.BI "FontPath \*q" path \*q

-sets the search path for fonts.

-This path is a comma separated list of font path elements which the __xservername__

-server searches for font databases.

-Multiple

-.B FontPath

-entries may be specified, and they will be concatenated to build up the

-fontpath used by the server.  Font path elements can be absolute

-directory paths, catalogue directories or a font server identifier. The

-formats of the later two are explained below:

-.PP

-.RS 7

-Catalogue directories:

-.PP

-.RS 4

-Catalogue directories can be specified using the prefix \fBcatalogue:\fR

-before the directory name. The directory can then be populated with

-symlinks pointing to the real font directories, using the following

-syntax in the symlink name:

-.PP

-.RS 4

-.IR <identifier> : [attribute]: pri= <priority>

-.RE

-.PP

-where

-.I <identifier>

-is an alphanumeric identifier,

-.I [attribute]

-is an attribute which will be passed to the underlying FPE and

-.I <priority>

-is a number used to order the fontfile FPEs. Examples:

-.PP

-.RS 4

-.nf

-.I 75dpi:unscaled:pri=20  -> /usr/share/X11/fonts/75dpi

-.I gscript:pri=60 -> /usr/share/fonts/default/ghostscript

-.I misc:unscaled:pri=10 \-> /usr/share/X11/fonts/misc

-.fi

-.PP

-.RE .RE .RE

-.PP

-.RS 7

-Font server identifiers:

-.PP

-.RS 4

-Font server identifiers have the form:

-.RS 4

-.PP

-.IR <trans> / <hostname> : <port\-number>

-.RE

-.PP

-where

-.I <trans>

-is the transport type to use to connect to the font server (e.g.,

-.B unix

-for UNIX\-domain sockets or

-.B tcp

-for a TCP/IP connection),

-.I <hostname>

-is the hostname of the machine running the font server, and

-.I <port\-number>

-is the port number that the font server is listening on (usually 7100).

-.RE

-.PP

-When this entry is not specified in the config file, the server falls back

-to the compiled\-in default font path, which contains the following

-font path elements (which can be set inside a catalogue directory):

-.PP

-.RS 4

-.nf

-.I __datadir__/fonts/X11/misc/

-.I __datadir__/fonts/X11/TTF/

-.I __datadir__/fonts/X11/OTF/

-.I __datadir__/fonts/X11/Type1/

-.I __datadir__/fonts/X11/100dpi/

-.I __datadir__/fonts/X11/75dpi/

-.fi

-.RE

-.PP

-Font path elements that are found to be invalid are removed from the

-font path when the server starts up.

-.RE

-.TP 7

-.BI "ModulePath \*q" path \*q

-sets the search path for loadable __xservername__ server modules.

-This path is a comma separated list of directories which the __xservername__ server

-searches for loadable modules loading in the order specified.

-Multiple

-.B ModulePath

-entries may be specified, and they will be concatenated to build the

-module search path used by the server.  The default module path is

-.PP

-.RS 11

-__modulepath__

-.RE

-.\" The LogFile keyword is not currently implemented

-.ig

-.TP 7

-.BI "LogFile \*q" path \*q

-sets the name of the __xservername__ server log file.

-The default log file name is

-.PP

-.RS 11

-.RI __logdir__/__xservername__. <n> .log

-.RE

-.PP

-.RS 7

-where

-.I <n>

-is the display number for the __xservername__ server.

-..

-.TP 7

-.BI "XkbDir \*q" path \*q

-sets the base directory for keyboard layout files.  The

-.B \-xkbdir

-command line option can be used to override this.  The default directory is

-.PP

-.RS 11

-__xkbdir__

-.RE

-.SH "SERVERFLAGS SECTION"

-In addition to options specific to this section (described below), the

-.B ServerFlags

-section is used to specify some global

-__xservername__ server options.

-All of the entries in this section are

-.BR Options ,

-although for compatibility purposes some of the old style entries are

-still recognised.

-Those old style entries are not documented here, and using them is

-discouraged.

-The

-.B ServerFlags

-section is optional, as are the entries that may be specified in it.

-.PP

-.B Options

-specified in this section (with the exception of the

-.B \*qDefaultServerLayout\*q

-.BR Option )

-may be overridden by

-.B Options

-specified in the active

-.B ServerLayout

-section.

-Options with command line equivalents are overridden when their command

-line equivalent is used.

-The options recognised by this section are:

-.TP 7

-.BI "Option \*qDefaultServerLayout\*q  \*q" layout\-id \*q

-This specifies the default

-.B ServerLayout

-section to use in the absence of the

-.B \-layout

-command line option.

-.TP 7

-.BI "Option \*qNoTrapSignals\*q  \*q" boolean \*q

-This prevents the __xservername__ server from trapping a range of unexpected fatal

-signals and exiting cleanly.

-Instead, the __xservername__ server will die and drop core where the fault occurred.

-The default behaviour is for the __xservername__ server to exit cleanly, but still drop a

-core file.

-In general you never want to use this option unless you are debugging an __xservername__

-server problem and know how to deal with the consequences.

-.TP 7

-.BI "Option \*qUseSIGIO\*q  \*q" boolean \*q

-This controls whether the __xservername__ server requests that events from

-input devices be reported via a SIGIO signal handler (also known as SIGPOLL

-on some platforms), or only reported via the standard select(3) loop.

-The default behaviour is platform specific.   In general you do not want to

-use this option unless you are debugging the __xservername__ server, or

-working around a specific bug until it is fixed, and understand the

-consequences.

-.TP 7

-.BI "Option \*qDontVTSwitch\*q  \*q" boolean \*q

-This disallows the use of the

-.BI Ctrl+Alt+F n

-sequence (where

-.RI F n

-refers to one of the numbered function keys).

-That sequence is normally used to switch to another \*qvirtual terminal\*q

-on operating systems that have this feature.

-When this option is enabled, that key sequence has no special meaning and

-is passed to clients.

-Default: off.

-.TP 7

-.BI "Option \*qDontZap\*q  \*q" boolean \*q

-This disallows the use of the

-.B Terminate_Server

-XKB action (usually on Ctrl+Alt+Backspace, depending on XKB options).

-This action is normally used to terminate the __xservername__ server.

-When this option is enabled, the action has no effect.

-Default: off.

-.TP 7

-.BI "Option \*qDontZoom\*q  \*q" boolean \*q

-This disallows the use of the

-.B Ctrl+Alt+Keypad\-Plus

-and

-.B Ctrl+Alt+Keypad\-Minus

-sequences.

-These sequences allows you to switch between video modes.

-When this option is enabled, those key sequences have no special meaning

-and are passed to clients.

-Default: off.

-.TP 7

-.BI "Option \*qDisableVidModeExtension\*q  \*q" boolean \*q

-This disables the parts of the VidMode extension used by the xvidtune client

-that can be used to change the video modes.

-Default: the VidMode extension is enabled.

-.TP 7

-.BI "Option \*qAllowNonLocalXvidtune\*q  \*q" boolean \*q

-This allows the xvidtune client (and other clients that use the VidMode

-extension) to connect from another host.

-Default: off.

-.TP 7

-.BI "Option \*qAllowMouseOpenFail\*q  \*q" boolean \*q

-This tells the mousedrv(__drivermansuffix__) and vmmouse(__drivermansuffix__)

-drivers to not report failure if the mouse device can't be opened/initialised.

-It has no effect on the evdev(__drivermansuffix__) or other drivers.

-Default: false.

-.TP 7

-.BI "Option \*qVTSysReq\*q  \*q" boolean \*q

-enables the SYSV\-style VT switch sequence for non\-SYSV systems

-which support VT switching.

-This sequence is

-.B Alt\-SysRq

-followed by a function key

-.RB ( Fn ).

-This prevents the __xservername__ server trapping the

-keys used for the default VT switch sequence, which means that clients can

-access them.

-Default: off.

-.TP 7

-.BI "Option \*qBlankTime\*q  \*q" time \*q

-sets the inactivity timeout for the

-.B blank

-phase of the screensaver.

-.I time

-is in minutes.

-This is equivalent to the __xservername__ server's

-.B \-s

-flag, and the value can be changed at run\-time with

-.BR xset(__appmansuffix__).

-Default: 10 minutes.

-.TP 7

-.BI "Option \*qStandbyTime\*q  \*q" time \*q

-sets the inactivity timeout for the

-.B standby

-phase of DPMS mode.

-.I time

-is in minutes, and the value can be changed at run\-time with

-.BR xset(__appmansuffix__).

-Default: 10 minutes.

-This is only suitable for VESA DPMS compatible monitors, and may not be

-supported by all video drivers.

-It is only enabled for screens that have the

-.B \*qDPMS\*q

-option set (see the MONITOR section below).

-.TP 7

-.BI "Option \*qSuspendTime\*q  \*q" time \*q

-sets the inactivity timeout for the

-.B suspend

-phase of DPMS mode.

-.I time

-is in minutes, and the value can be changed at run\-time with

-.BR xset(__appmansuffix__).

-Default: 10 minutes.

-This is only suitable for VESA DPMS compatible monitors, and may not be

-supported by all video drivers.

-It is only enabled for screens that have the

-.B \*qDPMS\*q

-option set (see the MONITOR section below).

-.TP 7

-.BI "Option \*qOffTime\*q  \*q" time \*q

-sets the inactivity timeout for the

-.B off

-phase of DPMS mode.

-.I time

-is in minutes, and the value can be changed at run\-time with

-.BR xset(__appmansuffix__).

-Default: 10 minutes.

-This is only suitable for VESA DPMS compatible monitors, and may not be

-supported by all video drivers.

-It is only enabled for screens that have the

-.B \*qDPMS\*q

-option set (see the MONITOR section below).

-.TP 7

-.BI "Option \*qPixmap\*q  \*q" bpp \*q

-This sets the pixmap format to use for depth 24.

-Allowed values for

-.I bpp

-are 24 and 32.

-Default: 32 unless driver constraints don't allow this (which is rare).

-Note: some clients don't behave well when this value is set to 24.

-.TP 7

-.BI "Option \*qPC98\*q  \*q" boolean \*q

-Specify that the machine is a Japanese PC\-98 machine.

-This should not be enabled for anything other than the Japanese\-specific

-PC\-98 architecture.

-Default: auto\-detected.

-.TP 7

-.BI "Option \*qNoPM\*q  \*q" boolean \*q

-Disables something to do with power management events.

-Default: PM enabled on platforms that support it.

-.TP 7

-.BI "Option \*qXinerama\*q  \*q" boolean \*q

-enable or disable XINERAMA extension.

-Default is disabled.

-.TP 7

-.BI "Option \*qAIGLX\*q \*q" boolean \*q

-enable or disable AIGLX. AIGLX is enabled by default.

-.TP 7

-.BI "Option \*qDRI2\*q \*q" boolean \*q

-enable or disable DRI2. DRI2 is disabled by default.

-.TP 7

-.BI "Option \*qGlxVisuals\*q \*q" string \*q

-This option controls how many GLX visuals the GLX modules sets up.

-The default value is

-.BR "typical" ,

-which will setup up a typical subset of

-the GLXFBConfigs provided by the driver as GLX visuals.  Other options are

-.BR "minimal" ,

-which will set up the minimal set allowed by the GLX specification and

-.BR "all"

-which will setup GLX visuals for all GLXFBConfigs.

-.TP 7

-.BI "Option \*qUseDefaultFontPath\*q \*q" boolean \*q

-Include the default font path even if other paths are specified in

-xorg.conf. If enabled, other font paths are included as well. Enabled by

-default.

-.TP 7

-.BI "Option \*qIgnoreABI\*q \*q" boolean \*q

-Allow modules built for a different, potentially incompatible version of

-the X server to load. Disabled by default.

-.TP 7

-.BI "Option \*qAutoAddDevices\*q \*q" boolean \*q

-If this option is disabled, then no devices will be added from HAL events.

-Enabled by default.

-.TP 7

-.BI "Option \*qAutoEnableDevices\*q \*q" boolean \*q

-If this option is disabled, then the devices will be added (and the

-DevicePresenceNotify event sent), but not enabled, thus leaving policy up

-to the client.

-Enabled by default.

-.TP 7

-.BI "Option \*qLog\*q \*q" string \*q

-This option controls whether the log is flushed and/or synced to disk after

-each message.

-Possible values are

-.B flush

-or

-.BR sync .

-Unset by default.

-.SH "MODULE SECTION"

-The

-.B Module

-section is used to specify which __xservername__ server modules should be loaded.

-This section is ignored when the __xservername__ server is built in static form.

-The type of modules normally loaded in this section are __xservername__ server

-extension modules.

-Most other module types are loaded automatically when they are needed via

-other mechanisms.

-The

-.B Module

-section is optional, as are all of the entries that may be specified in

-it.

-.PP

-Entries in this section may be in two forms.

-The first and most commonly used form is an entry that uses the

-.B Load

-keyword, as described here:

-.TP 7

-.BI "Load  \*q" modulename \*q

-This instructs the server to load the module called

-.IR modulename .

-The module name given should be the module's standard name, not the

-module file name.

-The standard name is case\-sensitive, and does not include the \(lqlib\(rq

-prefix, or the \(lq.a\(rq, \(lq.o\(rq, or \(lq.so\(rq suffixes.

-.PP

-.RS 7

-Example: the DRI extension module can be loaded with the following entry:

-.PP

-.RS 4

-.B "Load \*qdri\*q"

-.RE

-.RE

-.TP 7

-.BI "Disable  \*q" modulename \*q

-This instructs the server to not load the module called

-.IR modulename .

-Some modules are loaded by default in the server, and this overrides that

-default. If a

-.B Load

-instruction is given for the same module, it overrides the

-.B Disable

-instruction and the module is loaded. The module name given should be the

-module's standard name, not the module file name. As with the

-.B Load

-instruction, the standard name is case-sensitive, and does not include the

-"lib" prefix, or the ".a", ".o", or ".so" suffixes.

-.PP

-The second form of entry is a

-.BR SubSection,

-with the subsection name being the module name, and the contents of the

-.B SubSection

-being

-.B Options

-that are passed to the module when it is loaded.

-.PP

-Example: the extmod module (which contains a miscellaneous group of

-server extensions) can be loaded, with the XFree86\-DGA extension

-disabled by using the following entry:

-.PP

-.RS 4

-.nf

-.B "SubSection \*qextmod\*q"

-.B "   Option  \*qomit XFree86\-DGA\*q"

-.B EndSubSection

-.fi

-.RE

-.PP

-Modules are searched for in each directory specified in the

-.B ModulePath

-search path, and in the drivers, extensions, input, internal, and

-multimedia subdirectories of each of those directories.

-In addition to this, operating system specific subdirectories of all

-the above are searched first if they exist.

-.PP

-To see what extension modules are available, check the extensions

-subdirectory under:

-.PP

-.RS 4

-.nf

-__modulepath__

-.fi

-.RE

-.PP

-The \(lqextmod\(rq, \(lqdbe\(rq, \(lqdri\(rq, \(lqdri2\(rq, \(lqglx\(rq,

-and \(lqrecord\(rq extension modules are loaded automatically, if they

-are present, unless disabled with \*qDisable\*q entries.

-It is recommended

-that at very least the \(lqextmod\(rq extension module be loaded.

-If it isn't, some commonly used server extensions (like the SHAPE

-extension) will not be available.

-.SH "EXTENSIONS SECTION"

-The

-.B Extensions

-section is used to specify which X11 protocol extensions should be enabled

-or disabled.

-The

-.B Extensions

-section is optional, as are all of the entries that may be specified in

-it.

-.PP

-Entries in this section are listed as Option statements with the name of

-the extension as the first argument, and a boolean value as the second.

-The extension name is case\-sensitive, and matches the form shown in the output

-of \*qXorg -extension ?\*q.

-.PP

-.RS 7

-Example: the MIT-SHM extension can be disabled with the following entry:

-.PP

-.RS 4

-.nf

-.B "Section \*qExtensions\*q"

-.B "    Option \*qMIT-SHM\*q \*qDisable\*q"

-.B "EndSection"

-.fi

-.RE

-.RE

-.SH "INPUTDEVICE SECTION"

-The config file may have multiple

-.B InputDevice

-sections.

-Recent X servers employ input hotplugging to add input devices, with the HAL

-backend being the default backend for X servers since 1.4. It is usually not

-necessary to provide

-.B InputDevice

-sections in the xorg.conf if hotplugging is enabled.

-.PP

-If hotplugging is disabled, there will normally

-be at least two: one for the core (primary) keyboard

-and one for the core pointer.

-If either of these two is missing, a default configuration for the missing

-ones will be used. In the absence of an explicitly specified core input

-device, the first

-.B InputDevice

-marked as

-.B CorePointer

-(or

-.BR CoreKeyboard )

-is used.

-If there is no match there, the first

-.B InputDevice

-that uses the \(lqmouse\(rq (or \(lqkbd\(rq) driver is used.

-The final fallback is to use built\-in default configurations.

-Currently the default configuration may not work as expected on all platforms.

-.PP

-.B InputDevice

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qInputDevice\*q"

-.BI "    Identifier \*q" name \*q

-.BI "    Driver     \*q" inputdriver \*q

-.I  "    options"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-The

-.B Identifier

-and

-.B Driver

-entries are required in all

-.B InputDevice

-sections.

-All other entries are optional.

-.PP

-The

-.B Identifier

-entry specifies the unique name for this input device.

-The

-.B Driver

-entry specifies the name of the driver to use for this input device.

-When using the loadable server, the input driver module

-.RI \*q inputdriver \*q

-will be loaded for each active

-.B InputDevice

-section.

-An

-.B InputDevice

-section is considered active if it is referenced by an active

-.B ServerLayout

-section, if it is referenced by the

-.B \-keyboard

-or

-.B \-pointer

-command line options, or if it is selected implicitly as the core pointer

-or keyboard device in the absence of such explicit references.

-The most commonly used input drivers are

-.BR evdev (__drivermansuffix__)

-on Linux systems, and

-.BR kbd (__drivermansuffix__)

-and

-.BR mousedrv (__drivermansuffix__)

-on other platforms.

-.PP

-.PP

-.B InputDevice

-sections recognise some driver\-independent

-.BR Options ,

-which are described here.

-See the individual input driver manual pages for a description of the

-device\-specific options.

-.TP 7

-.BI "Option \*qAutoServerLayout\*q  \*q" boolean \*q

-Always add the device to the ServerLayout section used by this instance of

-the server. This affects implied layouts as well as explicit layouts

-specified in the configuration and/or on the command line.

-.TP 7

-.BI "Option \*qCorePointer\*q"

-Deprecated, see

-.B Floating

-.TP 7

-.BI "Option \*qCoreKeyboard\*q"

-Deprecated, see

-.B Floating

-.TP 7

-.BI "Option \*qAlwaysCore\*q  \*q" boolean \*q

-Deprecated, see

-.B Floating

-.TP 7

-.BI "Option \*qSendCoreEvents\*q  \*q" boolean \*q

-Deprecated, see

-.B Floating

-

-.TP 7

-.BI "Option \*qFloating\*q  \*q" boolean \*q

-When enabled, the input device is set up floating and does not

-report events through any master device or control a cursor. The device is

-only available to clients using the X Input Extension API. This option is

-disabled by default.

-The options

-.B CorePointer,

-.B CoreKeyboard,

-.B AlwaysCore,

-and

-.B SendCoreEvents,

-are the inverse of option

-.B Floating

-(i.e.

-.B SendCoreEvents \*qon\*q

-is equivalent to

-.B Floating \*qoff\*q

-).

-

-This option controls the startup behavior only, a device

-may be reattached or set floating at runtime.

-.PP

-For pointing devices, the following options control how the pointer

-is accelerated or decelerated with respect to physical device motion. Most of

-these can be adjusted at runtime, see the xinput(1) man page for details. Only

-the most important acceleration options are discussed here.

-.TP 7

-.BI "Option \*qAccelerationProfile\*q  \*q" integer \*q

-Select the profile. In layman's terms, the profile constitutes the "feeling" of

-the acceleration. More formally, it defines how the transfer function (actual

-acceleration as a function of current device velocity and acceleration controls)

-is constructed. This is mainly a matter of personal preference.

-.PP

-.RS 6

-.nf

-.B  " 0      classic (mostly compatible)"

-.B  "-1      none (only constant deceleration is applied)"

-.B  " 1      device-dependent"

-.B  " 2      polynomial (polynomial function)"

-.B  " 3      smooth linear (soft knee, then linear)"

-.B  " 4      simple (normal when slow, otherwise accelerated)"

-.B  " 5      power (power function)"

-.B  " 6      linear (more speed, more acceleration)"

-.B  " 7      limited (like linear, but maxes out at threshold)"

-.fi

-.RE

-.TP 7

-.BI "Option \*qConstantDeceleration\*q  \*q" real \*q

-Makes the pointer go

-.B deceleration

-times slower than normal. Most useful for high-resolution devices.

-.TP 7

-.BI "Option \*qAdaptiveDeceleration\*q  \*q" real \*q

-Allows to actually decelerate the pointer when going slow. At most, it will be

-.B adaptive deceleration

-times slower. Enables precise pointer placement without sacrificing speed.

-.TP 7

-.BI "Option \*qAccelerationScheme\*q  \*q" string \*q

-Selects the scheme, which is the underlying algorithm.

-.PP

-.RS 7

-.nf

-.B  "predictable   default algorithm (behaving more predictable)"

-.B  "lightweight   old acceleration code (as specified in the X protocol spec)"

-.B  "none          no acceleration or deceleration"

-.fi

-.RE

-.TP 7

-.BI "Option \*qAccelerationNumerator\*q  \*q" integer \*q

-.TP 7

-.BI "Option \*qAccelerationDenominator\*q  \*q" integer \*q

-Set numerator and denominator of the acceleration factor. The acceleration

-factor is a rational which, together with threshold, can be used to tweak

-profiles to suit the users needs. The

-.B simple

-and

-.B limited

-profiles use it directly (i.e. they accelerate by the factor), for other

-profiles it should hold that a higher acceleration factor leads to a faster

-pointer. Typically, 1 is unaccelerated and values up to 5 are sensible.

-.TP 7

-.BI "Option \*qAccelerationThreshold\*q  \*q" integer \*q

-Set the threshold, which is roughly the velocity (usually device units per 10

-ms) required for acceleration to become effective. The precise effect varies

-with the profile however.

-

-.SH "INPUTCLASS SECTION"

-The config file may have multiple

-.B InputClass

-sections.

-These sections are optional and are used to provide configuration for a

-class of input devices as they are automatically added. An input device can

-match more than one

-.B InputClass

-section. Each class can override settings from a previous class, so it is

-best to arrange the sections with the most generic matches first.

-.PP

-.B InputClass

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qInputClass\*q"

-.BI "    Identifier  \*q" name \*q

-.I  "    entries"

-.I  "    ..."

-.I  "    options"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-The

-.B Identifier

-entry is required in all

-.B InputClass

-sections.

-All other entries are optional.

-.PP

-The

-.B Identifier

-entry specifies the unique name for this input class.

-The

-.B Driver

-entry specifies the name of the driver to use for this input device.

-After all classes have been examined, the

-.RI \*q inputdriver \*q

-module from the first

-.B Driver

-entry will be enabled when using the loadable server.

-.PP

-When an input device is automatically added, its characteristics are

-checked against all

-.B InputClass

-sections. Each section can contain optional entries to narrow the match

-of the class. If none of the optional entries appear, the

-.B InputClass

-section is generic and will match any input device. If more than one of

-these entries appear, they all must match for the configuration to apply.

-.PP

-There are two types of match entries used in

-.B InputClass

-sections. The first allows various tokens to be matched against attributes

-of the device. An entry can be constructed to match attributes from different

-devices by separating arguments with a '|' character. Multiple entries of the

-same type may be supplied to add multiple matching conditions on the same

-attribute. For example:

-.PP

-.RS 4

-.nf

-.B  "Section \*qInputClass\*q"

-.B  "    Identifier   \*qMy Class\*q"

-.B  "    # product string must contain example and

-.B  "    # either gizmo or gadget

-.B  "    MatchProduct \*qexample\*q

-.B  "    MatchProduct \*qgizmo|gadget\*q

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.TP 7

-.BI "MatchProduct  \*q" matchproduct \*q

-This entry can be used to check if the substring

-.RI \*q matchproduct \*q

-occurs in the device's product name.

-.TP 7

-.BI "MatchVendor  \*q" matchvendor \*q

-This entry can be used to check if the substring

-.RI \*q matchvendor \*q

-occurs in the device's vendor name.

-.TP 7

-.BI "MatchDevicePath \*q" matchdevice \*q

-This entry can be used to check if the device file matches the

-.RI \*q matchdevice \*q

-pathname pattern.

-.TP 7

-.BI "MatchOS \*q" matchos \*q

-This entry can be used to check if the operating system matches the

-case-insensitive

-.RI \*q matchos \*q

-string. This entry is only supported on platforms providing the

-.BR uname (2)

-system call.

-.TP 7

-.BI "MatchPnPID \*q" matchpnp \*q

-The device's Plug and Play (PnP) ID can be checked against the

-.RI \*q matchpnp \*q

-shell wildcard pattern.

-.TP 7

-.BI "MatchUSBID \*q" matchusb \*q

-The device's USB ID can be checked against the

-.RI \*q matchusb \*q

-shell wildcard pattern. The ID is constructed as lowercase hexadecimal numbers

-separated by a ':'. This is the same format as the

-.BR lsusb (8)

-program.

-.TP 7

-.BI "MatchDriver \*q" matchdriver \*q

-Check the case-sensitive string

-.RI \*q matchdriver \*q

-against the currently configured driver of the device. Ordering of sections

-using this entry is important since it will not match unless the driver has

-been set by the config backend or a previous

-.B InputClass

-section.

-.TP 7

-.BI "MatchTag \*q" matchtag \*q

-This entry can be used to check if tags assigned by the config backend

-matches the

-.RI \*q matchtag \*q

-pattern. A match is found if at least one of the tags given in

-.RI \*q matchtag \*q

-matches at least one of the tags assigned by the backend.

-.PP

-The second type of entry is used to match device types. These entries take a

-boolean argument similar to

-.B Option

-entries.

-.TP 7

-.BI "MatchIsKeyboard     \*q" bool \*q

-.TP 7

-.BI "MatchIsPointer      \*q" bool \*q

-.TP 7

-.BI "MatchIsJoystick     \*q" bool \*q

-.TP 7

-.BI "MatchIsTablet       \*q" bool \*q

-.TP 7

-.BI "MatchIsTouchpad     \*q" bool \*q

-.TP 7

-.BI "MatchIsTouchscreen  \*q" bool \*q

-.PP

-When an input device has been matched to the

-.B InputClass

-section, any

-.B Option

-entries are applied to the device. One

-.B InputClass

-specific

-.B Option

-is recognized. See the

-.B InputDevice

-section above for a description of the remaining

-.B Option

-entries.

-.TP 7

-.BI "Option \*qIgnore\*q \*q" boolean \*q

-This optional entry specifies that the device should be ignored entirely,

-and not added to the server. This can be useful when the device is handled

-by another program and no X events should be generated.

-.SH "DEVICE SECTION"

-The config file may have multiple

-.B Device

-sections.

-There must be at least one, for the video card being used.

-.PP

-.B Device

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qDevice\*q"

-.BI "    Identifier \*q" name \*q

-.BI "    Driver     \*q" driver \*q

-.I  "    entries"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-The

-.B Identifier

-and

-.B Driver

-entries are required in all

-.B Device

-sections.  All other entries are optional.

-.PP

-The

-.B Identifier

-entry specifies the unique name for this graphics device.

-The

-.B Driver

-entry specifies the name of the driver to use for this graphics device.

-When using the loadable server, the driver module

-.RI \*q driver \*q

-will be loaded for each active

-.B Device

-section.

-A

-.B Device

-section is considered active if it is referenced by an active

-.B Screen

-section.

-.PP

-.B Device

-sections recognise some driver\-independent entries and

-.BR Options ,

-which are described here.

-Not all drivers make use of these

-driver\-independent entries, and many of those that do don't require them

-to be specified because the information is auto\-detected.

-See the individual graphics driver manual pages for further information

-about this, and for a description of the device\-specific options.

-Note that most of the

-.B Options

-listed here (but not the other entries) may be specified in the

-.B Screen

-section instead of here in the

-.B Device

-section.

-.TP 7

-.BI "BusID  \*q" bus\-id \*q

-This specifies the bus location of the graphics card.

-For PCI/AGP cards,

-the

-.I bus\-id

-string has the form

-.BI PCI: bus : device : function

-(e.g., \(lqPCI:1:0:0\(rq might be appropriate for an AGP card).

-This field is usually optional in single-head configurations when using

-the primary graphics card.

-In multi-head configurations, or when using a secondary graphics card in a

-single-head configuration, this entry is mandatory.

-Its main purpose is to make an unambiguous connection between the device

-section and the hardware it is representing.

-This information can usually be found by running the pciaccess tool

-scanpci.

-.TP 7

-.BI "Screen  " number

-This option is mandatory for cards where a single PCI entity can drive more

-than one display (i.e., multiple CRTCs sharing a single graphics accelerator

-and video memory).

-One

-.B Device

-section is required for each head, and this

-parameter determines which head each of the

-.B Device

-sections applies to.

-The legal values of

-.I number

-range from 0 to one less than the total number of heads per entity.

-Most drivers require that the primary screen (0) be present.

-.TP 7

-.BI "Chipset  \*q" chipset \*q

-This usually optional entry specifies the chipset used on the graphics

-board.

-In most cases this entry is not required because the drivers will probe the

-hardware to determine the chipset type.

-Don't specify it unless the driver-specific documentation recommends that you

-do.

-.TP 7

-.BI "Ramdac  \*q" ramdac\-type \*q

-This optional entry specifies the type of RAMDAC used on the graphics

-board.

-This is only used by a few of the drivers, and in most cases it is not

-required because the drivers will probe the hardware to determine the

-RAMDAC type where possible.

-Don't specify it unless the driver-specific documentation recommends that you

-do.

-.TP 7

-.BI "DacSpeed  " speed

-.TP 7

-.BI "DacSpeed  " "speed\-8 speed\-16 speed\-24 speed\-32"

-This optional entry specifies the RAMDAC speed rating (which is usually

-printed on the RAMDAC chip).

-The speed is in MHz.

-When one value is given, it applies to all framebuffer pixel sizes.

-When multiple values are given, they apply to the framebuffer pixel sizes

-8, 16, 24 and 32 respectively.

-This is not used by many drivers, and only needs to be specified when the

-speed rating of the RAMDAC is different from the defaults built in to

-driver, or when the driver can't auto-detect the correct defaults.

-Don't specify it unless the driver-specific documentation recommends that you

-do.

-.TP 7

-.BI "Clocks  " "clock ..."

-specifies the pixel that are on your graphics board.

-The clocks are in MHz, and may be specified as a floating point number.

-The value is stored internally to the nearest kHz.

-The ordering of the clocks is important.

-It must match the order in which they are selected on the graphics board.

-Multiple

-.B Clocks

-lines may be specified, and each is concatenated to form the list.

-Most drivers do not use this entry, and it is only required for some older

-boards with non-programmable clocks.

-Don't specify this entry unless the driver-specific documentation explicitly

-recommends that you do.

-.TP

-.BI "ClockChip  \*q" clockchip\-type \*q

-This optional entry is used to specify the clock chip type on graphics

-boards which have a programmable clock generator.

-Only a few __xservername__ drivers support programmable clock chips.

-For details, see the appropriate driver manual page.

-.TP 7

-.BI "VideoRam  " "mem"

-This optional entry specifies the amount of video ram that is installed

-on the graphics board.

-This is measured in kBytes.

-In most cases this is not required because the __xservername__ server probes

-the graphics board to determine this quantity.

-The driver-specific documentation should indicate when it might be needed.

-.TP 7

-.BI "BiosBase  " "baseaddress"

-This optional entry specifies the base address of the video BIOS for

-the VGA board.

-This address is normally auto-detected, and should only be specified if the

-driver-specific documentation recommends it.

-.TP 7

-.BI "MemBase  " "baseaddress"

-This optional entry specifies the memory base address of a graphics

-board's linear frame buffer.

-This entry is not used by many drivers, and it should only be specified if

-the driver-specific documentation recommends it.

-.TP 7

-.BI "IOBase  " "baseaddress"

-This optional entry specifies the IO base address.

-This entry is not used by many drivers, and it should only be specified if

-the driver-specific documentation recommends it.

-.TP 7

-.BI "ChipID  " "id"

-This optional entry specifies a numerical ID representing the chip type.

-For PCI cards, it is usually the device ID.

-This can be used to override the auto-detection, but that should only be done

-when the driver-specific documentation recommends it.

-.TP 7

-.BI "ChipRev  " "rev"

-This optional entry specifies the chip revision number.

-This can be used to override the auto-detection, but that should only be done

-when the driver-specific documentation recommends it.

-.TP 7

-.BI "TextClockFreq  " "freq"

-This optional entry specifies the pixel clock frequency that is used

-for the regular text mode.

-The frequency is specified in MHz.

-This is rarely used.

-.TP 7

-.BI "Option \*qModeDebug\*q \*q" boolean \*q

-Enable printing of additional debugging information about modesetting to

-the server log.

-.ig

-.TP 7

-This optional entry allows an IRQ number to be specified.

-..

-.TP 7

-.B Options

-Option flags may be specified in the

-.B Device

-sections.

-These include driver\-specific options and driver\-independent options.

-The former are described in the driver\-specific documentation.

-Some of the latter are described below in the section about the

-.B Screen

-section, and they may also be included here.

-

-.SH "VIDEOADAPTOR SECTION"

-Nobody wants to say how this works.

-Maybe nobody knows ...

-

-.SH "MONITOR SECTION"

-The config file may have multiple

-.B Monitor

-sections.

-There should normally be at least one, for the monitor being used,

-but a default configuration will be created when one isn't specified.

-.PP

-.B Monitor

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qMonitor\*q"

-.BI "    Identifier \*q" name \*q

-.I  "    entries"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-The only mandatory entry in a

-.B Monitor

-section is the

-.B Identifier

-entry.

-.PP

-The

-.B Identifier

-entry specifies the unique name for this monitor.

-The

-.B Monitor

-section may be used to provide information about the specifications of the

-monitor, monitor-specific

-.BR Options ,

-and information about the video modes to use with the monitor.

-.PP

-With RandR 1.2-enabled drivers, monitor sections may be tied to specific

-outputs of the video card.  Using the name of the output defined by the video

-driver plus the identifier of a monitor section, one associates a monitor

-section with an output by adding an option to the Device section in the

-following format:

-

-.B Option \*qMonitor-outputname\*q \*qmonitorsection\*q

-

-(for example,

-.B Option \*qMonitor-VGA\*q \*qVGA monitor\*q

-for a VGA output)

-.PP

-In the absence of specific association of monitor sections to outputs, if a

-monitor section is present the server will associate it with an output to

-preserve compatibility for previous single-head configurations.

-.PP

-Specifying video modes is optional because the server will use the DDC or other

-information provided by the monitor to automatically configure the list of

-modes available.

-When modes are specified explicitly in the

-.B Monitor

-section (with the

-.BR Modes ,

-.BR ModeLine ,

-or

-.B UseModes

-keywords), built-in modes with the same names are not included.

-Built-in modes with different names are, however, still implicitly included,

-when they meet the requirements of the monitor.

-.PP

-The entries that may be used in

-.B Monitor

-sections are described below.

-.TP 7

-.BI "VendorName  \*q" vendor \*q

-This optional entry specifies the monitor's manufacturer.

-.TP 7

-.BI "ModelName  \*q" model \*q

-This optional entry specifies the monitor's model.

-.TP 7

-.BI "HorizSync  " "horizsync\-range"

-gives the range(s) of horizontal sync frequencies supported by the

-monitor.

-.I horizsync\-range

-may be a comma separated list of either discrete values or ranges of

-values.

-A range of values is two values separated by a dash.

-By default the values are in units of kHz.

-They may be specified in MHz or Hz

-if

-.B MHz

-or

-.B Hz

-is added to the end of the line.

-The data given here is used by the __xservername__ server to determine if video

-modes are within the specifications of the monitor.

-This information should be available in the monitor's handbook.

-If this entry is omitted, a default range of 28\-33kHz is used.

-.TP 7

-.BI "VertRefresh  " "vertrefresh\-range"

-gives the range(s) of vertical refresh frequencies supported by the

-monitor.

-.I vertrefresh\-range

-may be a comma separated list of either discrete values or ranges of

-values.

-A range of values is two values separated by a dash.

-By default the values are in units of Hz.

-They may be specified in MHz or kHz

-if

-.B MHz

-or

-.B kHz

-is added to the end of the line.

-The data given here is used by the __xservername__ server to determine if video

-modes are within the specifications of the monitor.

-This information should be available in the monitor's handbook.

-If this entry is omitted, a default range of 43\-72Hz is used.

-.TP 7

-.BI "DisplaySize  " "width height"

-This optional entry gives the width and height, in millimetres, of the

-picture area of the monitor.

-If given this is used to calculate the horizontal and vertical pitch (DPI) of

-the screen.

-.TP 7

-.BI "Gamma  " "gamma\-value"

-.TP 7

-.BI "Gamma  " "red\-gamma green\-gamma blue\-gamma"

-This is an optional entry that can be used to specify the gamma correction

-for the monitor.

-It may be specified as either a single value or as three separate RGB values.

-The values should be in the range 0.1 to 10.0, and the default is 1.0.

-Not all drivers are capable of using this information.

-.TP 7

-.BI "UseModes  \*q" modesection\-id \*q

-Include the set of modes listed in the

-.B Modes

-section called

-.IR modesection\-id.

-This makes all of the modes defined in that section available for use by

-this monitor.

-.TP 7

-.BI "Mode  \*q" name \*q

-This is an optional multi-line entry that can be used to provide

-definitions for video modes for the monitor.

-In most cases this isn't necessary because the built-in set of VESA standard

-modes will be sufficient.

-The

-.B Mode

-keyword indicates the start of a multi-line video mode description.

-The mode description is terminated with the

-.B EndMode

-keyword.

-The mode description consists of the following entries:

-.RS 7

-.TP 4

-.BI "DotClock  " clock

-is the dot (pixel) clock rate to be used for the mode.

-.TP 4

-.BI "HTimings  " "hdisp hsyncstart hsyncend htotal"

-specifies the horizontal timings for the mode.

-.TP 4

-.BI "VTimings  " "vdisp vsyncstart vsyncend vtotal"

-specifies the vertical timings for the mode.

-.TP 4

-.BI "Flags  \*q" flag \*q " ..."

-specifies an optional set of mode flags, each of which is a separate

-string in double quotes.

-.B \*qInterlace\*q

-indicates that the mode is interlaced.

-.B \*qDoubleScan\*q

-indicates a mode where each scanline is doubled.

-.B \*q+HSync\*q

-and

-.B \*q\-HSync\*q

-can be used to select the polarity of the HSync signal.

-.B \*q+VSync\*q

-and

-.B \*q\-VSync\*q

-can be used to select the polarity of the VSync signal.

-.B \*qComposite\*q

-can be used to specify composite sync on hardware where this is supported.

-Additionally, on some hardware,

-.B \*q+CSync\*q

-and

-.B \*q\-CSync\*q

-may be used to select the composite sync polarity.

-.TP 4

-.BI "HSkew  " hskew

-specifies the number of pixels (towards the right edge of the screen) by

-which the display enable signal is to be skewed.

-Not all drivers use this information.

-This option might become necessary to override the default value supplied

-by the server (if any).

-\(lqRoving\(rq horizontal lines indicate this value needs to be increased.

-If the last few pixels on a scan line appear on the left of the screen,

-this value should be decreased.

-.TP 4

-.BI "VScan  " vscan

-specifies the number of times each scanline is painted on the screen.

-Not all drivers use this information.

-Values less than 1 are treated as 1, which is the default.

-Generally, the

-.B \*qDoubleScan\*q

-.B Flag

-mentioned above doubles this value.

-.RE

-.TP 7

-.BI "ModeLine  \*q" name \*q " mode\-description"

-This entry is a more compact version of the

-.B Mode

-entry, and it also can be used to specify video modes for the monitor.

-is a single line format for specifying video modes.

-In most cases this isn't necessary because the built\-in set of VESA

-standard modes will be sufficient.

-.PP

-.RS 7

-The

-.I mode\-description

-is in four sections, the first three of which are mandatory.

-The first is the dot (pixel) clock.

-This is a single number specifying the pixel clock rate for the mode in

-MHz.

-The second section is a list of four numbers specifying the horizontal

-timings.

-These numbers are the

-.IR hdisp ,

-.IR hsyncstart ,

-.IR hsyncend ,

-and

-.I htotal

-values.

-The third section is a list of four numbers specifying the vertical

-timings.

-These numbers are the

-.IR vdisp ,

-.IR vsyncstart ,

-.IR vsyncend ,

-and

-.I vtotal

-values.

-The final section is a list of flags specifying other characteristics of

-the mode.

-.B Interlace

-indicates that the mode is interlaced.

-.B DoubleScan

-indicates a mode where each scanline is doubled.

-.B +HSync

-and

-.B \-HSync

-can be used to select the polarity of the HSync signal.

-.B +VSync

-and

-.B \-VSync

-can be used to select the polarity of the VSync signal.

-.B Composite

-can be used to specify composite sync on hardware where this is supported.

-Additionally, on some hardware,

-.B +CSync

-and

-.B \-CSync

-may be used to select the composite sync polarity.

-The

-.B HSkew

-and

-.B VScan

-options mentioned above in the

-.B Modes

-entry description can also be used here.

-.RE

-.TP 7

-.BI "Option " "\*qDPMS\*q  " \*qbool\*q

-This option controls whether the server should enable the DPMS extension

-for power management for this screen.  The default is to enable the

-extension.

-.TP 7

-.BI "Option " "\*qSyncOnGreen\*q  " \*qbool\*q

-This option controls whether the video card should drive the sync signal

-on the green color pin.  Not all cards support this option, and most

-monitors do not require it.  The default is off.

-.TP 7

-.BI "Option " "\*qPrimary\*q  " \*qbool\*q

-This optional entry specifies that the monitor should be treated as the primary

-monitor. (RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qPreferredMode\*q  " \*qstring\*q

-This optional entry specifies a mode to be marked as the preferred initial mode

-of the monitor.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qPosition\*q  " "\*qx y\*q"

-This optional entry specifies the position of the monitor within the X

-screen.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qLeftOf\*q  " \*qoutput\*q

-This optional entry specifies that the monitor should be positioned to the

-left of the output (not monitor) of the given name.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qRightOf\*q  " \*qoutput\*q

-This optional entry specifies that the monitor should be positioned to the

-right of the output (not monitor) of the given name.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qAbove\*q  " \*qoutput\*q

-This optional entry specifies that the monitor should be positioned above the

-output (not monitor) of the given name.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qBelow\*q  " \*qoutput\*q

-This optional entry specifies that the monitor should be positioned below the

-output (not monitor) of the given name.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qEnable\*q  " \*qbool\*q

-This optional entry specifies whether the monitor should be turned on

-at startup.  By default, the server will attempt to enable all connected

-monitors.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qDefaultModes\*q  " \*qbool\*q

-This optional entry specifies whether the server should add supported default

-modes to the list of modes offered on this monitor. By default, the server

-will add default modes; you should only disable this if you can guarantee

-that EDID will be available at all times, or if you have added custom modelines

-which the server can use.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qMinClock\*q  " \*qfrequency\*q

-This optional entry specifies the minimum dot clock, in kHz, that is supported

-by the monitor.

-.TP 7

-.BI "Option " "\*qMaxClock\*q  " \*qfrequency\*q

-This optional entry specifies the maximum dot clock, in kHz, that is supported

-by the monitor.

-.TP 7

-.BI "Option " "\*qIgnore\*q  " \*qbool\*q

-This optional entry specifies that the monitor should be ignored entirely,

-and not reported through RandR.  This is useful if the hardware reports the

-presence of outputs that don't exist.

-(RandR 1.2-supporting drivers only)

-.TP 7

-.BI "Option " "\*qRotate\*q  " \*qrotation\*q

-This optional entry specifies the initial rotation of the given monitor.

-Valid values for rotation are \*qnormal\*q, \*qleft\*q, \*qright\*q, and

-\*qinverted\*q.

-(RandR 1.2-supporting drivers only)

-

-.SH "MODES SECTION"

-The config file may have multiple

-.B Modes

-sections, or none.

-These sections provide a way of defining sets of video modes independently

-of the

-.B Monitor

-sections.

-.B Monitor

-sections may include the definitions provided in these sections by

-using the

-.B UseModes

-keyword.

-In most cases the

-.B Modes

-sections are not necessary because the built\-in set of VESA standard modes

-will be sufficient.

-.PP

-.B Modes

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qModes\*q"

-.BI "    Identifier \*q" name \*q

-.I  "    entries"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-The

-.B Identifier

-entry specifies the unique name for this set of mode descriptions.

-The other entries permitted in

-.B Modes

-sections are the

-.B Mode

-and

-.B ModeLine

-entries that are described above in the

-.B Monitor

-section.

-.SH "SCREEN SECTION"

-The config file may have multiple

-.B Screen

-sections.

-There must be at least one, for the \(lqscreen\(rq being used.

-A \(lqscreen\(rq represents the binding of a graphics device

-.RB ( Device

-section) and a monitor

-.RB ( Monitor

-section).

-A

-.B Screen

-section is considered \(lqactive\(rq if it is referenced by an active

-.B ServerLayout

-section or by the

-.B \-screen

-command line option.

-If neither of those is present, the first

-.B Screen

-section found in the config file is considered the active one.

-.PP

-.B Screen

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qScreen\*q"

-.BI "    Identifier \*q" name \*q

-.BI "    Device     \*q" devid \*q

-.BI "    Monitor    \*q" monid \*q

-.I  "    entries"

-.I  "    ..."

-.BI "    SubSection \*qDisplay\*q"

-.I  "       entries"

-.I  "       ...

-.B  "    EndSubSection"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-The

-.B Identifier

-and

-.B Device

-entries are mandatory.

-All others are optional.

-.PP

-The

-.B Identifier

-entry specifies the unique name for this screen.

-The

-.B Screen

-section provides information specific to the whole screen, including

-screen\-specific

-.BR Options .

-In multi\-head configurations, there will be multiple active

-.B Screen

-sections, one for each head.

-The entries available

-for this section are:

-.TP 7

-.BI "Device  \*q" device\-id \*q

-This mandatory entry specifies the

-.B Device

-section to be used for this screen.

-This is what ties a specific graphics card to a screen.

-The

-.I device\-id

-must match the

-.B Identifier

-of a

-.B Device

-section in the config file.

-.TP 7

-.BI "Monitor  \*q" monitor\-id \*q

-specifies which monitor description is to be used for this screen.

-If a

-.B Monitor

-name is not specified, a default configuration is used.

-Currently the default configuration may not function as expected on all

-platforms.

-.TP 7

-.BI "VideoAdaptor  \*q" xv\-id \*q

-specifies an optional Xv video adaptor description to be used with this

-screen.

-.TP 7

-.BI "DefaultDepth  " depth

-specifies which color depth the server should use by default.

-The

-.B \-depth

-command line option can be used to override this.

-If neither is specified, the default depth is driver\-specific, but in most

-cases is 8.

-.TP 7

-.BI "DefaultFbBpp  " bpp

-specifies which framebuffer layout to use by default.

-The

-.B \-fbbpp

-command line option can be used to override this.

-In most cases the driver will chose the best default value for this.

-The only case where there is even a choice in this value is for depth 24,

-where some hardware supports both a packed 24 bit framebuffer layout and a

-sparse 32 bit framebuffer layout.

-.TP 7

-.B Options

-Various

-.B Option

-flags may be specified in the

-.B Screen

-section.

-Some are driver\-specific and are described in the driver documentation.

-Others are driver\-independent, and will eventually be described here.

-.\" XXX These should really be in an xaa man page.

-.TP 7

-.BI "Option \*qAccel\*q"

-Enables XAA (X Acceleration Architecture), a mechanism that makes video cards'

-2D hardware acceleration available to the  __xservername__ server.

-This option is on by default, but it may be necessary to turn it off if

-there are bugs in the driver.

-There are many options to disable specific accelerated operations, listed

-below.

-Note that disabling an operation will have no effect if the operation is

-not accelerated (whether due to lack of support in the hardware or in the

-driver).

-.TP 7

-.BI "Option \*qInitPrimary\*q \*q" boolean \*q

-Use the Int10 module to initialize the primary graphics card.

-Normally, only secondary cards are soft-booted using the Int10 module, as the

-primary card has already been initialized by the BIOS at boot time.

-Default: false.

-.TP 7

-.BI "Option \*qNoInt10\*q \*q" boolean \*q

-Disables the Int10 module, a module that uses the int10 call to the BIOS

-of the graphics card to initialize it.

-Default: false.

-.TP 7

-.BI "Option \*qNoMTRR\*q"

-Disables MTRR (Memory Type Range Register) support, a feature of modern

-processors which can improve video performance by a factor of up to 2.5.

-Some hardware has buggy MTRR support, and some video drivers have been

-known to exhibit problems when MTRR's are used.

-.TP 7

-.BI "Option \*qXaaNoCPUToScreenColorExpandFill\*q"

-Disables accelerated rectangular expansion blits from source patterns

-stored in system memory (using a memory\-mapped aperture).

-.TP 7

-.BI "Option \*qXaaNoColor8x8PatternFillRect\*q"

-Disables accelerated fills of a rectangular region with a full\-color

-pattern.

-.TP 7

-.BI "Option \*qXaaNoColor8x8PatternFillTrap\*q"

-Disables accelerated fills of a trapezoidal region with a full\-color

-pattern.

-.TP 7

-.BI "Option \*qXaaNoDashedBresenhamLine\*q"

-Disables accelerated dashed Bresenham line draws.

-.TP 7

-.BI "Option \*qXaaNoDashedTwoPointLine\*q"

-Disables accelerated dashed line draws between two arbitrary points.

-.TP 7

-.BI "Option \*qXaaNoImageWriteRect\*q"

-Disables accelerated transfers of full\-color rectangular patterns from

-system memory to video memory (using a memory\-mapped aperture).

-.TP 7

-.BI "Option \*qXaaNoMono8x8PatternFillRect\*q"

-Disables accelerated fills of a rectangular region with a monochrome

-pattern.

-.TP 7

-.BI "Option \*qXaaNoMono8x8PatternFillTrap\*q"

-Disables accelerated fills of a trapezoidal region with a monochrome

-pattern.

-.TP 7

-.BI "Option \*qXaaNoOffscreenPixmaps\*q"

-Disables accelerated draws into pixmaps stored in offscreen video memory.

-.TP 7

-.BI "Option \*qXaaNoPixmapCache\*q"

-Disables caching of patterns in offscreen video memory.

-.TP 7

-.BI "Option \*qXaaNoScanlineCPUToScreenColorExpandFill\*q"

-Disables accelerated rectangular expansion blits from source patterns

-stored in system memory (one scan line at a time).

-.TP 7

-.BI "Option \*qXaaNoScanlineImageWriteRect\*q"

-Disables accelerated transfers of full\-color rectangular patterns from

-system memory to video memory (one scan line at a time).

-.TP 7

-.BI "Option \*qXaaNoScreenToScreenColorExpandFill\*q"

-Disables accelerated rectangular expansion blits from source patterns

-stored in offscreen video memory.

-.TP 7

-.BI "Option \*qXaaNoScreenToScreenCopy\*q"

-Disables accelerated copies of rectangular regions from one part of

-video memory to another part of video memory.

-.TP 7

-.BI "Option \*qXaaNoSolidBresenhamLine\*q"

-Disables accelerated solid Bresenham line draws.

-.TP 7

-.BI "Option \*qXaaNoSolidFillRect\*q"

-Disables accelerated solid\-color fills of rectangles.

-.TP 7

-.BI "Option \*qXaaNoSolidFillTrap\*q"

-Disables accelerated solid\-color fills of Bresenham trapezoids.

-.TP 7

-.BI "Option \*qXaaNoSolidHorVertLine\*q"

-Disables accelerated solid horizontal and vertical line draws.

-.TP 7

-.BI "Option \*qXaaNoSolidTwoPointLine\*q"

-Disables accelerated solid line draws between two arbitrary points.

-.PP

-Each

-.B Screen

-section may optionally contain one or more

-.B Display

-subsections.

-Those subsections provide depth/fbbpp specific configuration information,

-and the one chosen depends on the depth and/or fbbpp that is being used for

-the screen.

-The

-.B Display

-subsection format is described in the section below.

-

-.SH "DISPLAY SUBSECTION"

-Each

-.B Screen

-section may have multiple

-.B Display

-subsections.

-The \(lqactive\(rq

-.B Display

-subsection is the first that matches the depth and/or fbbpp values being

-used, or failing that, the first that has neither a depth or fbbpp value

-specified.

-The

-.B Display

-subsections are optional.

-When there isn't one that matches the depth and/or fbbpp values being used,

-all the parameters that can be specified here fall back to their defaults.

-.PP

-.B Display

-subsections have the following format:

-.PP

-.RS 4

-.nf

-.B  "    SubSection \*qDisplay\*q"

-.BI "        Depth  " depth

-.I  "        entries"

-.I  "        ..."

-.B  "    EndSubSection"

-.fi

-.RE

-.TP 7

-.BI "Depth  " depth

-This entry specifies what colour depth the

-.B Display

-subsection is to be used for.

-This entry is usually specified, but it may be omitted to create a match\-all

-.B Display

-subsection or when wishing to match only against the

-.B FbBpp

-parameter.

-The range of

-.I depth

-values that are allowed depends on the driver.

-Most drivers support 8, 15, 16 and 24.

-Some also support 1 and/or 4, and some may support other values (like 30).

-Note:

-.I depth

-means the number of bits in a pixel that are actually used to determine

-the pixel colour.

-32 is not a valid

-.I depth

-value.

-Most hardware that uses 32 bits per pixel only uses 24 of them to hold the

-colour information, which means that the colour depth is 24, not 32.

-.TP 7

-.BI "FbBpp  " bpp

-This entry specifies the framebuffer format this

-.B Display

-subsection is to be used for.

-This entry is only needed when providing depth 24 configurations that allow

-a choice between a 24 bpp packed framebuffer format and a 32bpp sparse

-framebuffer format.

-In most cases this entry should not be used.

-.TP 7

-.BI "Weight  " "red\-weight green\-weight blue\-weight"

-This optional entry specifies the relative RGB weighting to be used

-for a screen is being used at depth 16 for drivers that allow multiple

-formats.

-This may also be specified from the command line with the

-.B \-weight

-option (see

-.BR __xservername__(__appmansuffix__)).

-.TP 7

-.BI "Virtual  " "xdim ydim"

-This optional entry specifies the virtual screen resolution to be used.

-.I xdim

-must be a multiple of either 8 or 16 for most drivers, and a multiple

-of 32 when running in monochrome mode.

-The given value will be rounded down if this is not the case.

-Video modes which are too large for the specified virtual size will be

-rejected.

-If this entry is not present, the virtual screen resolution will be set to

-accommodate all the valid video modes given in the

-.B Modes

-entry.

-Some drivers/hardware combinations do not support virtual screens.

-Refer to the appropriate driver\-specific documentation for details.

-.TP 7

-.BI "ViewPort  " "x0 y0"

-This optional entry sets the upper left corner of the initial display.

-This is only relevant when the virtual screen resolution is different

-from the resolution of the initial video mode.

-If this entry is not given, then the initial display will be centered in

-the virtual display area.

-.TP 7

-.BI "Modes  \*q" mode\-name \*q " ..."

-This optional entry specifies the list of video modes to use.

-Each

-.I mode\-name

-specified must be in double quotes.

-They must correspond to those specified or referenced in the appropriate

-.B Monitor

-section (including implicitly referenced built\-in VESA standard modes).

-The server will delete modes from this list which don't satisfy various

-requirements.

-The first valid mode in this list will be the default display mode for

-startup.

-The list of valid modes is converted internally into a circular list.

-It is possible to switch to the next mode with

-.B Ctrl+Alt+Keypad\-Plus

-and to the previous mode with

-.BR Ctrl+Alt+Keypad\-Minus .

-When this entry is omitted, the valid modes referenced by the appropriate

-.B Monitor

-section will be used.  If the

-.B Monitor

-section contains no modes, then the selection will be taken from the

-built-in VESA standard modes.

-.TP 7

-.BI "Visual  \*q" visual\-name \*q

-This optional entry sets the default root visual type.

-This may also be specified from the command line (see the

-.BR Xserver(__appmansuffix__)

-man page).

-The visual types available for depth 8 are (default is

-.BR PseudoColor ):

-.PP

-.RS 11

-.nf

-.B StaticGray

-.B GrayScale

-.B StaticColor

-.B PseudoColor

-.B TrueColor

-.B DirectColor

-.fi

-.RE

-.PP

-.RS 7

-The visual type available for the depths 15, 16 and 24 are (default is

-.BR TrueColor ):

-.PP

-.RS 4

-.nf

-.B TrueColor

-.B DirectColor

-.fi

-.RE

-.PP

-Not all drivers support

-.B DirectColor

-at these depths.

-.PP

-The visual types available for the depth 4 are (default is

-.BR StaticColor ):

-.PP

-.RS 4

-.nf

-.B StaticGray

-.B GrayScale

-.B StaticColor

-.B PseudoColor

-.fi

-.RE

-.PP

-The visual type available for the depth 1 (monochrome) is

-.BR StaticGray .

-.RE

-.TP 7

-.BI "Black  " "red green blue"

-This optional entry allows the \(lqblack\(rq colour to be specified.

-This is only supported at depth 1.

-The default is black.

-.TP 7

-.BI "White  " "red green blue"

-This optional entry allows the \(lqwhite\(rq colour to be specified.

-This is only supported at depth 1.

-The default is white.

-.TP 7

-.B Options

-Option flags may be specified in the

-.B Display

-subsections.

-These may include driver\-specific options and driver\-independent options.

-The former are described in the driver\-specific documentation.

-Some of the latter are described above in the section about the

-.B Screen

-section, and they may also be included here.

-.SH "SERVERLAYOUT SECTION"

-The config file may have multiple

-.B ServerLayout

-sections.

-A \(lqserver layout\(rq represents the binding of one or more screens

-.RB ( Screen

-sections) and one or more input devices

-.RB ( InputDevice

-sections) to form a complete configuration.

-In multi\-head configurations, it also specifies the relative layout of the

-heads.

-A

-.B ServerLayout

-section is considered \(lqactive\(rq if it is referenced by the

-.B \-layout

-command line option or by an

-.B "Option \*qDefaultServerLayout\*q"

-entry in the

-.B ServerFlags

-section (the former takes precedence over the latter).

-If those options are not used, the first

-.B ServerLayout

-section found in the config file is considered the active one.

-If no

-.B ServerLayout

-sections are present, the single active screen and two active (core)

-input devices are selected as described in the relevant sections above.

-.PP

-.B ServerLayout

-sections have the following format:

-.PP

-.RS 4

-.nf

-.B  "Section \*qServerLayout\*q"

-.BI "    Identifier   \*q" name \*q

-.BI "    Screen       \*q" screen\-id \*q

-.I  "    ..."

-.BI "    InputDevice  \*q" idev\-id \*q

-.I  "    ..."

-.I  "    options"

-.I  "    ..."

-.B  "EndSection"

-.fi

-.RE

-.PP

-Each

-.B ServerLayout

-section must have an

-.B Identifier

-entry and at least one

-.B Screen

-entry.

-.PP

-The

-.B Identifier

-entry specifies the unique name for this server layout.

-The

-.B ServerLayout

-section provides information specific to the whole session, including

-session\-specific

-.BR Options .

-The

-.B ServerFlags

-options (described above) may be specified here, and ones given here

-override those given in the

-.B ServerFlags

-section.

-.PP

-The entries that may be used in this section are described here.

-.TP 7

-.BI "Screen  " "screen\-num" " \*qscreen\-id\*q " "position\-information"

-One of these entries must be given for each screen being used in

-a session.

-The

-.I screen\-id

-field is mandatory, and specifies the

-.B Screen

-section being referenced.

-The

-.I screen\-num

-field is optional, and may be used to specify the screen number

-in multi\-head configurations.

-When this field is omitted, the screens will be numbered in the order that

-they are listed in.

-The numbering starts from 0, and must be consecutive.

-The

-.I position\-information

-field describes the way multiple screens are positioned.

-There are a number of different ways that this information can be provided:

-.RS 7

-.TP 4

-.I  "x y"

-.TP 4

-.BI "Absolute  " "x y"

-These both specify that the upper left corner's coordinates are

-.RI ( x , y ).

-The

-.B Absolute

-keyword is optional.

-Some older versions of XFree86 (4.2 and earlier) don't recognise the

-.B Absolute

-keyword, so it's safest to just specify the coordinates without it.

-.TP 4

-.BI "RightOf   \*q" screen\-id \*q

-.TP 4

-.BI "LeftOf    \*q" screen\-id \*q

-.TP 4

-.BI "Above     \*q" screen\-id \*q

-.TP 4

-.BI "Below     \*q" screen\-id \*q

-.TP 4

-.BI "Relative  \*q" screen\-id \*q " x y"

-These give the screen's location relative to another screen.

-The first four position the screen immediately to the right, left, above or

-below the other screen.

-When positioning to the right or left, the top edges are aligned.

-When positioning above or below, the left edges are aligned.

-The

-.B Relative

-form specifies the offset of the screen's origin (upper left corner)

-relative to the origin of another screen.

-.RE

-.TP 7

-.BI "InputDevice  \*q" idev\-id "\*q \*q" option \*q " ..."

-One of these entries should be given for each input device being used in

-a session.

-Normally at least two are required, one each for the core pointer and

-keyboard devices.

-If either of those is missing, suitable

-.B InputDevice

-entries are searched for using the method described above in the

-.B INPUTDEVICE

-section.  The

-.I idev\-id

-field is mandatory, and specifies the name of the

-.B InputDevice

-section being referenced.

-Multiple

-.I option

-fields may be specified, each in double quotes.

-The options permitted here are any that may also be given in the

-.B InputDevice

-sections.

-Normally only session\-specific input device options would be used here.

-The most commonly used options are:

-.PP

-.RS 11

-.nf

-.B \*qCorePointer\*q

-.B \*qCoreKeyboard\*q

-.B \*qSendCoreEvents\*q

-.fi

-.RE

-.PP

-.RS 7

-and the first two should normally be used to indicate the core pointer

-and core keyboard devices respectively.

-.RE

-.TP 7

-.B Options

-In addition to the following, any option permitted in the

-.B ServerFlags

-section may also be specified here.

-When the same option appears in both places, the value given here overrides

-the one given in the

-.B ServerFlags

-section.

-.TP 7

-.BI "Option \*qIsolateDevice\*q  \*q" bus\-id \*q

-Restrict device resets to the specified

-.IR bus\-id .

-See the

-.B BusID

-option (described in

-.BR "DEVICE SECTION" ,

-above) for the format of the

-.I bus\-id

-parameter.

-This option overrides

-.BR SingleCard ,

-if specified.

-At present, only PCI devices can be isolated in this manner.

-.TP 7

-.BI "Option \*qSingleCard\*q  \*q" boolean \*q

-As

-.BR IsolateDevice ,

-except that the bus ID of the first device in the layout is used.

-.PP

-Here is an example of a

-.B ServerLayout

-section for a dual headed configuration with two mice:

-.PP

-.RS 4

-.nf

-.B "Section \*qServerLayout\*q"

-.B "    Identifier  \*qLayout 1\*q"

-.B "    Screen      \*qMGA 1\*q"

-.B "    Screen      \*qMGA 2\*q RightOf \*qMGA 1\*q"

-.B "    InputDevice \*qKeyboard 1\*q \*qCoreKeyboard\*q"

-.B "    InputDevice \*qMouse 1\*q    \*qCorePointer\*q"

-.B "    InputDevice \*qMouse 2\*q    \*qSendCoreEvents\*q"

-.B "    Option      \*qBlankTime\*q  \*q5\*q"

-.B "EndSection"

-.fi

-.RE

-.SH "DRI SECTION"

-This optional section is used to provide some information for the

-Direct Rendering Infrastructure.

-Details about the format of this section can be found on-line at

-.IR <http://dri.freedesktop.org/> .

-.SH "VENDOR SECTION"

-The optional

-.B Vendor

-section may be used to provide vendor\-specific configuration information.

-Multiple

-.B Vendor

-sections may be present, and they may contain an

-.B Identifier

-entry and multiple

-.B Option

-flags.

-The data therein is not used in this release.

-.PP

-.SH "SEE ALSO"

-General:

-.BR X (__miscmansuffix__),

-.BR Xserver (__appmansuffix__),

-.BR __xservername__ (__appmansuffix__),

-.BR cvt (__appmansuffix__),

-.BR gtf (__appmansuffix__).

-.PP

-.B "Not all modules or interfaces are available on all platforms."

-.PP

-Display drivers:

-.BR apm (__drivermansuffix__),

-.BR ati (__drivermansuffix__),

-.BR chips (__drivermansuffix__),

-.BR cirrus (__drivermansuffix__),

-.BR cyrix (__drivermansuffix__),

-.BR fbdev (__drivermansuffix__),

-.BR glide (__drivermansuffix__),

-.BR glint (__drivermansuffix__),

-.BR i128 (__drivermansuffix__),

-.BR i740 (__drivermansuffix__),

-.BR imstt (__drivermansuffix__),

-.BR intel (__drivermansuffix__),

-.BR mga (__drivermansuffix__),

-.BR neomagic (__drivermansuffix__),

-.BR nv (__drivermansuffix__),

-.BR openchrome (__drivermansuffix__),

-.BR r128 (__drivermansuffix__),

-.BR radeon (__drivermansuffix__),

-.BR rendition (__drivermansuffix__),

-.BR savage (__drivermansuffix__),

-.BR s3virge (__drivermansuffix__),

-.BR siliconmotion (__drivermansuffix__),

-.BR sis (__drivermansuffix__),

-.BR sisusb (__drivermansuffix__),

-.BR sunbw2 (__drivermansuffix__),

-.BR suncg14 (__drivermansuffix__),

-.BR suncg3 (__drivermansuffix__),

-.BR suncg6 (__drivermansuffix__),

-.BR sunffb (__drivermansuffix__),

-.BR sunleo (__drivermansuffix__),

-.BR suntcx (__drivermansuffix__),

-.BR tdfx (__drivermansuffix__),

-.\" .BR tga (__drivermansuffix__),

-.BR trident (__drivermansuffix__),

-.BR tseng (__drivermansuffix__),

-.BR vesa (__drivermansuffix__),

-.BR vmware (__drivermansuffix__),

-.BR voodoo (__drivermansuffix__),

-.BR wsfb (__drivermansuffix__),

-.BR xgi (__drivermansuffix__),

-.BR xgixp (__drivermansuffix__).

-.PP

-Input drivers:

-.BR acecad (__drivermansuffix__),

-.BR citron (__drivermansuffix__),

-.BR elographics (__drivermansuffix__),

-.BR evdev (__drivermansuffix__),

-.BR fpit (__drivermansuffix__),

-.BR joystick (__drivermansuffix__),

-.BR kbd (__drivermansuffix__),

-.BR mousedrv (__drivermansuffix__),

-.BR mutouch (__drivermansuffix__),

-.BR penmount (__drivermansuffix__),

-.BR synaptics (__drivermansuffix__),

-.BR vmmouse (__drivermansuffix__),

-.BR void (__drivermansuffix__),

-.BR wacom (__drivermansuffix__).

-.PP

-Other modules and interfaces:

-.BR exa (__drivermansuffix__),

-.BR fbdevhw (__drivermansuffix__),

-.\" .BR shadowfb (__drivermansuffix__),

-.BR v4l (__drivermansuffix__).

-.br

-.SH AUTHORS

-This manual page was largely rewritten by David Dawes

-.IR <dawes@xfree86.org> .