vidcontrol(1) manページ

vidcontrol コマンドを用いて 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 も選択できます。後述のビデオモードサポートを参照してください。

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 は省略可能です。この場合、 vidcontrol はフォントファイルの大きさから、推測します。
MDA や CGA のような古いビデオカードはソフトウェアフォントをサポートしないことに注意してください。後述のビデオモードサポートと使用例と syscons(4) [英語] のマニュアルページも参照してください。

-g geometry

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

-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

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

-P

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

-H

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

-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 オプションを使用し、フォントファイルをカーネルにロードしてください。必要な大きさのフォントがカーネルにロードされていないと、ユーザが新規ビデオモードを設定しようとした場合に vidcontrol は失敗します。

モード

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

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

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

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

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

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

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

ビット# Ta Ta 幅

意味 7 Ta <X0000000> Ta 1 文字のブリンク 6:4 Ta <0XXX0000> Ta 3 背景色 3 Ta <0000X000> Ta 1 明い前景色 2:0 Ta <00000XXX> Ta 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) という指定です。

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

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

バイト範囲 内容

1 から 8 リテラルテキスト "SCRSHOT_"

9 ファイルフォーマットバージョン番号

10 ヘッダの残りバイト数

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

バージョン Ta バイト 意味

1 Ta 11 文字数単位の端末幅

Ta 12 文字数単位の端末の深さ

Ta 13 以降スナップショットデータ

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

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

kbdcontrol(1), vidfont(1), keyboard(4), screen(4), syscons(4) [英語], vga(4), rc.conf(5), kldload(8), moused(8), watch(8)

様々な scr2* ユーティリティが、 Ports Collection の graphics と textproc のカテゴリにあります。

blanktime	-t オプション用のタイムアウトを設定します。
font8x16 , font8x14 , font8x8
	-f オプション用のフォントファイルを指定します。
scrnmap	-l オプション用の画面出力マップファイルを指定します。

`/usr/share/syscons/fonts/*`	フォントファイル。
`/usr/share/syscons/scrnmaps/*`	画面出力マップファイル。

“	Unix is a junk OS designed by a committee of PhDs.	”
— Dave Cutler

manページ — VIDCONTROL

名称

内容

書式

解説

ビデオモードサポート

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

ビデオ出力設定

ブート時の設定

ドライバの設定

関連ファイル

使用例

関連項目

作者

寄与者

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 も選択できます。後述のビデオモードサポートを参照してください。
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 は省略可能です。この場合、 vidcontrol はフォントファイルの大きさから、推測します。 MDA や CGA のような古いビデオカードはソフトウェアフォントをサポートしないことに注意してください。後述のビデオモードサポートと使用例と syscons(4) [英語] のマニュアルページも参照してください。
-g geometry
	テキストモードの geometry を、選択可能なジオメトリに設定します。現在、 VESA_800x600 等のラスタモードのみが、本オプションをサポートします。後述の、ビデオモードサポートと使用例を参照してください。
-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
	標準入力として参照される端末デバイスに対応する、ビデオバッファの現在の内容をキャプチャします。 vidcontrol ユーティリティは、ビデオバッファの内容を標準出力に対し、生のバイナリフォーマットで出力します。このフォーマットに関する詳細は、後述のビデオバッファダンプのフォーマットを参照してください。
-P
	-p と同じですが、ビデオバッファの内容をプレインテキストでダンプし、印字不可の文字とテキスト属性情報を無視します。
-H
	-p または -P と共に使用すると、ビデオバッファの見える範囲だけではなくすべてのヒストリバッファをダンプするよう vidcontrol に指示することになります。
-r foreground background
	反転表示モードで用いる色を前景色 foreground および背景色 background に変更します。
-S on \| off
	vty の切り替えをオンまたはオフにします。 vty の切り替えがオフの場合、別の仮想端末への切り替えの試みは失敗します (デフォルトは、vty の切り替えが可能です)。この保護は、カーネルが `DDB` オプション付きでコンパイルされているときには簡単にバイパスされてしまいます。物理的に安全であるとみなされるマシン上では、おそらくカーネルデバッガを組み込むべきではないでしょう。
-s number
	現在の vty を number に設定します。
-t N \| off
	スクリーンセーバのタイムアウト値を N 秒に設定、あるいはスクリーンセーバを無効 ( off )にします。
-x
	出力に 16 進数を用います。

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

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

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