SETTERM

Section: User Commands (1)
Updated: May 2014
Index Return to Main Contents
 

名前

setterm - 端末の属性を設定する  

書式

setterm [options]  

説明

setterm は指定した端末の機能を呼び出す文字列を標準出力に書き出す。 このとき、使用する文字列を見付けるために terminfo が参照される。 しかし、(以下で「仮想コンソールのみ」とマークされた) いくつかのオプションは、 terminfo(5) の機能に対応しない。 この際、端末タイプが "con" または "linux" であると、 指定された機能を PC Minix の仮想コンソールドライバ上で 呼び出すための文字列が出力される。 端末で実装されていないオプションは無視される。  

オプション

ブール値のオプション (on または off) では、 デフォルトは on である。

black, red, green, yellow, blue, magenta, cyan, white を以下では 8-color とする。

8-colorgrey と、 bright を付けた red, green, yellow, blue, magenta, cyan, white16-color とする。

様々な色オプションが、少なくとも仮想コンソールでは、独立に設定できる。 しかし、マルチモード (例えば、 --underline--half-bright) の設定の結果は、ハードウェア依存である。

--appcursorkeys [on|off] (仮想コンソールのみ) カーソルキーアプリケーションモードを on または off に設定する。 on の場合、ESC [ A, ESC [ B などではなく、 ESC O A, ESC O B などがカーソルキーとして送信される。 vi ユーザーに対してこれがどのような問題を引き起こすかについては、 Text-Terminal-HOWTOvi とカーソルキー のセクションを参照すること。
--append [console_number]
--dump と似ているが、スナップショットファイルを上書きせずに追加する。 --dump オプションが指定されていない場合にのみ機能する。
--background 8-color|default
テキストの背景色を設定する。
--blank [0-60|force|poke] (仮想コンソールのみ) (APM が使用できる場合に) スクリーンが自動的に消灯されるまでの 無活動時間を分単位で指定する。 引き数が指定されない場合、消灯状態を返す (仮想端末の消灯が有効な場合は、その時間を返す。無効の場合は、0 を返す)。
force オプションを指定すると、キーを押されててもスクリーンを消灯する。
poke オプションを指定すると、スクリーンの消灯を止める。
--bfreq [number] (virtual consoles only)
ベルの周波数をヘルツ (Hz) で指定する。 引き数が指定されない場合、デフォルトは 0 である。
--blength [0-2000] (virtual consoles only)
ベルの継続時間をミリ秒単位で設定する。 引き数が指定されない場合、デフォルトは 0 である。
--blink [on|off]
点滅モードを on または off にする。 仮想コンソールの場合は例外であるが、 --blink off により (太字・半輝度・点滅・反転といった) 全ての属性が off にされる。
--bold [on|off]
太字 (高輝度) モードを on または off にする。 仮想コンソールの場合は例外であるが、 --bold off により (太字・半輝度・点滅・反転といった) 全ての属性が off にされる。
--clear [all|rest]
引き数なし、または引き数 all が指定された場合、 clear(1) と同じように、スクリーンをクリアしてカーソルをホームポジションに 移動する。 引き数 rest が指定された場合、現在のカーソル位置からスクリーンの最下行までを クリアする。
--clrtabs [tab1 tab2 tab3 ...] (仮想コンソールのみ) 指定された水平方向のカーソル位置のタブストップを解除する。 範囲は 1-160 である。 引き数が指定されない場合、全てのタブストップを解除する。
--cursor [on|off]
端末のカーソルを on または off にする。
--default
端末のレンダリングオプションをデフォルトの値に設定する。
--dump [console_number]
指定された仮想コンソールのスナップショットを (属性とともに) --file オプションで指定されたファイルに書き込む。 ファイルの内容は上書きされる。 デフォルトのファイルは screen.dump である。 引き数が指定されない場合、現在の仮想コンソールをダンプする。 --append より優先される。
--file filename
--dump または --append オプションで使う スナップショットファイルを同じコマンドライン上で設定する。 このオプションが指定されない場合、 デフォルトはカレントディレクトリの screen.dump である。 システムの最大値を越えたパス名は、切り詰められる。 linux/limits.h の PATH_MAX の値を参照すること。
--foreground 8-color|default
テキストの前景色を設定する。
--half-bright [on|off]
薄暗色 (半輝度) モードを on または off にする。 仮想コンソールの場合は例外であるが、 --half-bright off により (太字・半輝度・点滅・反転といった) 全ての属性が off にされる。
--hbcolor 16-color
半輝度文字の色を設定する。
--initialize
端末の初期化文字列を表示する。 通常は、端末のレンダリングオプションを設定し、 その他の属性をデフォルト値に設定する。
--inversescreen [on|off]
スクリーン全体で前景色と背景色を入れ換える。
--linewrap [on|off]
行がいっぱいの場合に、端末に新しい行に継続させるか否かを設定する。
--msg [on|off] (仮想コンソールのみ) カーネル printk() メッセージを コンソールに送信するか否かを設定する。
--msglevel 0-8 (仮想コンソールのみ) カーネル printk() メッセージのログ記録レベルを設定する。 ここで指定された以上の重要度である全てのメッセージが表示される。 よって、ログ記録レベル 0--msg on と同じ効果がある。 また、ログ記録レベル 8 では全てのカーネルメッセージを表示する。 klogd(8) はカーネルメッセージをログに記録するための さらに使いやすいインターフェースである。
--powerdown [0-60]
VESA パワーダウンまでの時間を分単位で設定する。 引き数が指定されない場合、デフォルトは 0 である (パワーダウンは行われない)。 この時間が経過すると、 コンソールが消灯している場合は垂直同期サスペンドモードになり、 モニタがサスペンドモードの場合はパワーダウンモードになる。
--powersave off
モニタの VESA パワーセーブ機能を off にする。
--powersave on|vsync
モニタを VESA vsync サスペンドモードにする。
--powersave powerdown
モニタを VESA パワーダウンモードにする。
--powersave hsync
モニタを VESA hsync サスペンドモードにする。
--regtabs [1-160] (仮想コンソールのみ) 全てのタブストップを解除し、通常のタブストップパターンを設定する。 指定した数値の位置ごとにタブが置かれる。 引き数が指定されない場合、デフォルトは 8 である。
--repeat [on|off] (仮想コンソールのみ) キーボードリピートを on または off にする。
--reset
端末リセット文字列を表示する。 通常は、端末をパワーオンの状態にリセットする。
--resize
最大の行と列を仮定して端末をリセットする。 これは実際の大きさとカーネルの端末ドライバーが同期していない場合に 役立つ。 最も顕著な使用法はシリアルコンソールであり、 ioctl(3) を使っていないが、バイトストリームとブレークは使っている場合である。
--reverse [on|off]
反転モードを on または off にする。 仮想コンソールの場合は例外であるが、 --reverse off により (太字・半輝度・点滅・反転といった) 全ての属性が off にされる。
--store (仮想コンソールのみ) 端末の現在のレンダリングオプション (前景色と背景色) を、 デフォルトにリセットする際に使用される値として保存する。
--tabs [tab1 tab2 tab3 ...]
指定された水平方向のカーソル位置にタブストップを設定する。 範囲は 1-160 である。 引き数が指定されない場合、現在のタブストップの設定を表示する。
--term terminal_name
環境変数 TERM を上書きする。
--ulcolor 16-color (仮想コンソールのみ) 下線文字の色を設定する。
--underline [on|off]
下線モードを on または off にする。
--version
バージョン情報を表示して、終了する。
--help
ヘルプを表示して、終了する。
 

互換性

バージョン 2.25 から setterm は昔からのハイフン 1 つの長いオプション (例えば -help) に加え、ハイフン 2 つの長いオプション (例えば --help) をサポートした。 スクリプト内では、後方互換のため、ハイフン 2 つよりハイフン 1 つを使う方が良い。 現在のところハイフン 1 つの互換性を止める計画や良い理由はない。  

関連項目

stty(1), tput(1), tty(4), terminfo(5)  

バグ

Minix 版と Linux 版の違いが、この文書には書かれていない。  

入手方法

setterm コマンドは、util-linux パッケージの一部であり、 Linux Kernel Archive から入手できる。


 

Index

名前
書式
説明
オプション
互換性
関連項目
バグ
入手方法

This document was created by man2html, using the manual pages.
Time: 08:48:21 GMT, July 31, 2019