VIDCONTROL

Section: User Commands (1)
索引 jman

BSD mandoc

名称

vidcontrol - システムコンソールの制御と設定のユーティリティ

書式

[-CdLHPpx ] [-b color ] [-c appearance ] [-f [size ] file ] [-g geometry ] [-h size ] [-i adapter | mode ] [-l screen_map ] [-M char ] [-m on | off ] [-r foreground background ] [-S on | off ] [-s number ] [-t N | off ] [mode ] [foreground [background ] ] [show ]

索引

解説

コマンドを用いて syscons(4) コンソールドライバの様々なオプション、例えば、画面モード、色、カーソル形状、画面出力マップ、フォント、スクリーンセーバタイムアウトを設定できます。

以下のコマンドラインオプションをサポートしています:

mode

新しいビデオモードを選択します。現在サポートしているモードは次の通りです: 80x25 80x30 80x43 80x50 80x60 132x25 132x30 132x43 132x50 132x60 VGA_40x25 VGA_80x25 VGA_80x50 VGA_90x25 VGA_90x30 VGA_90x43 VGA_90x50 VGA_90x60 EGA_80x25 EGA_80x43 VESA_132x25 VESA_132x43 VESA_132x50 VESA_132x60 。ラスタテキストモード VGA_800x600 も選択できます。後述の Sx ビデオモードサポートを参照してください。

foreground [background ]

テキストを表示する際の色を変更します。前景色 (例: ``vidcontrol white'' 、あるいは前景色および背景色 (例: ``vidcontrol yellow blue'' を指定することにより変更できます。後述の show コマンドを使用して、使用可能な色を見られます。

show

指定したプラットフォームでサポートされている色を表示します。

-b color

ボーダ色を color に設定します。本オプションをビデオドライバが常にサポートしているのではないかもしれません。

-C

ヒストリバッファをクリアします。

-c normal | blink | destructive

カーソルの外観を変更します。カーソルは、反転ブロック (normal ) あるいは古いハードウェアカーソル様のもの (destructive ) のいずれかです。前者は、オプションで blink にできます。後者は実際にはシミュレートしています。

-d

現在の画面出力マップを表示します。

-f [size ] file

サイズ size 用のフォントをファイル file から読み込みます。 (現在のところ size には 8x8 8x14 8x16 のみが指定できます)。フォントファイルは uuencode された形式でも生のバイナリフォーマットでも構いません。メニューによる vidfont(1) コマンドを使用して、好きなフォントをロード可能です。

size は省略可能です。この場合、はフォントファイルの大きさから、推測します。

MDA や CGA のような古いビデオカードはソフトウェアフォントをサポートしないことに注意してください。後述の Sx ビデオモードサポートと Sx 使用例と syscons(4) のマニュアルページも参照してください。

-g geometry

テキストモードの geometry を、選択可能なジオメトリに設定します。現在、 VESA_800x600 等のラスタモードのみが、本オプションをサポートします。後述の、 Sx ビデオモードサポートと Sx 使用例を参照してください。

-h size

ヒストリ (スクロールバック) バッファを size 行に設定します。

-i adapter

現在のビデオアダプタに関する情報を表示します。

-i mode

現在のビデオハードウェアにて使用可能なビデオモードを表示します。

-l screen_map

画面出力マップをファイル screen_map から読み込んで設定します。 syscons(4) も参照してください。

-L

出力画面マップをデフォルトに設定します。

-M char

マウスポインタを描く基本となる文字を char にします。

-m on | off

マウスポインタを on または off します。テキストモードでのカット & ペースト機能を利用するために moused(8) デーモンと共に使用します。

-p

標準入力として参照される端末デバイスに対応する、ビデオバッファの現在の内容をキャプチャします。ユーティリティは、ビデオバッファの内容を標準出力に対し、生のバイナリフォーマットで出力します。このフォーマットに関する詳細は、後述の Sx ビデオバッファダンプのフォーマットを参照してください。

-P

-p と同じですが、ビデオバッファの内容をプレインテキストでダンプし、印字不可の文字とテキスト属性情報を無視します。

-H

-p または -P と共に使用すると、ビデオバッファの見える範囲だけではなくすべてのヒストリバッファをダンプするように指示することになります。

-r foreground background

反転表示モードで用いる色を前景色 foreground および背景色 background に変更します。

-S on | off

vty の切り替えをオンまたはオフにします。 vty の切り替えがオフの場合、別の仮想端末への切り替えの試みは失敗します (デフォルトは、vty の切り替えが可能です)。この保護は、カーネルが DDB オプション付きでコンパイルされているときには簡単にバイパスされてしまいます。物理的に安全であるとみなされるマシン上では、おそらくカーネルデバッガを組み込むべきではないでしょう。

-s number

現在の vty を number に設定します。

-t N | off

スクリーンセーバのタイムアウト値を N 秒に設定、あるいはスクリーンセーバを無効 ( off )にします。

-x

出力に 16 進数を用います。

ビデオモードサポート

前記の全モードをビデオカードがサポートしているとは限らないことに注意してください。 -i mode オプションを使用することにより、ビデオカードがサポートしているモードを調べることが可能です。

VESA ビデオモードもしくは 132 桁モードを使用する場合には、 VESA BIOS サポートをカーネルにリンクするか KLD にてロードする必要があることにも注意してください ( vga(4) を参照してください)。

VGA 90 桁モードを使用する場合には、カーネルを VGA_WIDTH90 オプション付きでコンパイルする必要があります ( vga(4) を参照してください)。

25 または 30 行モード以外のビデオモードは、特定の大きさのフォントが必要となるかもしれません。前述の -f オプションを使用し、フォントファイルをカーネルにロードしてください。必要な大きさのフォントがカーネルにロードされていないと、ユーザが新規ビデオモードを設定しようとした場合には失敗します。

モード Ta フォントの大きさ 25 行モード Ta 8x16 (VGA), 8x14 (EGA) 30 行モード Ta 8x16 43 行モード Ta 8x8 50 行モード Ta 8x8 60 行モード Ta 8x8

同じフォントの 3 つの大きさすべて (8x8, 8x14, 8x16) を常にロードすることが望ましいです。

/etc/rc.conf または /etc/rc.conf.local 中の変数を希望のフォントファイルに設定できます。これにより、システム起動時にこれらのフォントが自動的にロードされます。後述を参照してください。

ラスタテキストモード VESA_800x600 を使用したい場合、 SC_PIXEL_MODE オプション付きでカーネルを再コンパイルする必要があります。このカーネルオプションについての詳細は、 syscons(4) を参照してください。

ビデオバッファダンプのフォーマット

ユーティリティは、 syscons(4) CONS_SCRSHOT ioctl(2) を使用し、ビデオバッファの現在の内容をキャプチャします。ユーティリティは、バージョンと追加情報を標準出力に書き出し、その後に端末デバイスの内容を続けて書き出します。

VGA ビデオメモリは、典型的には 2 バイトタプルの並びであり、 1 タプルが各文字位置に対応します。各タプルでは、最初のバイトが文字コードであり、 2 番目のバイトが文字の色属性です。

VGA の色属性バイトは次のように見えます:

ビット# 幅意味 7 <X0000000> 1 文字のブリンク 6:4 <0XXX0000>3背景色 3<0000X000>1明い前景色 2:0<00000XXX>3前景色

以下は、3 ビット幅の基本色のリストです:

0: 黒
1: 青
2: 緑
3: シアン
4: 赤
5: マゼンタ
6: 茶
7: 明るい灰

ビット 3 (明い前景色フラグ) セット時の基本色は次の通りです:

0: 暗い灰
1: 明い青
2: 明い緑
3: 明いシアン
4: 明い赤
5: 明いマゼンタ
6: 黄
7: 白

例えば、2 バイト

"65 158"

は、大文字 A (文字コード 65) を、ブリンクさせ (ビット 7 セット)、明い青の背景 (ビット 6:4) に黄色 (ビット 3:0) という指定です。

の出力には小さなヘッダがあり、そこには、出力を処理するユーティリティに有用な追加情報が含まれます。

最初の 10 バイトは、常に次の並びです。

バイト範囲内容
"1 から 8 リテラルテキスト" ``SCRSHOT_ ''
"9 ファイルフォーマットバージョン番号"
"10ヘッダの残りバイト数"

これに続くバイトは、バージョン番号依存です。

バージョンバイト意味
"1 11 文字数単位の端末幅"
" 12 文字数単位の端末の深さ"
"13 以降スナップショットデータ"

80x25 画面のダンプは (16 進数で) 次のように開始します。

53 43 52 53 48 4f 54 5f 01 02 50 19
----------------------- -- -- -- --
          |              |  |  |  ` 10 進数の 25
          |              |  |  `--- 10 進数の 80
          |              |  `------ 残りのヘッダデータのバイト数 2
          |              `--------- ファイルフォーマットバージョン 1
          `------------------------ リテラル "SCRSHOT_"

索引