$PAGER=more man 5 xorg.conf
xorg.conf(5) xorg.conf(5)
NAME
xorg.conf - configuration File for Xorg X server
INTRODUCTION
Xorg supports several mechanisms for supplying/obtaining configuration
and run-time parameters: command line options, environment variables,
the xorg.conf configuration file, 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 parame-
ters can be supplied via all methods. The available command line
options and environment variables (and some defaults) are described in
the Xserver(1) and Xorg(1) manual pages. Most configuration file
parameters, with their defaults, are described below. Driver and mod-
ule specific configuration parameters are described in the relevant
driver or module manual page.
DESCRIPTION
Xorg uses a configuration file called xorg.conf for its initial setup.
/see
...skipping
Boolean a boolean value (see below)
Frequency a frequency value (see below)
Note that all Option values, not just strings, must be enclosed in
quotes.
Boolean options may optionally have a value specified. When no value
is specified, the option's value is TRUE. The following boolean option
values are recognised as TRUE:
1, on, true, yes
and the following boolean option values are recognised as FALSE:
0, off, false, no
If an option name is prefixed with "No", then the option value is
negated.
Example: the following option entries are equivalent:
Option "Accel" "Off"
Option "NoAccel"
/
...skipping
server. Some of these paths can also be set from the command line (see
Xserver(1) and Xorg(1)). The command line settings override the values
specified in the config file. The Files section is optional, as are
all of the entries that may appear in it.
The entries that can appear in this section are:
FontPath "path"
sets the search path for fonts. This path is a comma separated
list of font path elements which the Xorg server searches for
font databases. Multiple 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:
Catalogue directories:
Catalogue directories can be specified using the prefix cat-
alogue: before the directory name. The directory can then be
populated with symlinks pointing to the real font directo-
ries, using the following syntax in the symlink name:
/
...skipping
"DPMS" option set (see the MONITOR section below).
Option "SuspendTime" "time"
sets the inactivity timeout for the suspend phase of DPMS mode.
time is in minutes, and the value can be changed at run-time
with xset(1). 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
"DPMS" option set (see the MONITOR section below).
Option "OffTime" "time"
sets the inactivity timeout for the off phase of DPMS mode.
time is in minutes, and the value can be changed at run-time
with xset(1). 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
"DPMS" option set (see the MONITOR section below).
Option "Pixmap" "bpp"
This sets the pixmap format to use for depth 24. Allowed values
for 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.
/
...skipping
To see what extension modules are available, check the extensions sub-
directory under:
/usr/lib/xorg/modules
The "extmod", "dbe", "dri", "dri2", "glx", and "record" extension mod-
ules are loaded automatically, if they are present, unless disabled
with "Disable" entries. It is recommended that at very least the
"extmod" extension module be loaded. If it isn't, some commonly used
server extensions (like the SHAPE extension) will not be available.
EXTENSIONS SECTION
The Extensions section is used to specify which X11 protocol extensions
should be enabled or disabled. The Extensions section is optional, as
are all of the entries that may be specified in it.
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 sec-
ond. The extension name is case-sensitive, and matches the form shown
in the output of "Xorg -extension ?".
Example: the MIT-SHM extension can be disabled with the follow-
ing entry:
/
...skipping
of these can be adjusted at runtime, see the xinput(1) man page for
details. Only the most important acceleration options are discussed
here.
Option "AccelerationProfile" "integer"
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 cur-
rent device velocity and acceleration controls) is constructed.
This is mainly a matter of personal preference.
0 classic (mostly compatible)
-1 none (only constant deceleration is applied)
1 device-dependent
2 polynomial (polynomial function)
3 smooth linear (soft knee, then linear)
4 simple (normal when slow, otherwise accelerated)
5 power (power function)
6 linear (more speed, more acceleration)
Option "ConstantDeceleration" "real"
Makes the pointer go deceleration times slower than normal. Most
useful for high-resolution devices.
/
...skipping
details, see the appropriate driver manual page.
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 Xorg server
probes the graphics board to determine this quantity. The
driver-specific documentation should indicate when it might be
needed.
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.
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-spe-
cific documentation recommends it.
IOBase baseaddress
/
...skipping
command line with the -weight option (see Xorg(1)).
Virtual xdim ydim
This optional entry specifies the virtual screen resolution to
be used. 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 Modes entry. Some drivers/hardware combina-
tions do not support virtual screens. Refer to the appropriate
driver-specific documentation for details.
ViewPort x0 y0
This optional entry sets the upper left corner of the initial
display. This is only relevant when the virtual screen resolu-
tion 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.
Modes "mode-name" ...
This optional entry specifies the list of video modes to use.
/
...skipping
also be specified from the command line (see the Xserver(1) man
page). The visual types available for depth 8 are (default is
PseudoColor):
StaticGray
GrayScale
StaticColor
PseudoColor
TrueColor
DirectColor
The visual type available for the depths 15, 16 and 24 are
(default is TrueColor):
TrueColor
DirectColor
Not all drivers support DirectColor at these depths.
The visual types available for the depth 4 are (default is Stat-
icColor):
StaticGray
/
Pattern not found