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 オプションは、ベルの音量、ピッチ、および持続時間を制御します。このオプションは、最大 3 つの数値パラメーター、先頭のダッシュ (-)、または「on/off」フラグを受け入れます。パラメーターが指定されていない場合、または「on」フラグが使用された場合、システムデフォルトが使用されます。ダッシュまたは「off」が指定された場合、ベルはオフになります。数値パラメーターが 1 つだけ指定された場合、ベルの音量は、最大値のパーセンテージとしてその値に設定されます。同様に、2 番目の数値パラメーターは、ベルのピッチをヘルツで指定し、3 番目の数値パラメーターは、持続時間をミリ秒で指定します。ただし、すべてのハードウェアでベルの特性を変化させることができるわけではありません。X サーバーは、ユーザーの指定どおりにベルの特性を設定します。
bc bc オプションは、サーバーでバグ互換モードを制御します。先頭にダッシュ (-) を付けると、モードが無効になります。それ以外の場合は、モードが有効になります。さまざまな R4 以前のクライアントは、いくつかのプロトコル要求で無効な値を渡しており、R4 以前のサーバーは、これらの場合、エラーを正しく生成していませんでした。このようなクライアントを R4 サーバーで実行すると、異常終了するか、正常に動作しなくなる可能性があります。バグ互換モードは、X サーバーに特定のバグを明示的に再導入し、多くのそのようなクライアントを実行できるようにします。このモードは注意して使用する必要があります。新しいアプリケーションの開発は、このモードを無効にして行う必要があります。サーバーは、このオプションを機能させるには、MIT-SUNDRY-NONSTANDARD プロトコル拡張機能をサポートする必要があります。
c c オプションは、キーのクリック音を制御します。このオプションは、オプションの値を指定するか、先頭にダッシュ (-) を付けるか、「on/off」フラグを使用できます。パラメーターが指定されていない場合、または「on」フラグが指定された場合、システムデフォルトが使用されます。ダッシュまたは「off」フラグが指定された場合、キーのクリック音が無効になります。0 から 100 までの値が指定された場合、その値は、ハードウェアがサポートできる最も近い値に設定され、音量のパーセンテージとして使用されます。
+dpms DPMS (Display Power Management Signaling) を有効にします。
-dpms DPMS を無効にします。
dpms DPMS レベルを設定します。`standby`、`suspend`、`off` のいずれかを指定できます。
dpms force {standby|suspend|off|on}
DPMS 状態を強制的に設定します。
fp=pathlist
フォントパスを設定します。
-fp=pathlist
フォントパスから指定されたパスを削除します。
+fp=pathlist
フォントパスに指定されたパスを追加します。
fp-pathlist
フォントパスから指定されたパスを削除します。
fp+pathlist
フォントパスに指定されたパスを追加します。
fp default
フォントパスをデフォルトにリセットします。
fp rehash
フォントパスを再構築します。
-led [integer|named indicator]
LED インジケーターの設定を変更します。
led [integer|named indicator]
LED インジケーターの設定を変更します。
led {on|off}
LED インジケーターをオンまたはオフにします。
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 xset を終了します。
-version
バージョン情報を表示します。
-dpms -dpms オプションは、ディスプレイ電力管理シグナリング (DPMS) 機能の無効化を行います。
+dpms +dpms オプションは、ディスプレイ電力管理シグナリング (DPMS) 機能の有効化を行います。
dpms フラグ...
dpms オプションを使用すると、ディスプレイ電力管理シグナリング (DPMS) パラメータを設定できます。このオプションでは、最大 3 つの数値、または `force` フラグの後に DPMS 状態を指定できます。`force` フラグは、サーバーに指定された DPMS 状態に即座に切り替えるように指示します。DPMS 状態は、`standby`、`suspend`、`off`、または `on` のいずれかになります。数値が指定された場合、それらは非アクティブ状態の後の各モードがアクティブになるまでの時間 (秒単位) を設定します。最初に指定された値は `standby` モード用、2 番目は `suspend` モード用、3 番目は `off` モード用です。これらの値を設定すると、DPMS 機能が暗黙的に有効になります。0 を指定すると、特定のモードが無効になります。
fp= パス,...
fp= オプションは、サーバーによって解釈される、パス引数内のエントリにフォントパスを設定します。通常、これらはディレクトリ名またはフォントサーバー名ですが、解釈はサーバーに依存します。
fp default
default 引数は、フォントパスをサーバーのデフォルトにリセットします。
fp rehash
rehash 引数は、フォントパスを現在の値にリセットし、サーバーに現在のフォントパス内のフォントデータベースを再読み込みさせます。これは、通常、フォントディレクトリに新しいフォントを追加した後 (mkfontdir を実行してフォントデータベースを再作成した後) にのみ使用されます。
-fp または fp-
-fp および fp- オプションは、現在のフォントパスから要素を削除します。これらには、カンマで区切られたエントリのリストが続きます。
+fp または fp+
+fp および fp+ オプションは、現在のフォントパスに要素を追加します。これらには、カンマで区切られたエントリのリストが続きます。
led
led オプションは、キーボード LED を制御します。これにより、1 つまたはすべての LED のオン/オフを制御できます。オプションの整数、先行するダッシュ (-) 、または 'on/off' フラグを指定できます。パラメータが指定されていない場合、または 'on' フラグが指定された場合、すべての LED がオンになります。先行するダッシュまたは 'off' フラグが指定された場合、すべての LED がオフになります。1 から 32 までの値が指定された場合、先行するダッシュの有無に応じて、その LED がオンまたはオフになります。たとえば、「xset led 3」は LED #3 をオンにします。「xset -led 3」は LED #3 をオフにします。特定の LED の値は、ハードウェアによって異なる LED を指す場合があります。X サーバーが XKEYBOARD (XKB) 拡張機能をサポートしている場合、LED は XKB インジケーター名で参照でき、`named` キーワードとその後にインジケーター名を指定します。たとえば、Scroll Lock LED をオンにするには、次のようにします。
xset led named "Scroll Lock"
mouse mオプションは、マウスのパラメータを制御します。これは'm'に省略できます。もちろん、これはマウスだけでなく、ほとんどのポインティングデバイスにも適用されます。ポインティングデバイスのパラメータは、「加速度」と「閾値」です。加速度は整数または単純な分数として指定できます。閾値は整数です。この設定は、接続されているすべてのポインティングデバイスに適用されます。デバイス固有の設定が必要な場合は、xinput(1)を使用してください。
デフォルトでは、ポインタ（画面上のポインティングデバイスの表現）は、デバイスが10ミリ秒以内に「閾値」マイクロメートル（つまり、本来であればピクセルになるはずの単位）以上移動した場合、「加速度」倍の速度で移動します。これには、わずかな移行範囲が含まれます。このようにすることで、ポインティングデバイスは、ゆっくりと移動させたときに正確な配置に使用でき、手首を軽く動かすだけで画面上を移動できるようになります。mオプションの1つまたは両方のパラメータを省略できますが、1つだけ指定した場合は、それが加速度として解釈されます。パラメータを指定しない場合、または「default」フラグを使用した場合、システムのデフォルト設定が使用されます。
「閾値」パラメータが指定されていて、その値が0の場合、「加速度」パラメータは、より自然で連続的な数式における指数として使用され、ゆっくりとした動きに対して正確な制御を提供し、速い動きに対して大きな範囲を提供し、中間的な動きに対して漸進的な移行を提供します。この場合、推奨される「加速度」の値は3/2から3ですが、これに限定されません。
X.org X Server 1.6以降では、これまでの説明で述べられている動作は、デフォルトプロファイルに関連付けられています。他のプロファイル（つまり、デバイスの速度からポインタの加速度を決定する関数）と追加の設定があり、そのため上記の説明は、デフォルト以外のケースには適用されない場合があります。
X.org Server 1.7では、これらは入力デバイスのプロパティとして利用できます（xinputを参照）。
p pオプションは、ピクセルのカラー値を制御します。パラメータは、10進数で表されたカラーマップエントリ番号と、カラー指定です。一部のサーバーでは、ルート背景色を変更するために、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' パラメータが受け入れられ、0、1、または 2 つの数値がそれに続く必要があります。最初の値は、自動繰り返しが開始されるまでの遅延時間を指定し、2 番目の値は、繰り返しレートを指定します。XKB 拡張をサポートするサーバーの場合、遅延は自動繰り返しが開始されるまでのミリ秒単位の時間で、レートは 1 秒あたりの繰り返し回数です。レートまたは遅延が指定されていない場合、デフォルト値に設定されます。
s 's' オプションを使用すると、スクリーンセーバーのパラメータを設定できます。このオプションは、最大 2 つの数値パラメータ、'blank/noblank' フラグ、'expose/noexpose' フラグ、'on/off' フラグ、'activate/reset' フラグ、または 'default' フラグを受け入れます。パラメータが指定されていない場合、または 'default' フラグが使用された場合、システムはデフォルトのスクリーンセーバー特性に設定されます。'on/off' フラグは、単にスクリーンセーバー機能をオンまたはオフにします。'activate' フラグは、スクリーンセーバーがオフになっていた場合でも、スクリーンセーバーを強制的にアクティブにします。'reset' フラグは、スクリーンセーバーがアクティブな場合、スクリーンセーバーを強制的に非アクティブにします。'blank' フラグは、ハードウェアで実行できる場合、ビデオをブランク表示する（背景パターンを表示するのではなく）ように設定し、'noblank' フラグは、ビデオをブランク表示するのではなく、パターンを表示するように設定します。'expose' フラグは、ウィンドウの露出を許可するように設定します（サーバーは自由にウィンドウの内容を破棄できます）。'noexpose' フラグは、サーバーが露出イベントを引き起こすことなくスクリーンを再生成できる場合にのみ、スクリーンセーバーを無効にするように設定します。スクリーンセーバー関数の長さと期間のパラメータは、サーバーが非アクティブになってからスクリーンセーバーがアクティブになるまでの時間と、画面の焼き付きを防ぐために背景パターンを変化させる間隔を決定します。引数は秒単位で指定されます。数値パラメータが 1 つだけ指定された場合、それは長さとして使用されます。
q '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 によって追加されました man ページの更新は、Mike A. Harris <_> によって追加されました