xset - X 的用户偏好设置实用工具
概要
xset [-display display]
[-b] [b {on|off}] [b [volume [pitch [duration]]]]
[-bc] [bc]
[-c] [c {on|off}] [c [volume]]
[+dpms] [-dpms]
[dpms standby [ suspend [ off]]]
[dpms force {standby|suspend|off|on}]
[fp=pathlist] [-fp=pathlist] [+fp=pathlist] [fp-pathlist] [fp+pathlist]
[fp default] [fp rehash]
[-led [integer|named indicator]] [led [integer|named indicator]]
[led {on|off}]
[mouse [accel_mult[/accel_div] [threshold]]] [mouse default]
[p pixel color]
[-r [keycode]] [r [keycode]] [r {on|off}] [r rate delay [rate]]
[s [length [period]]] [s {blank|noblank}]
[s {expose|noexpose}] [s {on|off}] [s default] [s activate] [s reset]
[q]
[-version]
描述
此程序用于设置显示器的各种用户偏好设置选项。
选项
-display display
此选项指定要使用的服务器；请参阅 X(7)。
b b 选项控制铃声的音量、音调和持续时间。此选项最多接受三个数值参数、一个前缀“-”或一个“on/off”标志。如果未提供参数或使用“on”标志，则将使用系统默认值。如果提供“-”或“off”，则会关闭铃声。如果只提供一个数值参数，则将铃声音量设置为该值的百分比。同样，第二个数值参数指定铃声的音调（以赫兹为单位），第三个数值参数指定持续时间（以毫秒为单位）。请注意，并非所有硬件都可以改变铃声的特性。X 服务器将尽可能地将铃声特性设置为用户指定的特性。
bc bc 选项控制服务器中的兼容性模式（如果可能）；前缀“-”会禁用该模式，否则会启用该模式。各种 R4 之前的客户端在某些协议请求中传递了非法的数值，并且 R4 之前的服务器没有正确生成错误。当在 R4 服务器上运行这些客户端时，它们会异常终止或无法正常运行。兼容性模式显式地将某些错误重新引入到 X 服务器中，以便许多此类客户端仍然可以运行。应谨慎使用此模式；新的应用程序开发应禁用此模式。服务器必须支持 MIT-SUNDRY-NONSTANDARD 协议扩展，此选项才能工作。
c c 选项控制按键点击声。此选项可以接受一个可选的值、一个前缀“-”或一个“on/off”标志。如果未提供参数或使用“on”标志，则将使用系统默认值。如果使用“-”或“off”标志，则会禁用按键点击声。如果提供 0 到 100 之间的值，则将其用作音量百分比。X 服务器将音量设置为硬件可以支持的最接近的值。
mouse mouse 选项控制鼠标加速。它接受可选的参数，包括加速乘数和除数（accel_mult/accel_div）以及阈值。`mouse default` 选项用于恢复鼠标的默认设置。
p p 选项用于设置像素颜色。
-r -r 选项用于控制重复键。它接受可选的键码、`on/off` 标志以及速率和延迟值。`r` 选项可以单独使用，也可以与键码一起使用。
s s 选项控制屏幕保护程序的行为。它接受可选的长度和周期参数，以及 `blank`、`noblank`、`expose`、`noexpose`、`on`、`off`、`default`、`activate` 和 `reset` 标志。
q q 选项用于退出 xset 程序。
-version -version 选项用于显示 xset 的版本信息。
-dpms -dpms 选项禁用显示电源管理信号 (DPMS) 功能。
+dpms +dpms 选项启用显示电源管理信号 (DPMS) 功能。
dpms flags...
dpms 选项允许设置显示电源管理信号 (DPMS) 参数。 该选项最多可以接受三个数值，或者 `force` 标志，后跟一个 DPMS 状态。 `force` 标志强制服务器立即切换到指定的 DPMS 状态。 DPMS 状态可以是 `standby`、`suspend`、`off` 或 `on` 中的一个。 当给出数值时，它们设置在激活三种模式之前的非活动时间（以秒为单位）。 给出的第一个值用于 `standby` 模式，第二个值用于 `suspend` 模式，第三个值用于 `off` 模式。 设置这些值会隐式启用 DPMS 功能。 值为零会禁用特定模式。
fp= path,...
fp= 设置字体路径为 path 参数中给出的条目。 服务器（而不是客户端）解释这些条目。 通常它们是目录名称或字体服务器名称，但解释取决于服务器。
fp default
default 参数使字体路径重置为服务器的默认值。
fp rehash
rehash 参数将字体路径重置为其当前值，导致服务器重新读取当前字体路径中的字体数据库。 这通常仅在将新字体添加到字体目录后（在运行 mkfontdir 以重新创建字体数据库之后）使用。
-fp 或 fp-
-fp 和 fp- 选项从当前字体路径中删除元素。 它们必须后跟一个逗号分隔的条目列表。
+fp 或 fp+
+fp 和 fp+ 选项将元素添加到当前字体路径的开头和结尾。 它们必须后跟一个逗号分隔的条目列表。
led led 选项控制键盘 LED。 这控制一个或所有 LED 的开启或关闭。 它接受一个可选的整数，一个前导的破折号 (-) 或一个“on/off”标志。 如果没有给出参数或给出了“on”标志，则所有 LED 都将打开。 如果给出一个前导的破折号或“off”标志，则所有 LED 都将关闭。 如果给出一个介于 1 和 32 之间的值，则该 LED 将根据是否存在前导的破折号而打开或关闭。 `xset led 3` 将打开 LED #3。 `xset -led 3` 将关闭它。 特定 LED 值可能指的是不同硬件上的不同 LED。 如果 X 服务器支持 XKEYBOARD (XKB) 扩展，则可以通过指定“named”关键字和指示器名称来引用 LED。 例如，要打开 Scroll Lock LED：
xset led named "Scroll Lock"
mouse `m`选项用于控制鼠标参数；可以缩写为`m`。当然，它适用于大多数指向设备，而不仅仅是鼠标。指向设备参数为“加速度”和“阈值”。加速度可以指定为整数，也可以指定为简单的分数。阈值只是一个整数。该设置应用于所有连接的指向设备。如果需要设备特定的设置，应使用`xinput(1)`。
默认情况下，当设备在10毫秒内移动超过“阈值”米基（即可能的像素）时，指针（即屏幕上的指向设备表示）的速度将是“加速度”倍。这包括一个小的过渡范围。这样，指向设备可用于在缓慢移动时进行精确对齐，但在需要时也可以设置为通过手腕一甩即可在屏幕上移动。`m`选项的一个或两个参数可以省略，但如果只提供一个参数，则将其解释为加速度。如果未提供参数或使用“default”标志，则将设置系统默认值。
如果提供了“阈值”参数且值为0，则“加速度”参数将用于更自然、更连续的公式的指数中，从而可以对慢速运动进行精确控制，并对快速运动进行大幅度移动，并且对中间运动进行渐进过渡。在这种情况下，建议的“加速度”值为3/2到3，但并非仅限于该范围。
在X.org X服务器1.6及更高版本中，到目前为止描述的行为与默认配置文件相关联。存在其他配置文件（即确定指针加速度的函数来自设备速度），以及其他设置，因此上述描述可能不适用于非默认情况。
在X.org服务器1.7中，这些作为输入设备属性提供（请参见`xinput`）。
p `p`选项用于控制像素颜色值。参数是十进制形式的颜色映射条目编号，以及颜色规范。在某些服务器上，可以通过更改“BlackPixel”和“WhitePixel”的条目来更改根背景颜色。虽然这些通常是0和1，但不必如此。此外，服务器可以选择私下分配这些颜色，在这种情况下，将生成错误。颜色映射条目不能是只读颜色，否则将发生错误。
r r选项用于控制自动重复。使用“-r”或“r off”调用将禁用自动重复，而“r”或“r on”将启用自动重复。在“-r”或“r”选项之后，跟随一个介于0到255之间的整数键代码，将禁用或启用该键的自动重复，但前提是该键代码有意义。键代码小于8通常对此命令无效。例如，“xset -r 10”将禁用IBM PC键盘顶行上“1”键的自动重复。
如果服务器支持 XFree86-Misc 扩展或 XKB 扩展，则接受一个名为“rate”的参数，该参数应后跟零个、一个或两个数字值。第一个指定自动重复开始前的延迟，第二个指定重复速率。如果服务器支持 XKB 扩展，则延迟是以毫秒为单位，在自动重复开始前的时间，而速率是每秒的重复次数。如果未提供速率或延迟，则将设置为默认值。
s s 选项允许您设置屏幕保护程序参数。此选项最多接受两个数字参数、一个“blank/noblank”标志、一个“expose/noexpose”标志、一个“on/off”标志、一个“activate/reset”标志，或者“default”标志。如果未使用任何参数或使用“default”标志，则系统将设置为其默认屏幕保护程序设置。“on/off”标志仅启用或禁用屏幕保护程序功能。“activate”标志强制激活屏幕保护程序，即使屏幕保护程序已被禁用。“reset”标志强制停用屏幕保护程序（如果已激活）。“blank”标志设置首选项，即在硬件允许的情况下，使视频变为空白，而不是显示背景图案；“noblank”标志设置首选项，即显示图案，而不是使视频变为空白。“expose”标志设置首选项，即允许窗口显示（服务器可以自由地丢弃窗口内容），而“noexpose”标志设置首选项，即除非服务器可以重新生成屏幕内容而不会导致显示事件，否则禁用屏幕保护程序。屏幕保护程序功能的长度和周期参数确定服务器必须不活动多长时间才能激活屏幕保护程序，以及更改背景图案的周期，以避免屏幕烧毁。这些参数以秒为单位。如果仅提供一个数字参数，则将其用作长度。
q q 选项提供有关当前设置的信息。
-version
-version 选项打印程序版本并退出，而不执行任何其他操作。
这些设置将在您注销时重置为默认值。
请注意，并非所有 X 实现都保证支持所有这些选项。
参见
X(7)、Xserver(1)、xmodmap(1)、xrdb(1)、xsetroot(1)、xinput(1)
作者
Bob Scheifler，MIT 计算机科学实验室 David Krikorian，MIT Project Athena (X11 版本) David Dawes 和 Joe Moss 添加了 XFree86-Misc 支持 Mike A. Harris <_> 添加了 man 页面更新