linux多屏配置文件 xorg.conf 官方配置文件说明翻译

xorg.conf(原文地址点击此处)

名字

xorg.conf,xorg.conf.d 是 Xorg X server 的配置文件

介绍

Xorg支持几种提供或获取配置和运行时参数的机制：命令行选项，环境变量，xorg.conf和xorg.conf.d配置文件，自动检测和回退到默认值。当以多于一种方式提供相同信息时，使用最高优先级机制。机制列表从最高优先级到最低优先级排序。请注意，并非所有参数都可通过所有参数都可通过所有方法提供。可用的命令行选项和环境变量（以及一些默认值）在Xserver 和 Xorg 手册中有介绍。大多数配置文件参数以及默认值如下所述。驱动程序和模块特定的配置参数在相关的驱动程序或模块手册页中描述。

描述

Xorg使用一个名为xorg.conf的配置文件和以xorg.conf.d目录中的.conf结尾的文件进行初始设置。当服务器作为普通用户启动时，将在以下位置搜索xorg.conf配置文件：

/etc/X11/
/usr/etc/X11/
/etc/X11/$XORGCONFIG
/usr/etc/X11/$XORGCONFIG
/etc/X11/xorg.conf
/etc/xorg.conf
/usr/etc/X11/xorg.conf.
/usr/etc/X11/xorg.conf
/usr/lib/X11/xorg.conf.
/usr/lib/X11/xorg.conf

其中是使用-config参数的相对路径（不含 ".." 的路径），$ XORGCONFIG是该环境变量指定的相对路径（不含 ".." 的路径），是 gethostname 报告的计算机的主机名。

当Xorg服务器由 root 用户启动时，配置文件搜索位置如下：


/etc/X11/
/usr/etc/X11/
$XORGCONFIG
/etc/X11/$XORGCONFIG
/usr/etc/X11/$XORGCONFIG
/etc/X11/xorg.conf
/etc/xorg.conf
/usr/etc/X11/xorg.conf.
/usr/etc/X11/xorg.conf
/usr/lib/X11/xorg.conf.
/usr/lib/X11/xorg.conf

其中是使用-config命令行选项（可以是绝对或相对）指定的路径，$ XORGCONFIG是由该环境变量（绝对或相对）指定的路径，$ HOME是由该环境变量指定的路径（通常为主目录），是 gethostname 报告的计算机主机名。

当服务器作为普通用户启动时，在以下目录中搜索其他配置文件：

/etc/X11/
/usr/etc/X11/
/etc/X11/xorg.conf.d
/usr/etc/X11/xorg.conf.d

其中是使用-configdir参数指定的相对路径（不含 ".." 的路径）。

当Xorg服务器由“root”用户启动时，配置文件夹搜索位置如下：


/etc/X11/
/usr/etc/X11/
/etc/X11/xorg.conf.d
/usr/etc/X11/xorg.conf.d

其中是使用-configdir参数指定的路径（可以是绝对或相对）。

最后，还将在为系统使用保留的目录中搜索配置文件。 这是为了将本地配置和第三方配置分离开来。这些文件位于以下目录中：

/usr/share/X11/xorg.conf.d
/usr/share/X11/xorg.conf.d

xorg.conf和xorg.conf.d文件由许多段组成，这些段可以按任何顺序存在，或者省略使用默认配置值。每个部分具有以下形式：

Section "SectionName"
SectionEntry
...
EndSection


这些段的名称是：

Files 文件路径名
ServerFlags 服务器标志
Module 动态模块加载
Extensions 扩展启用
InputDevice 输入设备描述
InputClass 输入类描述
Device 图形设备描述
VideoAdaptor Xv视频适配器描述
Monitor 监视器描述
Modes 视频模式说明
Screen 屏幕配置
ServerLayout 整体布局
DRI DRI特定配置
Vendor 供应商特定的配置

为了兼容性目的，仍然识别以下过时的段名称。在新的配置文件中，应该使用InputDevice部分。

Keyboard 键盘配置
Pointer 指针或鼠标配置

旧的XInput部分不再被识别。

ServerLayout 部分位于最高级别。它们将把一次会话中使用到的输入和输出设备绑定在一起。 输入设备在 InputDevice sections 中描述。输出设备通常由多个独立的组件（例如，图形板和监视器）组成。 这些多个组件在 Screen sections 中绑定在一起，这些是由ServerLayout 部分引用的。 每个 Screen sections 将图形板和显示器绑定在一起。图形板在 Device sections 进行了说明，监视器在 Monitor sections 进行了说明。

配置文件关键字不区分大小写，忽略“_”字符。 大多数字符串（包括选项名称）也不区分大小写，对空格和“_”字符不敏感。

每个配置文件条目通常占用文件中的一行。 它们由一个关键字组成，可能后跟一个或多个参数，参数的数量和类型取决于关键字。参数类型有：

Integer 十进制，十六进制或八进制的整数
Real 一个浮点数
String 用双引号括起来的字符串

注意：十六进制整数值必须以“0x”开头，八进制值以“0”开头。

可以使用称为Option的特殊关键字向服务器的各种组件提供自由形式的数据。Option关键字需要一个或两个字符串参数。 第一个是选项名称，可选的第二个参数是选项值。 一些常用的选项值类型包括：

Integer 十进制，十六进制或八进制的整数
Real 一个浮点数
String 一个字符序列
Boolean 布尔值（见下文）
Frequency 一个频率值（见下文）

请注意，所有Option值，而不仅仅是字符串，必须用引号括起来。

布尔选项可以可选地具有指定的值。当未指定值时，选项的值为TRUE。 以下布尔选项值被识别为TRUE：

1, on, true, yes

并且以下布尔选项值被识别为FALSE：

0, off, false, no

如果选项名称前缀为“No”，则选项值被否定。

示例：以下选项条目是等效的：

Option "Accel" "Off"
Option "NoAccel"
Option "NoAccel" "On"
Option "Accel" "false"
Option "Accel" "no"

频率选项值由一个实数组成，可选地后跟以下频率单位之一：

Hz, k, kHz, M, MHz

当省略单位名称时，将根据该值和该值的适当范围的期望确定正确的单位。建议在使用频率选项值时始终指定单位，以避免在确定值时出现任何错误。

FILE SECTION

File section用于指定服务器所需的一些路径名称。其中一些路径也可以从命令行设置（参见 Xserver 和 Xorg ）。 命令行设置将覆盖配置文件中指定的值。File section是可选的，以及可能出现在其中的所有条目。

可在此部分中显示的条目是：

FontPath "path"

设置字体的搜索路径。此路径是字体路径元素的逗号分隔列表，Xorg服务器会搜索字体数据库。 可以指定多个 FontPath 条目，并且它们将被连接以构建服务器使用的字体路径。字体路径元素可以是绝对目录路径，目录目录或字体服务器标识符。 后两种的格式解释如下：

Catalogue directories:

可以使用前缀目录指定 catalogue directories：然后可以使用指向真实字体目录的符号链接填充目录，在符号链接名称中使用以下语法：

:[attribute]:pri=

其中是字母数字标识符，[attribute]是将传递到底层FPE的属性，是用于对字体文件FPE进行排序的数字。 例子：

75dpi:unscaled:pri=20 -> /usr/share/X11/fonts/75dpi
gscript:pri=60 -> /usr/share/fonts/default/ghostscript
misc:unscaled:pri=10 −> /usr/share/X11/fonts/misc

字体服务器标识符：

字体服务器标识符的格式如下：

/:

其中是用于连接到字体服务器的传输类型（例如，用于UNIX域套接字的unix或用于TCP / IP连接的tcp），是运行字体服务器的机器的主机名， 是字体服务器正在侦听的端口号（通常为7100）。

当未在配置文件中指定此条目时，服务器将回退到编译的默认字体路径，其中包含以下字体路径元素（可以在目录目录中设置）：

/usr/share/fonts/X11/misc/
/usr/share/fonts/X11/TTF/
/usr/share/fonts/X11/OTF/
/usr/share/fonts/X11/Type1/
/usr/share/fonts/X11/100dpi/
/usr/share/fonts/X11/75dpi/

发现无效的字体路径元素将在服务器启动时从字体路径中删除。

ModulePath "path"

设置可加载Xorg服务器模块的搜索路径。 此路径是逗号分隔的目录列表，Xorg服务器按照指定的顺序搜索可加载模块加载。 可以指定多个ModulePath条目，并且它们将被连接以构建服务器使用的模块搜索路径。 默认模块路径为

/usr/lib/xorg/modules

XkbDir "path"

设置键盘布局文件的基本目录。 -xkbdir命令行选项可以用于覆盖此选项。 默认目录为

/usr/share/X11/xkb

SERFLAGS SECTION

除了本节（下面描述）特有的选项外，ServerFlags 部分用于指定一些全局Xorg服务器选项。 本节中的entries都是Options，但为了兼容性目的，仍然可以识别某些旧样式条目。 那些旧样式条目在这里没有记录，并且不鼓励使用它们。 ServerFlags section是可选的，可以在其中指定的条目。

本节中指定的Options（“DefaultServerLayout” Option除外）可能会被活动ServerLayouts section中指定的Options覆盖。 使用命令行等效项的选项将被覆盖。 本 section 认可的选项有：

Option "DefaultServerLayout" "layout−id"

这指定在缺少-layout命令行选项时使用的默认ServerLayout部分。

Option "NoTrapSignals" "boolean"

这防止Xorg服务器捕获一系列意外的致命信号并干净地退出。否则，Xorg服务器将死机并且丢弃发生故障的核心。默认行为是Xorg服务器完全退出，但仍然放置一个核心文件。一般来说，除非您正在调试Xorg服务器问题并知道如何处理后果，否则不要使用此选项。

Option "UseSIGIO" "boolean"

这控制Xorg服务器是否请求通过SIGIO信号处理程序（在某些平台上也称为SIGPOLL）报告来自输入设备的事件，或仅通过标准select（3）循环进行报告。默认行为是特定于平台的。通常，您不想使用此选项，除非您正在调试Xorg服务器，或解决特定的错误，直到它被修复，并了解后果。

Option "DontVTSwitch" "boolean"

这不允许使用Ctrl + Alt + Fn序列（其中Fn表示编号的功能键之一）。该序列通常用于切换到具有此功能的操作系统上的另一个“虚拟终端”。启用此选项时，该键序列没有特殊含义，并传递给客户端。默认值：关闭。

Option "DontZap" "boolean"

这不允许使用Terminate_Server XKB操作（通常在Ctrl + Alt + Backspace，取决于XKB选项）。此操作通常用于终止Xorg服务器。启用此选项时，操作不起作用。默认值：关闭。

Option "DontZoom" "boolean"

这不允许使用Ctrl + Alt + Keypad-Plus和Ctrl + Alt + Keypad-Minus序列。这些序列允许您在视频模式之间切换。启用此选项时，这些键序列没有特殊含义，并传递到客户端。默认值：关闭。

Option "DisableVidModeExtension" "boolean"

这将禁用xvidtune客户端使用的VidMode扩展的可用于更改视频模式的部分。默认值：启用VidMode扩展。

Option "AllowNonLocalXvidtune" "boolean"

这允许xvidtune客户端（和使用VidMode扩展的其他客户端）从另一个主机连接。默认值：关闭。

Option "AllowMouseOpenFail" "boolean"

这告诉mousedrv（4）和vmmouse（4）驱动程序不报告故障，如果鼠标设备无法打开/初始化。它对evdev（4）或其他驱动程序没有影响。默认值：false。

Option "BlankTime" "time"

设置屏幕保护程序的空白阶段的不活动超时。时间以分钟为单位。这相当于Xorg服务器的-s标志，并且可以在运行时使用xset（1）更改该值。默认值：10分钟。

Option "StandbyTime" "time"

设置DPMS模式的待机阶段的不活动超时。时间以分钟为单位，并且该值可以在运行时使用xset（1）更改。默认值：10分钟。这仅适用于VESA DPMS兼容的显示器，并且可能不受所有视频驱动程序的支持。它仅对具有“DPMS”选项设置的屏幕启用（请参见下面的MONITOR部分）。

Option "SuspendTime" "time"

设置DPMS模式的暂停阶段的不活动超时。时间以分钟为单位，并且该值可以在运行时使用xset（1）更改。默认值：10分钟。这仅适用于VESA DPMS兼容的显示器，并且可能不受所有视频驱动程序的支持。它仅对具有“DPMS”选项设置的屏幕启用（请参见下面的MONITOR部分）。

Option "OffTime" "time"

设置DPMS模式的关闭阶段的不活动超时。时间以分钟为单位，并且该值可以在运行时使用xset（1）更改。默认值：10分钟。这仅适用于VESA DPMS兼容的显示器，并且可能不受所有视频驱动程序的支持。它仅对具有“DPMS”选项设置的屏幕启用（请参见下面的MONITOR部分）。

Option "Pixmap" "bpp"

这将设置pixmap格式以用于深度24. bpp的允许值为24和32.默认值：32，除非驱动程序约束不允许这种情况（这是罕见的）。注意：当此值设置为24时，会导致某些客户端行为不正常。

Option "NoPM" "boolean"

禁用与电源管理事件有关的功能。默认值：在支持它的平台上启用PM。

Option "Xinerama" "boolean"

启用或禁用XINERAMA扩展。默认为禁用。

Option "AIGLX" "boolean"

启用或禁用AIGLX。默认情况下启用AIGLX。

Option "DRI2" "boolean"

启用或禁用DRI2。默认情况下禁用DRI2。

Option "GlxVisuals" "string"

此选项控制GLX模块设置的GLX视图的数量。默认值是典型值，它将建立GLXFBConfigs的典型子集，由驱动程序提供为GLX视觉效果。其他选项是最小的，它将设置GLX规范允许的最小集合，所有这些都将为所有GLXFBConfig设置GLX视觉效果。

Option "UseDefaultFontPath" "boolean"

包括默认字体路径，即使在xorg.conf中指定了其他路径。 如果启用，则也包括其他字体路径。 默认情况下启用。

Option "IgnoreABI" "boolean"

允许加载为不同的，可能不兼容的X服务器版本构建的模块。 默认情况下禁用。

Option "AutoAddDevices" "boolean"

如果禁用此选项，则不会从HAL或udev后端添加任何设备。 默认情况下启用。

Option "AutoEnableDevices" "boolean"

如果禁用此选项，则将添加设备（并发送DevicePresenceNotify事件），但不启用，从而将策略留给客户端。 默认情况下启用。

Option "Log" "string"

此选项控制在每条消息后日志是否刷新和/或同步到磁盘。 可能的值为flush或sync。 默认情况下取消设置。

MODULE SECTION

Module section用于指定应加载哪些Xorg服务器模块。 当Xorg服务器以静态形式构建时，将忽略此部分。 通常在此部分加载的模块类型是Xorg服务器扩展模块。 大多数其他模块类型在通过其他机制需要时自动加载。 Module section是可选的，可以在其中指定的所有条目也是可选的。

本section中的条目可能有两种形式。 第一种也是最常用的形式是使用Load关键字的条目，如下所述：

Load "modulename"

这将指示服务器加载称为模块名称的模块。 提供的模块名称应该是模块的标准名称，而不是模块文件名称。 标准名称区分大小写，不包括“lib”前缀，或“.a”，“.o”或“.so”后缀。

示例：可以使用以下条目加载DRI扩展模块：

Load "dri"

Disable "modulename"

这指示服务器不加载称为模块名称的模块。 默认情况下，在服务器中加载一些模块，这将覆盖默认值。 如果给同一模块一个Load指令，它将覆盖Disable指令，并且加载模块。 提供的模块名称应该是模块的标准名称，而不是模块文件名称。 与Load指令一样，标准名称区分大小写，不包括“lib”前缀或“.a”，“.o”或“.so”后缀。

第二种形式的子条目是 SubSection，其子部分名称是模块名称，SubSection 的内容是在加载模块时传递给它的 Options。

示例：可以加载extmod模块（其中包含其他一组服务器扩展），通过使用以下条目禁用XFree86-DGA扩展：

SubSection "extmod"
Option "omit XFree86−DGA"
EndSubSection

在ModulePath搜索路径中指定的每个目录中以及每个目录的驱动程序，扩展，输入，内部和多媒体子目录中搜索模块。 除此之外，首先搜索所有上述操作系统特定的子目录（如果存在的话）。

要查看可用的扩展模块，请检查以下扩展子目录：

/usr/lib/xorg/modules

除非使用“禁用”条目禁用，否则“extmod”，“dbe”，“dri”，“dri2”，“glx”和“record”扩展模块将自动加载。 建议至少要加载“extmod”扩展模块。 如果不是，一些常用的服务器扩展（如SHAPE扩展）将不可用。

EXTENSIONS SECTION

Extensions section 用于指定应启用或禁用哪些X11协议扩展。Extensions section是可选的，可以在其中指定的所有条目也是可选的。

本节中的条目作为Option语句列出，扩展名称为第一个参数，布尔值为第二个参数。 扩展名名称区分大小写，并且匹配“Xorg -extension？”输出中显示的形式。

示例：可以使用以下条目禁用MIT-SHM扩展：

Section "Extensions"
Option "MIT-SHM" "Disable"
EndSection

INPUTDEVICE SECTION

配置文件可能有多个InputDevice sections。 最近的X服务器使用HAL或udev后端进行输入设备枚举和输入热插拔。 如果正在使用热插拔（即启用AutoAddDevices），通常不需要在xorg.conf中提供InputDevice section。 如果启用热插拔，则使用鼠标，kbd和vmmouse驱动程序的InputDevice section将被忽略。

如果禁用热插拔，通常至少有两个：一个用于核心（主）键盘，一个用于核心指针。 如果缺少这两个缺省配置，将使用缺少的缺省配置。 在没有明确指定的核心输入设备的情况下，使用标记为CorePointer（或CoreKeyboard）的第一个InputDevice。 如果没有匹配，则使用使用“鼠标”（或“kbd”）驱动程序的第一个InputDevice。 最后的备用是使用内置的默认配置。 当前，默认配置可能无法按预期在所有平台上工作。

InputDevice 部分具有以下格式：

Section "InputDevice"
Identifier "name"
Driver "inputdriver"
options
...
EndSection

在所有InputDevice section 中都需要Identifier 和Driver entries。 所有其他entries是可选的。

Identifier entry指定此输入设备的唯一名称。 Driver entry指定要用于此输入设备的驱动程序的名称。 当使用可加载服务器时，将为每个激活的InputDevice section加载输入驱动程序模块“inputdriver”。 如果一个输入设备部分被一个活动的ServerLayout section引用（如果它被-keyboard或-pointer命令行选项引用），或者如果它被隐式选择为核心指针或键盘设备而没有这样的显式 参考。 最常用的输入驱动程序是Linux系统上的evdev（4），其他平台上的kbd（4）和mousedrv（4）。

InputDevice section识别一些独立于驱动程序的Options，这里描述。 有关设备特定选项的说明，请参见各个输入驱动程序手册页。

Option "AutoServerLayout" "boolean"

始终将设备添加到此服务器实例使用的ServerLayout section。 这会影响隐式布局以及在配置和/或命令行中指定的显式布局。

Option "CorePointer"

已弃用，请参阅Floating

Option "CoreKeyboard"

已弃用，请参阅Floating

Option "AlwaysCore" "boolean"
已弃用，请参阅Floating

Option "SendCoreEvents" "boolean"

已弃用，请参阅Floating

Option "Floating" "boolean"

启用时，输入设备设置为浮动，并且不通过任何主设备报告事件或控制光标。 该设备仅适用于使用X输入扩展API的客户端。 默认情况下禁用此选项。 选项CorePointer，CoreKeyboard，AlwaysCore和SendCoreEvents是选项Floating的反向（即SendCoreEvents“on”等效于Floating“off”）。

此选项仅控制启动行为，设备可能在运行时重新连接或设置为浮动。

Option "TransformationMatrix" "a b c d e f g h i"

为绝对输入设备指定3x3变换矩阵。 输入设备将绑定到矩阵中给定的区域。 在大多数配置中，“a”和“e”指定设备所绑定的区域的宽度和高度，“c”和“f”指定区域的x和y偏移。 值范围是0到1，其中1表示所有根窗口的宽度或高度在一起，0.5表示一半的面积等。值表示3×3矩阵，第一，第二和第三组三个值表示第一 ，第二和第三行。 单位矩阵为“1 0 0 0 1 0 0 0 1”。

POINTER ACCELERATION

对于定点设备，以下选项控制指针相对于物理设备运动如何加速或减速。 大多数这些可以在运行时调整，有关详细信息，请参阅xinput（1）手册页。 这里只讨论最重要的加速度选项。

Option "AccelerationProfile" "integer"

选择配置文件。在外行人的术语中，轮廓构成加速度的“感觉”。更正式地，其定义如何构造传递函数（作为当前装置速度和加速度控制的函数的实际加速度）。这主要是个人喜好的问题。

0经典（大部分兼容）
-1无（仅应用恒定减速度）
1设备相关
2多项式（多项式函数）
3.平滑线性（软拐，然后线性）
4简单（正常时慢，否则加速）
5电源（电源功能）
6线性（速度更快，加速更快）
7有限（如线性，但最大在阈值）

Option "ConstantDeceleration" "real"

使指针变慢减速比正常。最适用于高分辨率设备。

Option "AdaptiveDeceleration" "real"

允许在慢速时实际减速指针。至多，自适应减速时间会更慢。启用精确的指针放置，而不牺牲速度。

Option "AccelerationScheme" "string"

选择方案，它是基础算法。

可预测的默认算法（行为更可预测）
轻量级旧加速代码（如X协议规范中所指定）
无加速或减速

Option "AccelerationNumerator" "integer"
Option "AccelerationDenominator" "integer"

设置加速因子的分子和分母。加速因子是一个合理的，连同阈值，可以用于调整配置文件以适应用户的需要。简单和有限的轮廓直接使用它（即它们加速因子），对于其它轮廓，应该保持较高的加速因子导致更快的指针。通常，1是未加速的，值高达5是明智的。

Option "AccelerationThreshold" "integer"

设置阈值，大致为加速生效所需的速度（通常为每10 ms的设备单位）。然而，精确的效果随轮廓而变化。

INPUTCLASS SECTION

配置文件可能有多个InputClass sections。 这些sections是可选的，用于为自动添加的输入设备类提供配置。 输入设备可以匹配多个InputClass section。 每个类都可以覆盖上一个类的设置，因此最好先排列最通用的匹配部分。

InputClass节具有以下格式：

Section "InputClass"
Identifier "name"
entries
...
options
...
EndSection

Identifier entry在所有InputClass sections中是必需的。 所有其他entries是可选的。

Identifier entry指定此输入类的唯一名称。 Driver entry指定要用于此输入设备的驱动程序的名称。 在检查所有类之后，当使用可加载服务器时，将启用第一个驱动程序条目中的“inputdriver”模块。

当自动添加输入设备时，将针对所有InputClass sections检查其特性。 每个节可以包含可选条目以缩小类的匹配。 如果没有可选条目出现，InputClass section是通用的，并且将匹配任何输入设备。 如果显示多个条目，它们必须匹配要应用的配置。

在InputClass sections中使用了两种类型的匹配条目。 第一种允许各种令牌与设备的属性匹配。 可以通过使用“|”字符分隔参数来构造条目以匹配来自不同设备的属性。 可以提供相同类型的多个条目以在相同属性上添加多个匹配条件。 例如：

Section "InputClass"
Identifier "My Class"
# product string must contain example and
# either gizmo or gadget
MatchProduct "example"
MatchProduct "gizmo|gadget"
...
EndSection

MatchProduct "matchproduct"

此条目可用于检查设备的产品名称中是否出现子字符串“matchproduct”。

MatchVendor "matchvendor"

此条目可用于检查子串“matchvendor”是否出现在设备的供应商名称中。

MatchDevicePath "matchdevice"

此条目可用于检查设备文件是否与“matchdevice”路径名模式匹配。

MatchOS "matchos"

此条目可用于检查操作系统是否与不区分大小写的“matchos”字符串匹配。此条目仅在提供uname（2）系统调用的平台上受支持。

MatchPnPID "matchpnp"

可以根据“matchpnp”shell通配符模式检查设备的即插即用（PnP）ID。

MatchUSBID "matchusb"

可以针对“matchusb”shell通配符模式检查设备的USB ID。 ID由小写的十六进制数字构成，用“：”分隔。这是与lsusb（8）程序相同的格式。

MatchDriver "matchdriver"

根据当前配置的设备驱动程序检查区分大小写的字符串“matchdriver”。使用此条目对节进行排序很重要，因为除非驱动程序已由配置后端或先前的InputClass部分设置，否则不会匹配。

MatchTag "matchtag"

此条目可用于检查由配置后端分配的标记是否与“matchtag”模式匹配。如果在“matchtag”中给出的标签中的至少一个与由后端分配的标签中的至少一个匹配，则找到匹配。

MatchLayout "matchlayout"

针对当前活动的ServerLayout部分检查区分大小写的字符串“matchlayout”。空字符串“”匹配隐式布局，如果未找到命名的ServerLayout部分，则显示该布局。

第二种类型的条目用于匹配设备类型。 这些条目采用类似于Option entries的布尔参数。

MatchIsKeyboard "bool"
MatchIsPointer "bool"
MatchIsJoystick "bool"
MatchIsTablet "bool"
MatchIsTouchpad "bool"
MatchIsTouchscreen "bool"

当输入设备已与InputClass section匹配时，将向设备应用任何Option entries。 识别一个特定于InputClass的Option。 有关其余Option entries的描述，请参见上面的InputDevice section。

Option "Ignore" "boolean"

此可选条目指定应该完全忽略设备，而不将其添加到服务器。 当设备由另一个程序处理并且不应生成X事件时，这可能很有用。

DEVICE SECTION

配置文件可能有多个Device sections。 必须至少有一个，正在使用的视频卡。

Device sections具有以下格式：

Section "Device"
Identifier "name"
Driver "driver"
entries
...
EndSection

在所有Device sections中都需要 Identifier 和Driver entries。所有其他条目是可选的。

Identifier entry指定此图形设备的唯一名称。Driver entry 指定要用于此图形设备的驱动程序的名称。当使用可加载服务器时，将为每个活动的Device section加载驱动程序模块“驱动程序”。Device section 将会被认为是活动的当它引用了一个活动的Screen section。

BusID "bus−id"

这指定了显卡的总线位置。对于PCI / AGP卡，总线ID字符串的格式为PCI：bus：device：function（例如，“PCI：1：0：0”可能适用于AGP卡）。在使用主显卡时，此字段在单头配置中通常是可选的。在多头配置中，或在单头配置中使用辅助显卡时，此条目是必需的。它的主要目的是在设备部分和它所代表的硬件之间建立一个明确的连接。通常可以通过运行pciaccess工具scanpci找到此信息。


Screen number

该选项对于其中单个PCI实体可以驱动多于一个显示器（即，多个CRTC共享单个图形加速器和视频存储器）的卡是强制的。每个head需要一个Device section，此参数确定每个Device section适用于哪个head。数字的合法值从0到1小于每个entity的head总数。大多数驱动程序要求主屏幕（0）存在。

Chipset "chipset"

这个通常可选的条目指定在图形卡上使用的芯片组。 在大多数情况下，不需要此条目，因为驱动程序将探测硬件以确定芯片组类型。 不要指定它，除非驱动程序特定的文档建议您这样做。

Ramdac "ramdac−type"

此可选条目指定在图形卡上使用的RAMDAC的类型。 这只是由几个驱动程序使用，在大多数情况下不是必需的，因为驱动程序将探测硬件以确定RAMDAC类型尽可能。 不要指定它，除非驱动程序特定的文档建议您这样做。

DacSpeed speed
DacSpeed speed−8 speed−16 speed−24 speed−32

此可选条目指定RAMDAC速度等级（通常打印在RAMDAC芯片上）。 速度以MHz为单位。 当给定一个值时，它适用于所有帧缓冲器像素大小。 当给定多个值时，它们分别适用于帧缓冲器像素大小8,16,24和32。 这不是许多驱动程序使用的，只需要在RAMDAC的速度等级不同于驱动程序中内置的默认值时，或者当驱动程序无法自动检测正确的默认值时，才需要指定。 不要指定它，除非驱动程序特定的文档建议您这样做。

Clocks clock ...

指定图形板上的像素。 时钟以MHz为单位，可以指定为浮点数。 该值在内部存储到最近的kHz。 时钟的排序很重要。 它必须与在图形卡上选择它们的顺序相匹配。 可以指定多个时钟线，并且每个线连接以形成列表。 大多数驱动程序不使用此条目，并且只需要一些具有不可编程时钟的旧版本。 除非驱动程序特定的文档明确建议您这样做，否则不要指定此条目。

ClockChip "clockchip−type"

此可选条目用于在具有可编程时钟发生器的图形卡上指定时钟芯片类型。 只有少数Xorg驱动程序支持可编程时钟芯片。 有关详细信息，请参阅相应的驱动程序手册页。

VideoRam mem

此可选条目指定安装在图形卡上的视频RAM的大小。 这是以kBytes为单位。 在大多数情况下，这不是必需的，因为Xorg服务器探测图形卡以确定此数量。 特定于驱动程序的文档应指明何时可能需要。

BiosBase baseaddress

此可选条目指定VGA板的视频BIOS的基址。 此地址通常是自动检测的，并且只有在特定驱动程序的文档推荐时才能指定。

MemBase baseaddress

此可选条目指定图形卡线性帧缓冲区的内存基址。 许多驱动程序不使用此条目，并且只有在特定于驱动程序的文档建议的情况下才应指定此条目。

IOBase baseaddress

此可选条目指定IO基址。 许多驱动程序不使用此条目，并且只有在特定于驱动程序的文档建议的情况下才应指定此条目。

ChipID id

此可选条目指定表示芯片类型的数字ID。 对于PCI卡，通常是设备ID。 这可以用于覆盖自动检测，但只应在特定于驱动程序的文档建议时进行。

ChipRev rev

此可选条目指定芯片修订号。 这可以用于覆盖自动检测，但只应在特定于驱动程序的文档建议时进行。

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.

Option "ModeDebug" "boolean"

此可选条目指定用于常规文本模式的像素时钟频率。 频率以MHz为单位指定。 这很少使用。

Options

可以在Device sections中指定选项标志。 这些包括驱动程序特定的选项和驱动程序独立的选项。 前者在驱动程序特定的文档中描述。 后面的一些在下面关于Screen section的部分中描述，并且它们也可以包括在这里。

VIDEOADAPTOR SECTION

没有人想说如何工作。 也许没有人知道...

MONITOR SECTION

配置文件可能有多个Monitor sections。 通常应该至少有一个，对于正在使用的监视器，但将在未指定默认配置时创建默认配置。

Monitor sections具有以下格式：

Section "Monitor"
Identifier "name"
entries
...
EndSection

Monitor section中唯一必需的条目是Identifier entry.。

Identifier entry指定此监视器的唯一名称。  Monitor section可以用于提供关于监视器规格，监视器特定选项和关于与监视器一起使用的视频模式的信息的信息。

使用启用了RandR 1.2的驱动程序，monitor sections可以绑定到视频卡的特定输出。 使用视频驱动程序定义的输出名称加上monitor sections的标识符，可以通过以下列格式向Device section添加选项来将monitor section与输出相关联：

Option "Monitor-outputname" "monitorsection"

（例如，选项“Monitor-VGA”“VGA显示器”用于VGA输出）

在没有monitor sections与输出的特定关联的情况下，如果存在monitor sections，则服务器将其与输出相关联以保持对于先前的single-head配置的兼容性。

指定视频模式是可选的，因为服务器将使用监视器提供的DDC或其他信息自动配置可用模式列表。 当在monitor sections（使用Mode，ModeLine或UseModes关键字）中显式指定模式时，不包括具有相同名称的内置模式。 然而，当它们满足监视器的要求时，仍然隐含地包括具有不同名称的内置模式。

可在Monitor sections中使用的entries如下所述。

VendorName "vendor"

此可选条目指定显示器的制造商。

ModelName "model"

此可选条目指定监视器的型号。

HorizSync horizsync−range

给出了监视器支持的水平同步频率的范围。 horizsync-range可以是离散值或值范围的逗号分隔列表。 值的范围是由短划线分隔的两个值。 默认情况下，值的单位为kHz。 如果将MHz或Hz添加到线路的末尾，它们可以指定为MHz或Hz。 此处提供的数据由Xorg服务器用于确定视频模式是否在监视器的规格范围内。 此信息应显示在显示器的手册中。 如果省略此条目，则使用28-33kHz的默认范围。

VertRefresh vertrefresh−range

给出了监视器支持的垂直刷新频率的范围。 vertrefresh-range可以是离散值或值范围的逗号分隔列表。 值的范围是由短划线分隔的两个值。 默认情况下，值的单位为Hz。 如果将MHz或kHz添加到线路的末尾，它们可以指定为MHz或kHz。 此处提供的数据由Xorg服务器用于确定视频模式是否在监视器的规格范围内。 此信息应显示在显示器的手册中。 如果省略此项，则使用默认范围43-72Hz。

DisplaySize width height

此可选条目给出了显示器图像区域的宽度和高度（以毫米为单位）。 如果给定这用于计算屏幕的水平和垂直间距（DPI）。

Gamma gamma−value
Gamma red−gamma green−gamma blue−gamma

这是一个可选项，可用于指定显示器的伽马校正。 它可以被指定为单个值或三个单独的RGB值。 值应在0.1到10.0的范围内，默认值为1.0。 并非所有驱动程序都能够使用此信息。

UseModes "modesection−id"

包括模式部分中列出的一组模式，称为modesection-id。 这使得该部分中定义的所有模式都可供此监视器使用。

Mode "name"

这是一个可选的多行条目，可用于为监视器的视频模式提供定义。 在大多数情况下，这不是必需的，因为内置的VESA标准模式集就足够了。 Mode关键字指示多行视频模式描述的开始。 模式描述以EndMode关键字结束。 模式描述包括以下条目：

DotClock clock

是要用于该模式的点（像素）时钟速率。

HTimings hdisp hsyncstart hsyncend htotal

指定模式的水平时序。

VTimings vdisp vsyncstart vsyncend vtotal

指定模式的垂直定时。

Flags "flag" ...

指定一组可选的模式标志，每个标志都是双引号中的单独字符串。 “隔行”表示模式是隔行扫描。 “DoubleScan”表示其中每个扫描线被加倍的模式。 “+ HSync”和“-HSync”可用于选择HSync信号的极性。 “+ VSync”和“-VSync”可以用于选择VSync信号的极性。 “Composite”可用于在支持此功能的硬件上指定复合同步。 另外，在一些硬件上，“+ CSync”和“-CSync”可以用于选择复合同步极性。

HSkew hskew

指定显示使能信号将被歪斜的像素的数量（朝向屏幕的右边缘）。 并非所有驱动程序都使用此信息。 此选项可能需要覆盖服务器提供的默认值（如果有）。 “Roving”水平线表示该值需要增加。 如果扫描线上的最后几个像素出现在屏幕的左侧，则该值应该减小。

VScan vscan

指定每个扫描线在屏幕上绘制的次数。 并非所有驱动程序都使用此信息。 小于1的值被视为1，这是默认值。 通常，上面提到的“DoubleScan”标志将该值加倍。

ModeLine "name" mode−description

此条目是模式条目的更紧凑版本，也可用于指定监视器的视频模式。这是用于指定视频模式的单行格式。在大多数情况下，这不是必需的，因为内置的VESA标准模式集就足够了。

模式描述分为四个部分，前三个部分是强制性的。第一个是点（像素）时钟。这是指定模式的像素时钟速率的单个数字，以MHz为单位。第二部分是指定水平定时的四个数字的列表。这些数字是hdisp，hsyncstart，hsyncend和htotal值。第三部分是指定垂直定时的四个数字的列表。这些数字是vdisp，vsyncstart，vsyncend和vtotal值。最后一部分是指定模式的其他特性的标志列表。隔行表示模式是隔行扫描。 DoubleScan表示每个扫描线加倍的模式。 + HSync和-HSync可用于选择HSync信号的极性。 + VSync和-VSync可用于选择VSync信号的极性。 Composite可用于在支持此功能的硬件上指定复合同步。此外，在某些硬件上，+ CSync和-CSync可用于选择复合同步极性。在模式条目描述中的上述HSkew和VScan选项也可以在这里使用。

Option "DPMS" "bool"

此选项控制服务器是否应在此屏幕上启用DPMS扩展以进行电源管理。 默认为启用扩展。

Option "SyncOnGreen" "bool"

此选项控制视频卡是否应驱动绿色引脚上的同步信号。 并非所有卡都支持此选项，大多数显示器不需要它。 默认为关闭。

Option "Primary" "bool"

此可选条目指定应将监视器视为主监视器。 （仅支持RandR 1.2的驱动程序）

Option "PreferredMode" "name"

此可选条目指定要标记为监视器的首选初始模式的模式。 （仅支持RandR 1.2的驱动程序）

Option "Position" "x y"

此可选条目指定监视器在X屏幕中的位置。 （仅支持RandR 1.2的驱动程序）

Option "LeftOf" "output"

此可选条目指定监视器应位于给定名称的输出（而不是监视器）的左侧。 （仅支持RandR 1.2的驱动程序）

Option "RightOf" "output"

此可选条目指定监视器应位于给定名称的输出（而不是监视器）的右侧。 （仅支持RandR 1.2的驱动程序）

Option "Above" "output"

此可选条目指定监视器应位于给定名称的输出（而不是监视器）上方。 （仅支持RandR 1.2的驱动程序）

Option "Below" "output"

此可选条目指定监视器应位于给定名称的输出（不是监视器）下方。 （仅支持RandR 1.2的驱动程序）

Option "Enable" "bool"

此可选条目指定是否应在启动时打开监视器。 默认情况下，服务器将尝试启用所有连接的监视器。 （仅支持RandR 1.2的驱动程序）

Option "DefaultModes" "bool"

此可选条目指定服务器是否应将支持的默认模式添加到此监视器上提供的模式列表。 默认情况下，服务器将添加默认模式; 您应该仅在您可以确保EDID始终可用，或者您已添加服务器可以使用的自定义模型时才禁用此功能。 （仅支持RandR 1.2的驱动程序）

Option "MinClock" "frequency"

此可选条目指定监视器支持的最小点时钟（kHz）。

Option "MaxClock" "frequency"

此可选条目指定监视器支持的最大点时钟（kHz）。

Option "Ignore" "bool"

此可选条目指定应完全忽略监视器，并且不通过RandR进行报告。 如果硬件报告不存在的输出的存在，这是有用的。 （仅支持RandR 1.2的驱动程序）

Option "Rotate" "rotation"

此可选条目指定给定监视器的初始旋转。 旋转的有效值是“正常”，“左”，“右”和“反转”。 （仅支持RandR 1.2的驱动程序）

MODES SECTION

配置文件可能有多个Modes sections，或没有。 这些部分提供了一种独立于监视器部分定义视频模式集的方法。 监视器节可以包括使用UseModes关键字在这些sections中提供的定义。 在大多数情况下，Modes sections不是必需的，因为内置的VESA标准模式集就足够了。

Modes sections具有以下格式：

Section "Modes"
Identifier "name"
entries
...
EndSection

Identifier entry 指定这组模式描述的唯一名称。 模式部分中允许的其他条目是上面在监视器部分中描述的mode和modeLine entries。

SCREEN SECTION

配置文件可能有多个Screen sections。 必须至少有一个，用于“屏幕”被使用。 “屏幕”表示图形设备（设备部分）和监视器（监视器部分）的绑定。 如果Screen sections被活动的ServerLayout section或屏幕命令行选项引用，则该屏幕部分被视为“活动”。 如果这两个都不存在，配置文件中找到的第一个屏幕部分被认为是活动的。

Section "Screen"
Identifier "name"
Device "devid"
Monitor "monid"
entries
...
SubSection "Display"
entries
...
EndSubSection
...
EndSection

Identifier 和Device entries是必需的。 所有其他都是可选的。

 Identifier entry指定此屏幕的唯一名称。 Screen section提供特定于整个屏幕的信息，包括特定于屏幕的选项。 在多头配置中，将有多个活动Screen section，每个head一个。 此部分可用的条目是：

Device "device−id"

此强制条目指定要用于此屏幕的Device section。 这是一个特定的显卡与屏幕的关系。 device-id必须与配置文件中设备的Identifier一致。

Monitor "monitor−id"

指定要用于此屏幕的监视器描述。 如果未指定Monitor名称，则使用默认配置。 当前，默认配置可能无法按预期在所有平台上运行。

VideoAdaptor "xv−id"

指定要与此屏幕一起使用的可选Xv视频适配器描述。

DefaultDepth depth

指定服务器默认使用的颜色深度。 -depth命令行选项可以用来覆盖此选项。 如果两者都未指定，则默认深度是特定于驱动程序的，但在大多数情况下为8。

DefaultFbBpp bpp

指定默认使用哪个帧缓冲区布局。 -fbbpp命令行选项可用于覆盖此选项。 在大多数情况下，驱动程序将为此选择最佳默认值。 在该值中甚至有一个选择的唯一情况是深度24，其中一些硬件支持打包的24位帧缓冲器布局和稀疏的32位帧缓冲器布局。

Options

可以在Screen section中指定各种选项标志。 一些是驱动程序特定的，并在驱动程序文档中描述。 其他是独立于驱动程序的，最终将在这里描述。

Option "Accel"

启用XAA（X加速架构），这是一种使视频卡的2D硬件加速可用于Xorg服务器的机制。 默认情况下，此选项处于打开状态，但如果驱动程序中存在错误，则可能需要将其关闭。 有许多选项可以禁用特定的加速操作，如下所示。 请注意，如果操作未加速（无论是由于硬件或驱动程序中缺少支持），禁用操作都不会产生任何影响。

Option "InitPrimary" "boolean"

使用Int10模块初始化主图形卡。 通常，只有辅卡使用Int10模块进行软启动，因为主卡已在启动时由BIOS初始化。 默认值：false。

Option "NoInt10" "boolean"

禁用Int10模块，该模块使用int10调用图形卡的BIOS来初始化它。 默认值：false。

Option "NoMTRR"

禁用MTRR（存储器类型范围寄存器）支持，这是现代处理器的一个功能，可以将视频性能提高高达2.5倍。 一些硬件具有MTRR支持，并且一些视频驱动程序已知在使用MTRR时会出现问题。

Option "XaaNoCPUToScreenColorExpandFill"

禁用从存储在系统存储器中的源码型（使用存储器映射光圈）的加速矩形扩展块。

Option "XaaNoColor8x8PatternFillRect"

禁用具有全色图案的矩形区域的加速填充。

Option "XaaNoColor8x8PatternFillTrap"

禁用具有全色图案的梯形区域的加速填充。

Option "XaaNoDashedBresenhamLine"

禁用加速的虚线Bresenham线绘制。

Option "XaaNoDashedTwoPointLine"

禁用两个任意点之间的加速虚线绘制。

Option "XaaNoImageWriteRect"

禁用从系统存储器到视频存储器（使用存储器映射光圈）的全色矩形图案的加速传输。

Option "XaaNoMono8x8PatternFillRect"

禁用具有单色图案的矩形区域的加速填充。

Option "XaaNoMono8x8PatternFillTrap"

禁用具有单色图案的梯形区域的加速填充。

Option "XaaNoOffscreenPixmaps"

禁用加速绘制到存储在屏幕外视频存储器中的像素图。

Option "XaaNoPixmapCache"

禁用缓存屏幕视频内存中的模式。

Option "XaaNoScanlineCPUToScreenColorExpandFill"

禁用来自存储在系统存储器中的源图案的加速矩形扩展块（每次一个扫描行）。

Option "XaaNoScanlineImageWriteRect"

禁止从系统存储器到视频存储器（每次一条扫描线）的全色矩形图案的加速传输。

Option "XaaNoScreenToScreenColorExpandFill"

禁用来自存储在屏幕外视频存储器中的源图案的加速矩形扩展块。

Option "XaaNoScreenToScreenCopy"

禁用从视频存储器的一部分到视频存储器的另一部分的矩形区域的加速副本。

Option "XaaNoSolidBresenhamLine"

禁用加速的实线Bresenham线绘制。

Option "XaaNoSolidFillRect"

禁用加速的纯色填充的矩形。

Option "XaaNoSolidFillTrap"

禁用加速的纯色填充的Bresenham梯形。

Option "XaaNoSolidHorVertLine"

禁用加速的实心水平和垂直线绘制。

Option "XaaNoSolidTwoPointLine"

禁用两个任意点之间的加速实线绘制。

每个Screen section可以可选地包含一个或多个Display subsections。 这些subsections提供了depth / fbbpp特定配置信息，并且所选择的配置信息取决于用于屏幕的深度和/或fbbpp。 Display subsections格式在下面的部分中描述。

DISPLAY SUBSECTION

每个Screen section可以具有多个Display subsections。“active” Display subsection是与正在使用的深度和/或fbbpp值匹配的第一个，或者第一个未指定depth或fbbpp值的第一个。 “active” Display subsection是可选的。 当没有一个匹配正在使用的深度和/或fbbpp值时，这里可以指定的所有参数可以回退到它们的默认值。

Display subsections有以下格式：

SubSection "Display"
Depth depth
entries
...
EndSubSection

Depth depth

此条目指定要使用Display subsections的颜色深度。 通常指定此条目，但可以省略此条目以创建match-all Display子句或仅希望与FbBpp参数匹配。 允许的深度值范围取决于驱动程序。 大多数驱动程序支持8,15,16和24.有些也支持1和/或4，有些可能支持其他值（如30）。 注意：depth是指像素中实际用于确定像素颜色的位数。 32不是有效的深度值。 大多数每像素使用32位的硬件仅使用24个来保存颜色信息，这意味着颜色深度为24而不是32。

FbBpp bpp

此条目指定此Display subsections要使用的帧缓冲区格式。 仅当提供允许在24bpp打包帧缓冲器格式和32bpp稀疏帧缓冲器格式之间进行选择的深度24配置时，才需要该条目。 在大多数情况下，不应使用此条目。

Weight red−weight green−weight blue−weight

此可选条目指定要用于屏幕的相对RGB加权在深度16处用于允许多种格式的驱动程序。 这也可以从带有-weight选项的命令行中指定（参见Xorg（1））。

Virtual xdim ydim

此可选条目指定要使用的虚拟屏幕分辨率。 对于大多数驱动程序，xdim必须是8或16的倍数，而在单色模式下运行时，xdim必须是32的倍数。 如果不是这样，给定的值将被向下舍入。 对于指定的虚拟大小过大的视频模式将被拒绝。 如果此条目不存在，则虚拟屏幕分辨率将设置为适应模式条目中给出的所有有效视频模式。 某些驱动程序/硬件组合不支持虚拟屏幕。 有关详细信息，请参阅相应的驱动程序特定文档。

ViewPort x0 y0

此可选条目设置初始显示的左上角。 这仅在虚拟屏幕分辨率不同于初始视频模式的分辨率时才相关。 如果未给出此条目，则初始显示将在虚拟显示区域中居中。

Modes "mode−name" ...

此可选条目指定要使用的视频模式的列表。 指定的每个模式名称必须在双引号中。 它们必须与相应的Monitor section中指定或引用的内容（包括隐式引用的内置VESA标准模式）相对应。 服务器将从此列表中删除不满足各种要求的模式。 此列表中的第一个有效模式将是启动的默认显示模式。 有效模式列表在内部转换为循环列表。 可以使用Ctrl + Alt + Keypad-Plus切换到下一个模式，使用Ctrl + Alt + Keypad-Minus切换到上一个模式。 当省略此条目时，将使用相应Monitor section引用的有效模式。 如果Monitor section不包含模式，则将从内置VESA标准模式进行选择。

Visual "visual−name"

此可选条目设置默认根视觉类型。 这也可以从命令行指定（参见Xserver（1）手册页）。 可用于深度8的视觉类型是（默认为PseudoColor）：

StaticGray
GrayScale
StaticColor
PseudoColor
TrueColor
DirectColor

可用于深度15,16和24的视觉类型为（默认为TrueColor）：

TrueColor
DirectColor

并不是所有的驱动程序都支持DirectColor在这些深度。

可用于深度4的视觉类型是（默认为StaticColor）：

StaticGray
GrayScale
StaticColor
PseudoColor

可用于深度1（单色）的视觉类型是StaticGray。

Black red green blue

此可选条目允许指定“黑色”颜色。 这仅在深度1处受支持。默认值为黑色。

White red green blue

此可选条目允许指定“白色”颜色。 这仅在深度1处受支持。默认值为白色。

Options

可以在Display subsections中指定选项标志。 这些可能包括驱动程序特定选项和驱动程序独立选项。 前者在驱动程序特定的文档中描述。 后面的一些在上面关于 Screen section的部分中描述，并且它们也可以包括在这里。

SERVERLAYOUT SECTION

配置文件可能有多个 ServerLayout sections。 “server layout”表示一个或多个屏幕（Screen sections）和一个或多个输入设备（InputDevice sections）的绑定以形成完整配置。 在multi−head configurations中，它还指定头的相对布局。 如果由-layout命令行选项或ServerFlags部分中的一个选项“DefaultServerLayout”条目（前者优先于后者）引用ServerLayout sections，则它被认为是“活动的”。 如果不使用这些选项，则配置文件中找到的第一个ServerLayout sections将被视为活动的。 如果没有ServerLayout sections，则如上面相关部分所述，选择单个活动屏幕和两个活动（核心）输入设备。

ServerLayout sections有以下格式：

Section "ServerLayout"
Identifier "name"
Screen "screen−id"
...
InputDevice "idev−id"
...
options
...
EndSection

每个ServerLayout section必须有一个Identifier entry和至少一个Screen entry。

Identifier entry指定此server layout.的唯一名称。 ServerLayout section提供特定于整个会话的信息，包括特定于会话的选项。 可以在此处指定ServerFlags选项（如上所述），此处给出的选项将覆盖ServerFlags section中给出的选项。

此处描述可在此section中使用的条目。

Screen screen−num "screen−id" position−information

对于在会话中使用的每个屏幕，必须给出这些条目之一。 screen-id字段是必需的，并指定要引用的Screen section。 screen-num字段是可选的，并且可以用于指定multi−head configurations中的屏幕号。 当省略此字段时，屏幕将按列出的顺序编号。编号从0开始，并且必须是连续的。 位置信息字段描述多个屏幕被定位的方式。 有多种不同的方式可以提供此信息：
    
x y
    
Absolute x y

这两个都指定左上角的坐标是（x，y）。 Absolute关键字是可选的。 一些旧版本的XFree86（4.2及更早版本）不能识别Absolute关键字，因此最安全的方法是指定没有它的坐标。

RightOf "screen−id"
LeftOf "screen−id"
Above "screen−id"
Below "screen−id"
Relative "screen−id" x y

这些给出了屏幕相对于另一个屏幕的位置。 前四个位置的屏幕会立即向右，向左，上方或下方的另一个屏幕。 当向右或向左定位时，顶部边缘对齐。 当定位在上方或下方时，左边缘对齐。 相对形式指定屏幕的原点（左上角）相对于另一屏幕的原点的偏移。

InputDevice "idev−id" "option" ...

应为会话中使用的每个输入设备指定这些条目之一。 通常至少需要两个，一个用于核心指针和键盘设备。 如果其中任何一个丢失，则使用上述inputdevice section中描述的方法搜索合适的InputDevice entries。 idev-id字段是必需的，并指定要引用的InputDevice section的名称。 可以指定多个选项字段，每个都在双引号中。 这里允许的选项是也可以在InputDevice section给出的任何选项。 通常，此处仅使用会话特定的输入设备选项。 最常用的选项是：

"CorePointer"
"CoreKeyboard"
"SendCoreEvents"

并且前两个通常应该分别用于指示核心指针和核心键盘设备。

Options

除了以下内容，还可以在此处指定ServerFlags section中允许的任何选项。 当两个位置都显示相同的选项时，此处给出的值将覆盖ServerFlags section中给出的值。

Option "IsolateDevice" "bus−id"

限制设备复位到指定的总线标识。 有关bus-id参数的格式，请参见BusID选项（在上面的DEVICE SECTION中描述）。 如果指定，此选项将覆盖SingleCard。 目前，只有PCI设备可以这种方式被隔离。

Option "SingleCard" "boolean"

作为IsolateDevice，除了使用布局中的第一个设备的总线ID正在使用。

下面是具有两个鼠标的双头配置的ServerLayout section的示例：

Section "ServerLayout"
Identifier "Layout 1"
Screen "MGA 1"
Screen "MGA 2" RightOf "MGA 1"
InputDevice "Keyboard 1" "CoreKeyboard"
InputDevice "Mouse 1" "CorePointer"
InputDevice "Mouse 2" "SendCoreEvents"
Option "BlankTime" "5"
EndSection

DRI SECTION

此可选部分用于为直接呈现基础结构提供一些信息。 有关此部分格式的详细信息，请访问。

VENDOR SECTION

可选的供应商部分可以用于提供供应商特定的配置信息。 可以存在多个供应商部分，并且它们可以包含标识符条目和多个选项标志。 其中的数据不在此版本中使用。

SEE ALSO

General: X(7), Xserver(1), Xorg(1), cvt(1), gtf(1).

Not all modules or interfaces are available on all platforms.

Display drivers: apm(4), ati(4), chips(4), cirrus(4), cyrix(4), fbdev(4), glide(4), glint(4), i128(4), i740(4), imstt(4), intel(4), mga(4), neomagic(4), nv(4), openchrome(4), r128(4), radeon(4), rendition(4), savage(4), s3virge(4), siliconmotion(4), sis(4), sisusb(4), sunbw2(4), suncg14(4), suncg3(4), suncg6(4), sunffb(4), sunleo(4), suntcx(4), tdfx(4), trident(4), tseng(4), vesa(4), vmware(4), voodoo(4), wsfb(4), xgi(4), xgixp(4).

Input drivers: acecad(4), citron(4), elographics(4), evdev(4), fpit(4), joystick(4), kbd(4), mousedrv(4), mutouch(4), penmount(4), synaptics(4), vmmouse(4), void(4), wacom(4).

Other modules and interfaces: exa(4), fbdevhw(4), v4l(4).
AUTHORS

This manual page was largely rewritten by David Dawes .