329 lines
7.7 KiB
Groff
329 lines
7.7 KiB
Groff
.\"
|
|
.\" vidcontrol - a utility for manipulating the syscons video driver
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" @(#)vidcontrol.1
|
|
.\" %FreeBSD: src/usr.sbin/vidcontrol/vidcontrol.1,v 1.24.2.3 2001/03/06 14:21:46 ru Exp %
|
|
.\"
|
|
.\" jpman %Id: vidcontrol.1,v 1.3 1997/08/04 01:31:25 mitchy Stab %
|
|
.Dd June 30, 1999
|
|
.Dt VIDCONTROL 1
|
|
.Os
|
|
.Sh 名称
|
|
.Nm vidcontrol
|
|
.Nd syscons コンソールドライバの操作ユーティリティ
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl b Ar color
|
|
.Op Fl c Ar appearance
|
|
.Op Fl d
|
|
.Op Fl f Ar size Ar file
|
|
.Op Fl g Ar geometry
|
|
.Op Fl i Cm adapter | mode
|
|
.Op Fl l Ar screen_map
|
|
.Op Fl L
|
|
.Op Fl M Ar char
|
|
.Op Fl m Cm on | off
|
|
.Op Fl r Ar foreground Ar background
|
|
.Op Fl s Ar number
|
|
.Op Fl t Ar N | Cm off
|
|
.Op Fl x
|
|
.Op Ar mode
|
|
.Op Ar foreground Op Ar background
|
|
.Op Cm show
|
|
.Sh 解説
|
|
.Nm
|
|
コマンドを用いて
|
|
.Xr syscons 4
|
|
コンソールドライバの様々なオプション、例えば、
|
|
画面モード、色、カーソル形状、画面出力マップ、
|
|
フォント、スクリーンセーバタイムアウトを設定できます。
|
|
.Pp
|
|
以下のコマンドラインオプションをサポートしています:
|
|
.Bl -tag -width indent
|
|
.It Ar mode
|
|
新しいビデオモードを選択します。
|
|
現在サポートしているモードは次の通りです:
|
|
.Ar 80x25 ,
|
|
.Ar 80x30 ,
|
|
.Ar 80x43 ,
|
|
.Ar 80x50 ,
|
|
.Ar 80x60 ,
|
|
.Ar 132x25 ,
|
|
.Ar 132x30 ,
|
|
.Ar 132x43 ,
|
|
.Ar 132x50 ,
|
|
.Ar 132x60 ,
|
|
.Ar VGA_40x25 ,
|
|
.Ar VGA_80x25 ,
|
|
.Ar VGA_80x50 ,
|
|
.Ar EGA_80x25 ,
|
|
.Ar EGA_80x43 ,
|
|
.Ar VESA_132x25 ,
|
|
.Ar VESA_132x43 ,
|
|
.Ar VESA_132x50 ,
|
|
.Ar VESA_132x60
|
|
。
|
|
.\" また、グラフィックモード
|
|
.\" .Ar VGA_320x200 ,
|
|
ラスタテキストモード
|
|
.Ar VGA_800x600
|
|
も選択できます。
|
|
後述の
|
|
.Sx ビデオモードサポート
|
|
を参照してください。
|
|
.It Ar foreground Op Ar background
|
|
テキストを表示する際の色を変更します。
|
|
前景色 (例:
|
|
.Dq vidcontrol white )
|
|
、あるいは
|
|
前景色および背景色 (例:
|
|
.Dq vidcontrol yellow blue )
|
|
を指定することにより変更できます。
|
|
後述の
|
|
.Cm show
|
|
コマンドを使用して、使用可能な色を見られます。
|
|
.It Cm show
|
|
指定したプラットフォームでサポートされている色を表示します。
|
|
.It Fl r Ar foreground background
|
|
反転表示モードで用いる色を前景色
|
|
.Ar foreground
|
|
および背景色
|
|
.Ar background
|
|
に変更します。
|
|
.It Fl b Ar color
|
|
ボーダ色を
|
|
.Ar color
|
|
に設定します。
|
|
本オプションをビデオドライバが常にサポートしているのではないかもしれません。
|
|
.It Fl c Cm normal | blink | destructive
|
|
カーソルの外観を変更します。
|
|
カーソルは、反転ブロック
|
|
.Pq Cm normal
|
|
、反転ブロックの点滅
|
|
.Pq Cm blink
|
|
、あるいは古いハードウェアカーソル様のもの
|
|
.Pq Cm destructive
|
|
のいずれかです。
|
|
後者は実際にはシミュレートしています。
|
|
.It Fl d
|
|
現在の画面出力マップを表示します。
|
|
.It Fl l Ar screen_map
|
|
画面出力マップをファイル
|
|
.Ar screen_map
|
|
から読み込んで設定します。
|
|
.Xr syscons 4
|
|
も参照してください。
|
|
.It Fl L
|
|
出力画面マップをデフォルトに設定します。
|
|
.It Fl i Cm adapter
|
|
現在のビデオアダプタに関する情報を表示します。
|
|
.It Fl i Cm mode
|
|
現在のビデオハードウェアにて使用可能なビデオモードを表示します。
|
|
.It Fl M Ar char
|
|
マウスポインタを描く基本となる文字を
|
|
.Ar char
|
|
にします。
|
|
.It Fl m Cm on | off
|
|
マウスポインタを
|
|
.Cm on
|
|
または
|
|
.Cm off
|
|
します。
|
|
テキストモードでのカット & ペースト機能を利用するために
|
|
.Xr moused 8
|
|
デーモンと共に使用します。
|
|
.It Fl f Ar size Ar file
|
|
サイズ
|
|
.Ar size
|
|
用のフォントをファイル
|
|
.Ar file
|
|
から読み込みます。
|
|
(現在のところ
|
|
.Ar size
|
|
には
|
|
.Cm 8x8 ,
|
|
.Cm 8x14 ,
|
|
.Cm 8x16
|
|
のみが指定できます)。
|
|
フォントファイルは uuencode された形式でも
|
|
生のバイナリフォーマットでも構いません。
|
|
メニューによる
|
|
.Xr vidfont 1
|
|
コマンドを使用して、好きなフォントをロード可能です。
|
|
.Pp
|
|
MDA や CGA のような古いビデオカードは
|
|
ソフトウェアフォントをサポートしないことに注意してください。
|
|
後述の
|
|
.Sx ビデオモードサポート
|
|
と
|
|
.Sx 使用例
|
|
と
|
|
.Xr syscons 4
|
|
のマニュアルページも参照してください。
|
|
.It Fl g Ar geometry
|
|
テキストモードの
|
|
.Ar geometry
|
|
を、選択可能なジオメトリに設定します。
|
|
現在、
|
|
.Ar VESA_800x600
|
|
等のラスタモードのみが、本オプションをサポートします。
|
|
後述の、
|
|
.Sx ビデオモードサポート
|
|
と
|
|
.Sx 使用例を
|
|
参照してください。
|
|
.It Fl s Ar number
|
|
現在の vty を
|
|
.Ar number
|
|
に設定します。
|
|
.It Fl t Ar N | Cm off
|
|
スクリーンセーバのタイムアウト値を
|
|
.Ar N
|
|
秒に設定、あるいはスクリーンセーバを無効 (
|
|
.Cm off
|
|
)にします。
|
|
.It Fl x
|
|
出力に 16 進数を用います。
|
|
.El
|
|
.Ss ビデオモードサポート
|
|
前記の全モードを
|
|
ビデオカードがサポートしているとは限らないことに注意してください。
|
|
.Fl i Cm mode
|
|
オプションを使用することにより、
|
|
ビデオカードがサポートしているモードを調べることが可能です。
|
|
.Pp
|
|
VESA ビデオモードもしくは 132 桁モードを使用する場合には、
|
|
VESA BIOS サポートをカーネルにリンクするか KLD にてロードする必要があることにも
|
|
注意してください (
|
|
.Xr vga 4
|
|
を参照してください)。
|
|
.Pp
|
|
25 または 30 行モード以外のビデオモードは、
|
|
特定の大きさのフォントが必要となるかもしれません。
|
|
前述の
|
|
.Fl f
|
|
オプションを使用し、フォントファイルをカーネルにロードしてください。
|
|
必要な大きさのフォントがカーネルにロードされていないと、
|
|
ユーザが新規ビデオモードを設定しようとした場合に
|
|
.Nm
|
|
は失敗します。
|
|
.Pp
|
|
.Bl -column "25 line modes" "8x16 (VGA), 8x14 (EGA)" -compact
|
|
.Sy モード Ta Sy フォントの大きさ
|
|
.Li 25 行モード Ta 8x16 (VGA), 8x14 (EGA)
|
|
.Li 30 行モード Ta 8x16
|
|
.Li 43 行モード Ta 8x8
|
|
.Li 50 行モード Ta 8x8
|
|
.Li 60 行モード Ta 8x8
|
|
.El
|
|
.Pp
|
|
同じフォントの 3 つの大きさすべて (8x8, 8x14, 8x16) を
|
|
常にロードすることが望ましいです。
|
|
.Pp
|
|
.Pa /etc/rc.conf
|
|
または
|
|
.Pa /etc/rc.conf.local
|
|
中の変数を希望のフォントファイルに設定できます。
|
|
これにより、システム起動時にこれらのフォントが自動的にロードされます。
|
|
後述を参照してください。
|
|
.Pp
|
|
ラスタテキストモード
|
|
.Ar VESA_800x600
|
|
を使用したい場合、
|
|
.Em SC_PIXEL_MODE
|
|
オプション付きでカーネルを再コンパイルする必要があります。
|
|
このカーネルオプションについての詳細は、
|
|
.Xr syscons 4
|
|
を参照してください。
|
|
.Sh ビデオ出力設定
|
|
.Ss ブート時の設定
|
|
次の変数を
|
|
.Pa /etc/rc.conf
|
|
または
|
|
.Pa /etc/rc.conf.local
|
|
に設定することにより、ブート時にビデオ出力を設定可能です。
|
|
.Pp
|
|
.Bl -tag -width foo_bar_var -compact
|
|
.It Ar blanktime
|
|
.Fl t
|
|
オプション用のタイムアウトを設定します。
|
|
.It Ar font8x16 , font8x14 , font8x8
|
|
.Fl f
|
|
オプション用のフォントファイルを指定します。
|
|
.It Ar scrnmap
|
|
.Fl l
|
|
オプション用の画面出力マップファイルを指定します。
|
|
.El
|
|
.Pp
|
|
更なる詳細は
|
|
.Xr rc.conf 5
|
|
を参照してください。
|
|
.Ss ドライバの設定
|
|
デフォルトフォントなどのデフォルト設定オプションの変更を、
|
|
ビデオカードドライバが許す場合があります。
|
|
その場合、ブート時のオプション設定の必要はなくなります。
|
|
詳細はビデオカードドライバマニュアル
|
|
.Pq 例えば Xr vga 4
|
|
を参照してください。
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /usr/share/syscons/scrnmaps/foo-bar -compact
|
|
.It Pa /usr/share/syscons/fonts/*
|
|
フォントファイル。
|
|
.It Pa /usr/share/syscons/scrnmaps/*
|
|
画面出力マップファイル。
|
|
.El
|
|
.Sh 使用例
|
|
カーネルに
|
|
.Pa /usr/share/syscons/fonts/iso-8x16.fnt
|
|
をロードしたい場合、
|
|
.Nm
|
|
を次のように実行します。
|
|
.Pp
|
|
.Dl vidcontrol -f 8x16 /usr/share/syscons/fonts/iso-8x16.fnt
|
|
.Pp
|
|
フォントファイルが
|
|
.Pa /usr/share/syscons/fonts
|
|
にある場合、ファイル名を
|
|
.Pa iso-8x16
|
|
のように短縮可能です。
|
|
.Pp
|
|
.Dl vidcontrol -f 8x16 iso-8x16
|
|
.Pp
|
|
同様に、画面出力マップファイルが
|
|
.Pa /usr/share/syscons/scrnmaps .
|
|
にある場合、
|
|
.Fl l
|
|
オプション用のファイル名を短縮可能です。
|
|
.Pp
|
|
.Dl vidcontrol -l iso-8859-1_to_cp437
|
|
.Pp
|
|
このコマンドは
|
|
.Pa /usr/share/syscons/scrnmaps/iso-8859-1_to_cp437.scm
|
|
をロードします。
|
|
.Pp
|
|
次のコマンドは、100x37 のラスタテキストモードを設定します
|
|
(LCD モデルによっては有用です):
|
|
.Pp
|
|
.Dl vidcontrol -g 100x37 VESA_800x600
|
|
.Sh 関連項目
|
|
.Xr kbdcontrol 1 ,
|
|
.Xr vidfont 1 ,
|
|
.Xr keyboard 4 ,
|
|
.Xr screen 4 ,
|
|
.Xr syscons 4 ,
|
|
.Xr vga 4 ,
|
|
.Xr rc.conf 5 ,
|
|
.Xr kldload 8 ,
|
|
.Xr moused 8
|
|
.Sh 作者
|
|
.if n .An Soren Schmidt Aq sos@FreeBSD.org
|
|
.if t .An S\(/oren Schmidt Aq sos@FreeBSD.org
|