命令行手册

Man » Xorg 手册在线 - 适用于 xorg 手册页的详细在线文档

🌍

Xorg - X11R7 X 服务器

概要

Xorg [:display] [选项 ...]

描述

Xorg 是一个功能齐全的 X 服务器,最初是为运行在 Intel x86 硬件上的 UNIX 和类 UNIX 操作系统设计的。 现在,它可以在更广泛的硬件和操作系统平台上运行。

这项工作由 X.Org 基金会从 XFree86 项目的 XFree86 4.4rc2 版本中衍生而来。 XFree86 版本最初由 Thomas Roell 从 X386 1.2 中衍生而来,并由 Snitily Graphics Consulting Service 贡献给 X11R5。

平台

Xorg 在各种操作系统和硬件平台上运行。 Intel x86(IA32)架构是最受支持的硬件平台。 其他硬件平台包括 Compaq Alpha、Intel IA64、AMD64、SPARC 和 PowerPC。 最受支持的操作系统是免费/开源类 UNIX 操作系统,例如 Linux、FreeBSD、NetBSD、OpenBSD 和 Solaris。 商业 UNIX 操作系统,例如 UnixWare,也受支持。 其他受支持的操作系统包括 GNU Hurd。 Mac OS X 使用 Xquartz(1) X 服务器得到支持。 Win32/Cygwin 使用 XWin(1) X 服务器得到支持。

网络连接

Xorg 支持使用以下可靠的字节流建立连接:

本地 在大多数平台上,“本地”连接类型都是 UNIX 域套接字。 在某些 System V 平台上,“本地”连接类型还包括 STREAMS 管道、命名管道和其他机制。 有关详细信息,请参阅 X(7) 中的“本地连接”部分。

TCP/IP

Xorg 侦听端口 6000+n,其中 n 是显示编号。 通常禁用此连接类型,但可以使用 -listen 选项启用(有关详细信息,请参阅 Xserver(1) 手册页)。

选项

Xorg 支持几种用于提供/获取配置和运行时参数的机制:命令行选项、环境变量、xorg.conf(5) 配置文件、自动检测和回退默认值。 当通过多种方式提供相同信息时,将使用优先级最高的机制。 机制列表按优先级从高到低排序。 请注意,并非所有参数都可以通过所有方法提供。 可用的命令行选项和环境变量(以及某些默认值)在此处和 Xserver(1) 手册页中描述。 大多数配置文件参数及其默认值在 xorg.conf(5) 手册页中描述。 驱动程序和模块特定的配置参数在其各自的驱动程序或模块手册页中描述。

除了 Xserver(1) 手册页中描述的常规服务器选项之外,Xorg 还接受以下命令行开关:


-vt XX XX 指定 Xorg 将使用的虚拟终端设备编号。如果没有此选项,Xorg 将选择其可以找到的第一个可用虚拟终端。此选项仅适用于具有虚拟终端支持的平台,例如 Linux、BSD、OpenSolaris、SVR3 和 SVR4。

-allowMouseOpenFail
允许服务器在无法打开或初始化鼠标设备时启动。这等效于 xorg.conf(5) 文件中的 AllowMouseOpenFail 选项。

-allowNonLocalXvidtune
允许远程客户端使用 VidMode 扩展。这允许 xvidtune 客户端从另一台主机连接。这等效于 xorg.conf(5) 文件中的 AllowNonLocalXvidtune 选项。默认情况下,不允许非本地连接。

-bgamma value
设置蓝色伽马校正。value 必须在 0.1 到 10 之间。默认值为 1.0。并非所有驱动程序都支持此选项。另请参见 -gamma、-rgamma 和 -ggamma 选项。

-bpp n
不再支持。使用 -depth 设置颜色深度,如果确实需要强制使用非默认帧缓冲区(硬件)像素格式,则使用 -fbbpp。

-config file
从文件读取服务器配置。当服务器以 root 用户身份运行时(即,具有真实用户 ID 0),此选项将适用于任何文件;对于其他用户,该文件相对于配置搜索路径中的目录。

-configdir directory
从目录读取服务器配置文件。当服务器以 root 用户身份运行时(即,具有真实用户 ID 0),此选项将适用于任何目录;对于其他用户,该目录相对于配置目录搜索路径中的目录。

-configure
当指定此选项时,Xorg 服务器将加载所有视频驱动程序模块,探测可用的硬件,并根据探测到的内容写入初始 xorg.conf(5) 文件。此选项在某些平台上目前存在一些问题,但在大多数情况下,它是引导配置过程的好方法。此选项仅在服务器以 root 用户身份运行时可用(即,具有真实用户 ID 0)。

-crt /dev/ttyXX
仅适用于 SCO。这与 vt 选项相同,并且为了与本机 SCO X 服务器兼容而提供。

-depth n
设置默认颜色深度。合法值为 1、4、8、15、16 和 24。并非所有驱动程序都支持所有值。

-disableVidMode
禁用 VidMode 扩展的用于更改视频模式的部分(由 xvidtune 客户端使用)。这等效于 xorg.conf(5) 文件中的 DisableVidModeExtension 选项。

-fbbpp n
设置帧缓冲区每像素的位数。您只有在确定需要时才应该设置此选项;通常,服务器可以从上面的 -depth 选项中推断出正确的值。如果您希望使用 24 位帧缓冲区运行 24 位配置,而不是(可能的默认)32 位帧缓冲区(反之亦然),这将非常有用。合法值为 1、8、16、24。

-gamma value

设置伽玛校正。value 必须在 0.1 到 10 之间。默认值为 1.0。此值等比例应用于 R、G 和 B 值。可以使用 -rgamma、-bgamma 和 -ggamma 选项分别设置这些值。并非所有驱动程序都支持此选项。

-ggamma value

设置绿色伽玛校正。value 必须在 0.1 到 10 之间。默认值为 1.0。并非所有驱动程序都支持此选项。请参阅 -gamma、-rgamma 和 -bgamma 选项。

-ignoreABI

Xorg 服务器会检查其加载的每个模块的 ABI 版本级别。通常,它会拒绝加载 ABI 版本级别高于服务器的模块。这是因为此类模块可能会使用服务器不具备的接口。如果指定此选项,则此类不匹配将从致命错误降级为警告。此选项应谨慎使用。

-isolateDevice bus-id

将设备重置限制为 bus-id 处的设备。bus-id 字符串的格式为 bustype:bus:device:function(例如,“PCI:1:0:0”)。目前,仅支持隔离 PCI 设备;也就是说,如果 bustype 不是“PCI”,则此选项将被忽略。

-keeptty

防止服务器分离其初始控制终端。如果您想使用 systemd-logind 集成,则必须指定此选项。并非所有平台都支持(或可以使用)此选项。

-keyboard keyboard-name

使用 xorg.conf(5) 文件中名为 keyboard-name 的 InputDevice 部分作为核心键盘。当 Layout 部分指定核心键盘时,此选项将被忽略。如果没有 Layout 部分也没有此选项,则将使用第一个相关的 InputDevice 部分作为核心键盘。

-layout layout-name

使用 xorg.conf(5) 文件中名为 layout-name 的 Layout 部分。默认情况下,使用第一个 Layout 部分。

-logfile filename

使用名为 filename 的文件作为 Xorg 服务器日志文件。以 root 身份运行时,默认日志文件为 /var/log/Xorg.n.log,对于非 root 用户,为 $XDG_DATA_HOME/xorg/Xorg.n.log,其中 n 是 Xorg 服务器的显示编号。默认值可能在某些平台上位于不同的目录中。只有在服务器以 root 身份运行时(即,具有真实用户 ID 0),此选项才可用。

-logverbose [n]

设置写入 Xorg 服务器日志文件的信息的详细程度。如果未提供 n 值,则每次出现此选项都会增加日志文件详细程度。当提供 n 值时,日志文件详细程度将设置为该值。默认日志文件详细程度为 3。

-modulepath searchpath

设置模块搜索路径为 searchpath。searchpath 是一组用逗号分隔的目录,用于搜索 Xorg 服务器模块。只有在服务器以 root 身份运行时(即,具有真实用户 ID 0),此选项才可用。

-noautoBindGPU

禁用自动将辅助 GPU 设置为输出接收器和卸载源。这等效于将 xorg.conf(5) 文件中的 AutoBindGPU 选项设置为 false。


-nosilk 禁用 Silken Mouse 支持。

-novtswitch
禁用在 X 服务器重置和关闭时,如果操作系统支持,则自动切换到服务器启动时活动的 VT。

-pointer pointer-name
使用 `xorg.conf(5)` 文件中名为 `pointer-name` 的 `InputDevice` 部分作为核心指针。当 `Layout` 部分指定了核心指针时,此选项将被忽略。如果没有 `Layout` 部分和此选项,则使用第一个相关的 `InputDevice` 部分作为核心指针。

-quiet 抑制启动时的大多数信息性消息。信息级别设置为零。

-rgamma value
设置红色伽玛校正。`value` 必须在 0.1 到 10 之间。默认值为 1.0。并非所有驱动程序都支持此选项。另请参见 `-gamma`、`-bgamma` 和 `-ggamma` 选项。

-sharevts
如果操作系统支持,则与其他 X 服务器共享虚拟终端。

-screen screen-name
使用 `xorg.conf(5)` 文件中名为 `screen-name` 的 `Screen` 部分。默认情况下,使用默认 `Layout` 部分引用的屏幕,或者如果没有 `Layout` 部分,则使用第一个 `Screen` 部分。

-showconfig
与 `-version` 选项相同,并包含在内以实现兼容性。它可能会在未来的版本中删除,因此应使用 `-version` 选项。

-showDefaultModulePath
打印服务器编译时使用的默认模块路径。

-showDefaultLibPath
打印应安装库的路径。

-showopts
对于已安装的每个驱动程序模块,打印选项及其参数类型的列表。

-weight nnn
在 16 位色彩深度下设置 RGB 权重。默认值为 565。这仅适用于支持 16 位色彩深度的驱动程序。

-verbose [n]
设置打印到 stderr 的信息的详细程度。如果未提供 `n` 值,则每次出现此选项都会增加详细程度。如果提供了 `n` 值,则将详细程度设置为该值。默认详细程度为 0。

-version
打印服务器版本、补丁级别、发布日期、构建的操作系统/平台以及它是否包含模块加载器支持。

键盘

Xorg 服务器通常配置为识别各种特殊的按键组合,这些组合指示服务器执行某些操作,而不是仅将按键事件发送到客户端应用程序。这些操作取决于由特定键盘设备加载的 XKB 键映射,并且可能在给定的配置中可用或不可用。

以下按键组合通常是默认 XKEYBOARD 键映射的一部分。

Ctrl+Alt+Backspace

立即终止服务器——无需任何提示。可以通过将 xorg.conf(5) 文件中的 DontZap 选项设置为 TRUE 来禁用。

应该注意的是,终止是通过键盘映射中的 Terminate_Server 操作触发的。此操作不是默认键映射的一部分,但可以使用 XKB 选项“terminate:ctrl_alt_bksp”启用。


Ctrl+Alt+数字键盘上的“+”键

将视频模式更改为配置文件中指定的下一个模式。 可以通过 DontZoom xorg.conf(5) 文件选项禁用此功能。

Ctrl+Alt+数字键盘上的“-”键

将视频模式更改为配置文件中指定的上一个模式。 可以通过 DontZoom xorg.conf(5) 文件选项禁用此功能。

Ctrl+Alt+F1...F12

对于支持虚拟终端的系统,这些组合键用于切换到虚拟终端 1 到 12。 可以通过 DontVTSwitch xorg.conf(5) 文件选项禁用此功能。

配置

Xorg 通常使用名为 xorg.conf 的配置文件和名为 xorg.conf.d 的目录中的后缀为 .conf 的配置文件来进行初始设置。 请参阅 xorg.conf(5) 手册页,了解有关此文件格式的信息。

Xorg 具有在运行时自动生成内置配置的机制,即当没有 xorg.conf 文件或 xorg.conf.d 文件时。 此自动配置机制的当前版本以两种方式工作。

第一种是通过对许多 xorg.conf 文件组件进行增强,使其成为可选组件。 这意味着可以探测或合理推断出的信息无需显式指定,从而大大减少了需要在运行时生成的内置配置信息量。

第二种是为大多数配置信息提供“安全”的后备方案。 这最大限度地提高了即使在无法获得特定硬件信息时,Xorg 服务器也能以某种可用配置启动的可能性。

Xorg 的自动配置支持是一项正在进行的工作。 它目前面向 Xorg 支持的最流行的硬件和软件平台。 计划在未来的版本中进行增强。

文件

Xorg 服务器的配置文件可以在一系列位置找到。 这些位置在 xorg.conf(5) 手册页中进行了完整记录。 这里显示了最常用的位置。

/etc/X11/xorg.conf            服务器配置文件。

/etc/X11/xorg.conf-4          服务器配置文件。

/etc/xorg.conf                服务器配置文件。

/usr/etc/xorg.conf            服务器配置文件。

/usr/lib/X11/xorg.conf        服务器配置文件。

/etc/X11/xorg.conf.d          服务器配置目录。

/etc/X11/xorg.conf.d-4        服务器配置目录。

/etc/xorg.conf.d              服务器配置目录。

/usr/etc/xorg.conf.d          服务器配置目录。

/usr/lib/X11/xorg.conf.d      服务器配置目录。

/var/log/Xorg.n.log           显示器 n 的服务器日志文件。

/usr/bin/∗                    客户端二进制文件。

/usr/include/∗                头文件。

/usr/lib/∗                    库。

/usr/share/fonts/X11/∗        字体。

/usr/share/X11/XErrorDB       客户端错误消息数据库。

/usr/lib/X11/app-defaults/∗   客户端资源规范。

/usr/share/man/man?/∗         手册页。

/etc/Xn.hosts                 显示器 n 的初始访问控制列表。

参见

X(7), Xserver(1), xdm(1), xinit(1), xorg.conf(5), xvidtune(1), xkeyboard-config (7), 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), nsc(4), nv(4), openchrome (4), r128(4), rendition(4), s3virge(4), siliconmotion(4), sis(4), sunbw2(4), suncg14(4), suncg3(4), suncg6(4), sunffb(4), sunleo(4), suntcx(4), tdfx(4), tga(4), trident(4), tseng(4), v4l(4), vesa(4), vmware(4), 网站 [https://www.x.org]。

作者

Xorg 拥有来自世界各地的众多贡献者。他们中的大多数人的名字可以在文档、源代码树中的 ChangeLog 文件以及实际源代码中找到。

Xorg 最初基于 XFree86 4.4rc2。该版本最初基于 Thomas Roell 的 X386 1.2,该版本由 SGCS 贡献给当时的 X Consortium 的 X11R5 发行版。

Xorg 由 X.Org 基金会发布。

最初于 1992 年由 David Dawes、Glenn Lai、Jim Tsillas 和 David Wexelblat 创立的 XFree86 项目。

XFree86 后来被一群专门的 XFree86 开发人员整合到当时的 X Consortium 的 X11R6 版本中,其中包括以下人员:

Stuart Anderson _ Doug Anson _ Gertjan Akkerman _ Mike Bernson _ Robin Cutshaw _ David Dawes _ Marc Evans _ Pascal Haible _ Matthieu Herrb _ Dirk Hohndel _ David Holland _ Alan Hourihane _ Jeffrey Hsu _ Glenn Lai _ Ted Lemon _ Rich Murphey _ Hans Nasten _ Mark Snitily _ Randy Terbush _ Jon Tombs _ Kees Verstoep _ Paul Vixie _ Mark Weaver _ David Wexelblat _ Philip Wheatley _ Thomas Wolfram _ Orest Zborowski _

Xorg 源代码可从 FTP 服务器 [ftp://ftp.x.org/] 以及 X.Org 服务器 [https://gitlab.freedesktop.org/xorg/] 获取。文档和其他信息可在 X.Org 网站 [https://www.x.org/] 上找到。

法律

Xorg 是受版权保护的软件,其许可证允许修改和重新分发源代码和二进制形式,无需任何费用。Xorg 的版权归世界各地的众多作者和贡献者所有。许可信息可在 [https://www.x.org] 上找到。请参阅源代码以获取特定的版权声明。

XFree86(TM) 是 The XFree86 Project, Inc. 的商标。

X11(TM) 和 X Window System(TM) 是 The Open Group 的商标。