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-сервер установит громкость на ближайшее значение, которое может поддерживать аппаратное обеспечение.
-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` управляет светодиодами клавиатуры. Она управляет включением или выключением одного или всех светодиодов. Она принимает необязательное целое число, предшествующий дефис (-) или флаг `on/off`. Если параметр не указан или указан флаг `on`, все светодиоды включаются. Если указан предшествующий дефис или флаг `off`, все светодиоды выключаются. Если указано значение от 1 до 32, этот светодиод включается или выключается в зависимости от наличия предшествующего дефиса. Например, `xset led 3` включит светодиод №3. `xset -led 3` выключит его. Конкретные значения светодиодов могут относиться к разным светодиодам на разных аппаратных средствах. Если X-сервер поддерживает расширение XKEYBOARD (XKB), светодиоды можно указывать по имени индикатора XKB, указав ключевое слово `named` и имя индикатора. Например, чтобы включить светодиод Scroll Lock:
xset led named "Scroll Lock"
mouse Опция `m` управляет параметрами мыши; ее можно сокращенно записывать как `m`. Разумеется, она применяется к большинству устройств указания, а не только к мышам. Параметры для устройства указания — `acceleration` (ускорение) и `threshold` (порог). Ускорение можно указать в виде целого числа или простой дроби. Порог — просто целое число. Настройка применяется ко всем подключенным устройствам указания. Если вам нужны настройки для конкретного устройства, используйте `xinput(1)`.
По умолчанию курсор (экранное представление устройства указания) будет двигаться в `acceleration` раз быстрее, когда устройство перемещается более чем на `threshold` «микки» (условных пикселей) за 10 мс, включая небольшой переходный диапазон. Таким образом, устройство указания можно использовать для точного позиционирования при медленных движениях, но при этом можно быстро перемещать курсор по экрану, сделав резкое движение запястьем. Один или оба параметра для опции `m` можно опустить, но если указан только один параметр, он будет интерпретироваться как ускорение. Если параметры не указаны или используется флаг `default`, будут установлены системные значения по умолчанию.
Если параметр `threshold` указан и равен 0, параметр `acceleration` будет использоваться в качестве показателя степени в более естественной и непрерывной формуле, обеспечивающей точный контроль при медленных движениях, но большой диапазон при быстрых движениях и плавный переход между ними. В этом случае рекомендуется использовать значение `acceleration` от 3/2 до 3, но это не является ограничением.
В X.org X Server версии 1.6 и выше описанное выше поведение связано с профилем по умолчанию. Существуют другие профили (т. е. функции, определяющие ускорение указателя на основе скорости движения устройства) и дополнительные настройки, поэтому вышеописанное может не применяться к случаям, отличным от профиля по умолчанию. В X.org Server версии 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` отключит автоматическое повторение для клавиши «1» в верхнем ряду клавиатуры IBM PC.
Если сервер поддерживает расширение XFree86-Misc или расширение XKB, то параметр rate принимается и за ним должны следовать ноль, одно или два числовых значения. Первое указывает задержку перед началом автоматического повторения, а второе указывает частоту повторения. В случае, если сервер поддерживает расширение XKB, задержка — это количество миллисекунд, прежде чем начнется автоматическое повторение, а частота — это количество повторений в секунду. Если частота или задержка не указаны, они будут установлены на значение по умолчанию.
^ ` Опцияsпозволяет установить параметры заставки экрана. Эта опция принимает до двух числовых параметров, флагblank/noblank, флагexpose/noexpose, флагon/off, флагactivate/resetили флагdefault. Если параметры не указаны или используется флагdefault, система будет установлена на параметры заставки экрана по умолчанию. Флагиon/offпросто включают или выключают функции заставки экрана. Флагactivateпринудительно включает заставку экрана, даже если она была выключена. Флагresetпринудительно выключает заставку экрана, если она активна. Флагblankустанавливает предпочтение для выключения видео (если это возможно на аппаратном уровне), а не для отображения фонового рисунка, в то время какnoblankустанавливает предпочтение для отображения рисунка, а не для выключения видео. Флагexposeустанавливает предпочтение для разрешения обновлений окон (сервер может свободно удалять содержимое окон), в то время какnoexpose` устанавливает предпочтение для отключения заставки экрана, если сервер не может восстановить экраны без вызова событий обновления. Длительность и период для функции заставки экрана определяют, как долго сервер должен быть неактивен, чтобы заставка экрана активировалась, и период изменения фонового рисунка для предотвращения выгорания экрана. Аргументы указываются в секундах. Если указан только один числовой параметр, он будет использоваться для длительности.
^ ` Опцияq` предоставляет информацию о текущих настройках.
^ version
Опция -version выводит версию программы и завершает работу, не выполняя никаких других действий.
Эти настройки будут сброшены к значениям по умолчанию при выходе из системы.
Обратите внимание, что не все реализации X гарантированно поддерживают все эти опции.
ССЫЛКИ
X(7), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1), xinput(1)
АВТОР
Bob Scheifler, MIT Laboratory for Computer Science David Krikorian, MIT Project Athena (версия X11) Поддержка XFree86-Misc добавлена David Dawes и Joe Moss Обновления страницы руководства добавлены Mike A. Harris <_>