SETTERM(1) Linux Programmer’s Manual SETTERM(1) 名前 setterm - 端末の属性を設定する 書式 setterm [options] 説明 setterm は指定した端末の機能を呼び出す文字列を標準出力に書き出す。この とき、使用する文字列を見付けるために terminfo が参照される。しかし、(以 下で「仮想コンソールのみ」とマークされた) いくつかのオプションは、 ter- minfo(5) の機能に対応しない。この際、端末タイプが "con" または "linux" で あると、指定された機能を PC Minix の仮想コンソールドライバ上で呼び出 すための文字列が出力される。端末で実装されていないオプションは無視さ れ る。 オプション ブール値のオプション (on または off) では、デフォルトは on である。 簡 単に表すため、 black, red, green, yellow, blue, magenta, cyan, white を以下では 8-color とする。 8-color と grey と bright red, bright green, bright yellow, bright blue, bright magenta, bright cyan, bright white を 16-color とする。 様 々な色オプションが、少なくとも仮想コンソールでは、独立に設定できる。 しかし、マルチモード (例えば、 -underline や -half-bright) の設定の結果 は、ハードウェア依存である。 -term terminal_name 環境変数 TERM を上書きする。 -reset 端末リセット文字列を表示する。通常は、端末をパワーオンの状態にリ セットする。 -initialize 端末の初期化文字列を表示する。通常は、端末のレンダリングオプショ ンを設定し、その他の属性をデフォルト値に設定する。 -cursor [on|off] 端末のカーソルを on または off にする。 -repeat [on|off] (仮想コンソールのみ) キーボードリピートを on または off にする。 -appcursorkeys [on|off] (仮想コンソールのみ) カ ーソルキーアプリケーションモードを on または off に設定する。 on の場合、ESC [ A, ESC [ B などではなく、 ESC O A, ESC O B など がカーソルキーとして送信される。 vi ユーザーに対してこれがどのよ うな問題を引き起こすかについては、 Text-Terminal-HOWTO の "vi と カーソルキー" のセクションを参照すること。 -linewrap [on|off] (仮想コンソールのみ) 自動的な行の折り返しを on または off にする。 -default 端末のレンダリングオプションをデフォルトの値に設定する。 -foreground 8-color|default (仮想コンソールのみ) テキストの前景色を設定する。 -background 8-color|default (仮想コンソールのみ) テキストの背景色を設定する。 -ulcolor 16-color (仮想コンソールのみ) 下線文字の色を設定する。 -hbcolor 16-color (仮想コンソールのみ) 半輝度文字の色を設定する。 -inversescreen [on|off] (仮想コンソールのみ) スクリーンの色を反転させる。前景色と背景色を入れ換える。同様にし て、下線文字と半輝度文字も色を反転する。 -bold [on|off] 太字 (高輝度) モードを on または off にする。仮想コンソールの 場 合 は例外であるが、 -bold off により (太字・半輝度・点滅・反転と いった) 全ての属性が off にされる。 -half-bright [on|off] 薄暗色 (半輝度) モードを on または off にする (-hbcolor を参照す る こ と)。仮想コンソールの場合は例外であるが、 -half-bright off により (太字・半輝度・点滅・反転といった) 全ての属性が off に さ れる。 -blink [on|off] 点 滅モードを on または off にする。仮想コンソールの場合は例外で あるが、 -blink off により (太字・半輝度・点滅・反転といった) 全 ての属性が off にされる。 -reverse [on|off] 反 転モードを on または off にする。仮想コンソールの場合は例外で あるが、 -reverse off により (太字・半輝度・点滅・反転といっ た) 全ての属性が off にされる。 -underline [on|off] 下線モードを on または off にする (-ulcolor を参照すること)。 -store (仮想コンソールのみ) 端末の現在のレンダリングオプション (前景色と背景色) を、デフォル トにリセットする際に使用される値として保存する。 -clear [all] clear(1) と同じように、スクリーンをクリアしてカーソルをホーム ポ ジションに移動する。 -clear rest 現在のカーソル位置からスクリーンの最下行までをクリアする。 -tabs [tab1 tab2 tab3 ...] (仮想コンソールのみ) 指定された水平方向のカーソル位置にタブストップを設定する。範囲は 1 〜 160 である。引き数が指定されない場合、現在のタブストップ の 設定を表示する。 -clrtabs [tab1 tab2 tab3 ...] (仮想コンソールのみ) 指定された水平方向のカーソル位置のタブストップを解除する。範囲は 1 〜 160 である。引き数が指定されない場合、全てのタブストップ を 解除する。 -regtabs [1-160] (仮想コンソールのみ) 全てのタブストップを解除し、通常のタブストップパターンを設定する 。指定した数値の位置ごとにタブが置かれる。引き数が指定されない場 合、デフォルトは 8 である。 -blank [0-60] (仮想コンソールのみ) (APM が使用できる場合に) スクリーンが自動的に消灯されるまでの無 活動時間を分単位で指定する。引き数が指定されない場合、デフォルト は 0 である (コンソールの消灯は無効である)。 -dump [1-NR_CONS] 指 定 さ れ た 仮想コンソールのスナップショットを (属性とともに) -file オプションで指定されたファイルに書き込む。ファイルの内容は 上 書きされる。デフォルトのファイルは screen.dump である。引き数 が指定されない場合、現在の仮想コンソールをダンプする 。 -append より優先される。 -append [1-NR_CONS] -dump と似ているが、スナップショットファイルを上書きせずに追加す る。 -dump オプションが指定されていない場合にのみ機能する。 -file dumpfilename -dump または -append オプションで使うスナップショットファイル を 同じコマンドライン上で設定する。このオプションが指定されない場合 、デフォルトはカレントディレクトリの screen.dump である。 -msg [on|off] (仮想コンソールのみ) カーネル printk() メッセージをコンソールに送信するか否かを設定す る。 -msglevel 1-8 (仮想コンソールのみ) カーネル printk() メッセージのログ記録レベルを設定する。ここで指 定された以上の重要度である全てのメッセージが表示される。よって、 ログ記録レベル 0 は -msg on と同じ効果がある。また、ログ記録レベ ル 8 では全てのカーネルメッセージを表示する。 klogd(8) はカー ネ ルメッセージをログに記録するためのさらに使いやすいインターフェー スである。 -powersave on|vsync モニタを VESA vsync サスペンドモードにする。 -powersave hsync モニタを VESA hsync サスペンドモードにする。 -powersave powerdown モニタを VESA パワーダウンモードにする。 -powersave [off] モニタの VESA パワーセーブ機能を off にする。 -powerdown [0-60] VESA パワーダウンまでの時間を分単位で設定する。引き数が指定さ れ ない場合、デフォルトは 0 である (パワーダウンは行われない)。この 時間が経過すると、コンソールが消灯している場合は垂直同期サスペン ドモードになり、モニタがサスペンドモードの場合はパワーダウンモー ドになる。 -blength [0-2000] ベルの継続時間をミリ秒単位で設定する。引き数が指定されない場合、 デフォルトは 0 である。 -bfreq [freqnumber] ベルの周波数をヘルツ (Hz) で指定する。引き数が指定されない場合、 デフォルトは 0 である。 関連項目 tput(1), stty(1), terminfo(5), tty(4) バグ Minix 版と Linux 版の違いが、この文書には書かれていない。 Util-Linux 2.10 7 January 2000 SETTERM(1)
SETTERM(1) Linux Programmer’s Manual SETTERM(1) NAME setterm - set terminal attributes SYNOPSIS setterm [options] DESCRIPTION setterm writes to standard output a character string that will invoke the specified terminal capabilities. Where possible terminfo is con- sulted to find the string to use. Some options however (marked "vir- tual consoles only" below) do not correspond to a terminfo(5) capabil- ity. In this case, if the terminal type is "con" or "linux" the string that invokes the specified capabilities on the PC Minix virtual console driver is output. Options that are not implemented by the terminal are ignored. OPTIONS For boolean options (on or off), the default is on. For conciseness, an 8-color below is black, red, green, yellow, blue, magenta, cyan, or white. A 16-color is an 8-color, grey, or bright followed by red, green, yel- low, blue, magenta, cyan, or white. The various color options may be set independently, at least at virtual consoles, though the results of setting multiple modes (for example, -underline and -half-bright) are hardware-dependent. -term terminal_name Overrides the TERM environment variable. -reset Displays the terminal reset string, which typically resets the terminal to its power on state. -initialize Displays the terminal initialization string, which typically sets the terminal’s rendering options, and other attributes to the default values. -cursor [on|off] Turns the terminal’s cursor on or off. -repeat [on|off] (virtual consoles only) Turns keyboard repeat on or off. -appcursorkeys [on|off] (virtual consoles only) Sets Cursor Key Application Mode on or off. When on, ESC O A, ESC O B, etc. will be sent for the cursor keys instead of ESC [ A, ESC [ B, etc. See the "vi and Cursor-Keys" section of the Text-Terminal-HOWTO for how this can cause problems for vi users. -linewrap [on|off] (virtual consoles only) Turns automatic line-wrapping on or off. -default Sets the terminal’s rendering options to the default values. -foreground 8-color|default (virtual consoles only) Sets the foreground text color. -background 8-color|default (virtual consoles only) Sets the background text color. -ulcolor 16-color (virtual consoles only) Sets the color for underlined characters. -hbcolor 16-color (virtual consoles only) Sets the color for half-bright characters. -inversescreen [on|off] (virtual consoles only) Inverts the screen colors. Foreground and background are swapped, as are underline and half-brightness. -bold [on|off] Turns bold (extra bright) mode on or off. Except at a virtual console, -bold off turns off all attributes (bold, half-bright- ness, blink, reverse). -half-bright [on|off] Turns dim (half-brightness) mode on or off (see -hbcolor). Except at a virtual console, -half-bright off turns off all attributes (bold, half-brightness, blink, reverse). -blink [on|off] Turns blink mode on or off. Except at a virtual console, -blink off turns off all attributes (bold, half-brightness, blink, reverse). -reverse [on|off] Turns reverse video mode on or off. Except at a virtual con- sole, -reverse off turns off all attributes (bold, half-bright- ness, blink, reverse). -underline [on|off] Turns underline mode on or off (see -ulcolor). -store (virtual consoles only) Stores the terminal’s current rendering options (foreground and background colors) as the values to be used at reset-to-default. -clear [all] Clears the screen and "homes" the cursor, as clear(1). -clear rest Clears from the current cursor position to the end of the screen. -tabs [tab1 tab2 tab3 ...] (virtual consoles only) Sets tab stops at the given horizontal cursor positions, in the range 1-160. Without arguments, shows the current tab stop set- tings. -clrtabs [tab1 tab2 tab3 ...] (virtual consoles only) Clears tab stops from the given horizontal cursor positions, in the range 1-160. Without arguments, clears all tab stops. -regtabs [1-160] (virtual consoles only) Clears all tab stops, then sets a regular tab stop pattern, with one tab every specified number of positions. Without an argu- ment, defaults to 8. -blank [0-60|force|poke] (virtual consoles only) Sets the interval of inactivity, in minutes, after which the screen will be automatically blanked (using APM if available). Without an argument, gets the blank status (returns which vt was blanked or zero for unblanked vt). The force option keeps screen blank even if a key is pressed. The poke option unblank the screen. -dump [1-NR_CONS] Writes a snapshot of the given virtual console (with attributes) to the file specified in the -file option, overwriting its con- tents; the default is screen.dump. Without an argument, dumps the current virtual console. Overrides -append. -append [1-NR_CONS] Like -dump, but appends to the snapshot file instead of over- writing it. Only works if no -dump options are given. -file dumpfilename Sets the snapshot file name for any -dump or -append options on the same command line. If this option is not present, the default is screen.dump in the current directory. -msg [on|off] (virtual consoles only) Enables or disables the sending of kernel printk() messages to the console. -msglevel 1-8 (virtual consoles only) Sets the console logging level for kernel printk() messages. All messages strictly more important than this will be printed, so a logging level of 0 has the same effect as -msg on and a logging level of 8 will print all kernel messages. klogd(8) may be a more convenient interface to the logging of kernel mes- sages. -powersave on|vsync Puts the monitor into VESA vsync suspend mode. -powersave hsync Puts the monitor into VESA hsync suspend mode. -powersave powerdown Puts the monitor into VESA powerdown mode. -powersave [off] Turns off monitor VESA powersaving features. -powerdown [0-60] Sets the VESA powerdown interval in minutes. Without an argu- ment, defaults to 0 (disable powerdown). If the console is blanked or the monitor is in suspend mode, then the monitor will go into vsync suspend mode or powerdown mode respectively after this period of time has elapsed. -blength [0-2000] Sets the bell duration in milliseconds. Without an argument, defaults to 0. -bfreq [freqnumber] Sets the bell frequency in Hz. Without an argument, defaults to 0. SEE ALSO tput(1), stty(1), terminfo(5), tty(4) BUGS Differences between the Minix and Linux versions are not documented. AVAILABILITY The setterm command is part of the util-linux-ng package and is avail- able from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/. Util-Linux 2.10 7 January 2000 SETTERM(1)
Copyright(C) linux-cmd.com All Rights Reserved. Author Takayuki Yukawa