xfree86/man/xorg.conf.man

15 all parameters can be supplied via all methods. The available command
87 command line option (which may be absolute or relative),
133 command line option (which may be absolute or relative).
135 Finally, configuration files will also be searched for in a directory reserved
151 files are composed of a number of sections which may be present in any order,
190 section should be used instead.
206 They bind together the input and output devices that will be used in a session.
246 Note: hex integer values must be prefixed with \(lq0x\(rq, and octal values
251 may be used to provide free\-form data to various components of the server.
272 values, not just strings, must be enclosed in quotes.
324 When the unit name is omitted, the correct units will be determined from
326 It is recommended that the units always be specified when using frequency
332 Some of these paths can also be set from the command line (see
350 entries may be specified, and they will be concatenated to build up the
351 fontpath used by the server.  Font path elements can be absolute
359 Catalogue directories can be specified using the prefix \fBcatalogue:\fR
360 before the directory name. The directory can then be populated with
372 is an attribute which will be passed to the underlying FPE and
412 font path elements (which can be set inside a catalogue directory):
425 Font path elements that are found to be invalid are removed from the
435 entries may be specified, and they will be concatenated to build the
465 command line option can be used to override this.  The default directory is
483 section is optional, as are the entries that may be specified in it.
489 may be overridden by
554 that can be used to change the video modes.
564 drivers to not report failure if the mouse device can't be opened/initialised.
576 flag, and the value can be changed at run\-time with
585 is in minutes, and the value can be changed at run\-time with
588 This is only suitable for VESA DPMS compatible monitors, and may not be
599 is in minutes, and the value can be changed at run\-time with
602 This is only suitable for VESA DPMS compatible monitors, and may not be
613 is in minutes, and the value can be changed at run\-time with
616 This is only suitable for VESA DPMS compatible monitors, and may not be
662 If this option is disabled, then no devices will be added from the HAL or
666 If this option is disabled, then the devices will be added (and the
672 If this option is disabled, then no GPU devices will be added from the udev
673 backend. Enabled by default. (May need to be disabled to setup Xinerama).
686 section is used to specify which Xorg server modules should be loaded.
694 section is optional, as are all of the entries that may be specified in
697 Entries in this section may be in two forms.
705 The module name given should be the module's standard name, not the
711 Example: the DRI extension module can be loaded with the following entry:
726 instruction and the module is loaded. The module name given should be the
741 server extensions) can be loaded, with the XFree86\-DGA extension
772 that at very least the \(lqextmod\(rq extension module be loaded.
774 extension) will not be available.
778 section is used to specify which X11 protocol extensions should be enabled
782 section is optional, as are all of the entries that may be specified in
791 Example: the MIT-SHM extension can be disabled with the following entry:
816 driver will be ignored.
822 ones will be used. In the absence of an explicitly specified core input
867 will be loaded for each active
938 may be reattached or set floating at runtime.
942 input device will be bound to the area given in the matrix.  In most
953 these can be adjusted at runtime, see the xinput(1) man page for details. Only
983 Allows to actually decelerate the pointer when going slow. At most, it will be
1002 factor is a rational which, together with threshold, can be used to tweak
1059 entry will be enabled when using the loadable server.
1072 sections. The first allows various tokens to be matched against attributes
1073 of the device. An entry can be constructed to match attributes from different
1075 same type may be supplied to add multiple matching conditions on the same
1093 This entry can be used to check if the substring
1098 This entry can be used to check if the substring
1103 This entry can be used to check if the device file matches the
1108 This entry can be used to check if the operating system matches the
1116 The device's Plug and Play (PnP) ID can be checked against the
1121 The device's USB ID can be checked against the
1138 This entry can be used to check if tags assigned by the config backend
1203 This optional entry specifies that the device should be ignored entirely,
1204 and not added to the server. This can be useful when the device is handled
1205 by another program and no X events should be generated.
1248 entry will be enabled when using the loadable server.
1261 The following list of tokens can be matched against attributes of the device.
1262 An entry can be constructed to match attributes from different devices by
1271 .B  "    # kernel driver must be either foo or bar
1298 This option specifies that the matched device should be treated as the
1322 There must be at least one, for the video card being used.
1354 will be loaded for each active
1369 to be specified because the information is auto\-detected.
1374 listed here (but not the other entries) may be specified in the
1387 (e.g., \(lqPCI:1@0:0:0\(rq might be appropriate for an AGP card). The
1388 "@domain" part can be left out for PCI domain 0. This field is usually
1394 This information can usually be found by running the pciaccess tool
1410 Most drivers require that the primary screen (0) be present.
1438 This is not used by many drivers, and only needs to be specified when the
1446 The clocks are in MHz, and may be specified as a floating point number.
1452 lines may be specified, and each is concatenated to form the list.
1470 The driver-specific documentation should indicate when it might be needed.
1475 This entry is not used by many drivers, and it should only be specified if
1480 This entry is not used by many drivers, and it should only be specified if
1486 This can be used to override the auto-detection, but that should only be done
1491 This can be used to override the auto-detection, but that should only be done
1512 This optional entry allows an IRQ number to be specified.
1516 Option flags may be specified in the
1523 section, and they may also be included here.
1533 There should normally be at least one, for the monitor being used,
1534 but a default configuration will be created when one isn't specified.
1560 section may be used to provide information about the specifications of the
1565 With RandR 1.2-enabled drivers, monitor sections may be tied to specific
1595 The entries that may be used in
1609 may be a comma separated list of either discrete values or ranges of
1613 They may be specified in MHz or Hz
1621 This information should be available in the monitor's handbook.
1628 may be a comma separated list of either discrete values or ranges of
1632 They may be specified in MHz or kHz
1640 This information should be available in the monitor's handbook.
1652 This is an optional entry that can be used to specify the gamma correction
1654 It may be specified as either a single value or as three separate RGB values.
1655 The values should be in the range 0.1 to 10.0, and the default is 1.0.
1667 This is an optional multi-line entry that can be used to provide
1670 modes will be sufficient.
1681 is the dot (pixel) clock rate to be used for the mode.
1699 can be used to select the polarity of the HSync signal.
1703 can be used to select the polarity of the VSync signal.
1705 can be used to specify composite sync on hardware where this is supported.
1710 may be used to select the composite sync polarity.
1714 which the display enable signal is to be skewed.
1718 \(lqRoving\(rq horizontal lines indicate this value needs to be increased.
1720 this value should be decreased.
1735 entry, and it also can be used to specify video modes for the monitor.
1738 standard modes will be sufficient.
1774 can be used to select the polarity of the HSync signal.
1778 can be used to select the polarity of the VSync signal.
1780 can be used to specify composite sync on hardware where this is supported.
1785 may be used to select the composite sync polarity.
1792 entry description can also be used here.
1806 This optional entry specifies that the monitor should be treated as the primary
1810 This optional entry specifies a mode to be marked as the preferred initial mode
1815 This optional entry specifies modes to be marked as zoom modes.
1831 This optional entry specifies that the monitor should be positioned to the
1836 This optional entry specifies that the monitor should be positioned to the
1841 This optional entry specifies that the monitor should be positioned above the
1846 This optional entry specifies that the monitor should be positioned below the
1851 This optional entry specifies whether the monitor should be turned on
1860 that EDID will be available at all times, or if you have added custom modelines
1873 This optional entry specifies that the monitor should be ignored entirely,
1900 will be sufficient.
1931 There must be at least one, for the \(lqscreen\(rq being used.
1982 In multi\-head configurations, there will be multiple active
1991 section to be used for this screen.  When multiple graphics cards are
2003 section to be used as a secondary GPU device for this screen.  When multiple graphics cards are
2010 section in the config file. This can be specified up to 4 times for a single screen.
2013 specifies which monitor description is to be used for this screen.
2021 specifies an optional Xv video adaptor description to be used with this
2028 command line option can be used to override this.
2036 command line option can be used to override this.
2053 flags may be specified in the
2057 Others are driver\-independent, and will eventually be described here.
2058 .\" XXX These should really be in an xaa man page.
2062 This option is on by default, but it may be necessary to turn it off if
2072 use for the screen. This may be used to select an alternate implementation
2114 all the parameters that can be specified here fall back to their defaults.
2132 subsection is to be used for.
2133 This entry is usually specified, but it may be omitted to create a match\-all
2156 subsection is to be used for.
2160 In most cases this entry should not be used.
2163 This optional entry specifies the relative RGB weighting to be used
2166 This may also be specified from the command line with the
2172 This optional entry specifies the virtual screen resolution to be used.
2174 must be a multiple of either 8 or 16 for most drivers, and a multiple
2176 The given value will be rounded down if this is not the case.
2177 Video modes which are too large for the specified virtual size will be
2179 If this entry is not present, the virtual screen resolution will be set to
2190 If this entry is not given, then the initial display will be centered in
2197 specified must be in double quotes.
2203 The first valid mode in this list will be the default display mode for
2212 section will be used.  If the
2214 section contains no modes, then the selection will be taken from the
2219 This may also be specified from the command line (see the
2268 This optional entry allows the \(lqblack\(rq colour to be specified.
2273 This optional entry allows the \(lqwhite\(rq colour to be specified.
2278 Option flags may be specified in the
2285 section, and they may also be included here.
2349 options (described above) may be specified here, and ones given here
2354 The entries that may be used in this section are described here.
2357 One of these entries must be given for each screen being used in
2366 field is optional, and may be used to specify the screen number
2368 When this field is omitted, the screens will be numbered in the order that
2370 The numbering starts from 0, and must be consecutive.
2374 There are a number of different ways that this information can be provided:
2410 One of these entries should be given for each input device being used in
2425 fields may be specified, each in double quotes.
2426 The options permitted here are any that may also be given in the
2429 Normally only session\-specific input device options would be used here.
2441 and the first two should normally be used to indicate the core pointer
2456 section may also be specified here.
2475 At present, only PCI devices can be isolated in this manner.
2502 Details about the format of this section can be found on-line at
2507 section may be used to provide vendor\-specific configuration information.
2510 sections may be present, and they may contain an