html/setup/teraterm-term.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
<TITLE>ターミナルエミュレーション (Tera Term 設定ファイル)</TITLE>
<META http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="../style.css" type="text/css">
</HEAD>
<BODY>

<h1 id="backwrap">バック・ラップ (back wrap)</h1>

<p>
バック・ラップ (back wrap) 機能を有効にすると、BS 文字を受信した時に行の始めにあるカーソルが前の行の最後に移動します。バック・ラップを有効にするには、設定ファイルの [Tera Term] セクションの BackWrap 行を以下のように変更してください。
</p>

<pre>
BackWrap=on
</pre>

<pre>
省略時:
BackWrap=off
</pre>


<h1 id="beep">BEL 文字受信時の動作</h1>

<p>
BEL 文字 (ASCII $07) が受信された時に Tera Term はビープ音を鳴らします。
</p>

<p>
ビープ音を鳴らしたくない場合は、設定ファイルの [Tera Term] セクションの Beep 行を以下のように変更してください。
</p>

<pre>
Beep=off
</pre>

<p>
また、以下のようにするとビープ音を鳴らす代わりに端末画面をフラッシュさせるようになります。
</p>

<pre>
Beep=visual
</pre>

<pre>
省略時:
Beep=on
</pre>


<h1 id="C1">C1 制御文字 ($80-$9F) を使用しない</h1>

<p>
Tera Term の漢字モード(受信)を EUC か JIS にして、 Teraminal ID を VT2XX または、 VT3XX にしている場合、Shift-JIS の漢字を受信すると、ハングアップすることがあります。
</p>

<p>
これは、Shift-JIS コードの中に C1 制御文字 ($80-$9F) が含まれているために、それらを制御文字として解釈してしまい、端末の状態がおかしくなるからです。
</p>

<p>
例えば、ホストによってはログイン時などに SJIS(Shift-JIS), EUC, JIS などの数種類の漢字コードを端末に送り、どのコードが正しく表示されてるかユーザーに入力させる、ということがあり、このような場合に問題が発生します。
</p>

<p>
もし、このような状態になった場合、[Control] Reset terminal で端末の状態をリセットしてください。
</p>

<p>
このような問題をさけるには、3つの方法があります。
</p>

<ol>
 <li>漢字モード(受信)を SJIS に設定する。</li>
 <li>[Setup] Terminal で Terminal ID を VT1XX (例えば VT100) にする。</li>
 <li>設定ファイルの [Tera Term] セクションの Accept8BitCtrl 行を
<pre>
Accept8BitCtrl=off
</pre>
のように編集し、 C1 制御文字として送られてきた文字を無視するように設定する。
<pre>
省略時:
Accept8BitCtrl=on
</pre>
</li></ol>

<h1 id="C1send">C1 制御文字 ($80-$9F) を送信に使用する</h1>
<p>
Tera TermではC1制御文字を送信する時、同等の意味を持つ7ビット文字の組み合わせを使います。
</p>

<p>
もし C1 制御文字を単独の8ビット文字で送信したい場合は、設定ファイルの [Tera Term] セクションの Send8BitCtrl 行を、
</p>

<pre>
Send8BitCtrl=on
</pre>

<p>
のように変更してください。
</p>

<p>
注: この設定は初期値としてのみ使われます。ホストは S7C1T / S8C1T / DECSCL 制御シーケンスによってこの設定を変更する事ができます。
</p>

<pre>
省略時:
Send8BitCtrl=off
</pre>

<h1 id="kout">正しくない "kanji-out" を使用可能にする</h1>

<p>
一部のシステムで用いられている "kanji-out" シーケンス ^[(H は、JIS/ISO の規格に従っていません。本当に必要のある場合以外は使用しないでください。初期設定では間違いを防ぐため [Setup] terminal ダイアログボックスで ^[(H が選択できないようになっています。
</p>

<p>
^[(H を選択できるようにするには、設定ファイルの [Tera Term] セクションの AllowWrongSequence 行を、
</p>

<pre>
AllowWrongSequence=on
</pre>

<p>
のように変更してください。ダイアログボックスで選択できるようになります。
</p>

<pre>
省略時:
AllowWrongSequence=off
</pre>


<h1 id="kctrl">2バイト文字(漢字)の1バイト目と2バイト目の間に制御文字等が入った場合、1バイト目を無効にする</h1>

<p>
ホストから送られてくる2バイト文字(漢字等)の1バイト目と2バイト目の間に制御文字(例えば改行文字)等が入っても、Tera Term の初期設定では2バイト文字も制御文字も正しく取り扱われます。
</p>

<p>
設定ファイルの [Tera Term] セクションの CtrlInKanji 行を、
</p>

<pre>
CtrlInKanji=off
</pre>

<p>
のように変更すると、2バイト文字の1バイト目の後に制御文字等が来た場合、1バイト目を無効にします。この後に2バイト目が来ても、ゴミとして表示されます。2バイト文字を正しく扱わないアプリケーションでは、このようにしたほうが、画面の文字化けが少なくなる可能性があります。例えば、漢字の1バイト目の後に改行文字を出して、その後に2バイト目は出さない、というアプリケーションがあったとすると、その漢字は捨てられますが、改行文字以降に来る文字が化けずに済みます。
</p>

<pre>
省略時:
CtrlInKanji=on
</pre>


<h1 id="displayall">受信した文字をすべて表示</h1>

<p>
<!-- TODO: 内容修正 -->
受信した文字をすべて表示するようにするには、設定ファイルの [Tera Term] セクションの Debug 行を、
</p>

<pre>
Debug=on
</pre>

<p>
のように変更してください。Shift+Esc を押すとデバッグモードになります。
デバッグモードは全部で4種類あり、トグルで以下のように切り替わります。
</p>
<ul>
  <li>通常表示 -&gt; デバッグモード -&gt; 16進デバッグモード -&gt; 非表示</li>
</ul>
<p>
デバッグモードを解除するには、「通常表示」に戻してください。
</p>

<p>
デバッグモードでは、受信したデータを以下の規則で文字に変換して表示します。
</p>

<pre>
$00 - $1F    ^@ - ^_を表示
             ($00=^@ $01=^A $02=^B $03=^C $04=^D $05=^E $06=^F $07=^G 
              $08=^H $09=^I $0A=^J $0B=^K $0C=^L $0D=^M $0E=^N $0F=^O 
              $10=^P $11=^Q $12=^R $13=^S $14=^T $15=^U $16=^V $17=^W 
              $18=^X $19=^Y $1A=^Z $1B=^[ $1C=^\ $1D=^] $1E=^^ $1F=^_)
$20 - $7E    そのまま文字として表示
$7F          &lt;DEL&gt;を表示
$80 - $FF    最上位 bit を0にして、$00-$7Fと同じ規則で
             文字に変換し、反転文字として表示。
</pre>

<p>
16進デバッグモードでは、受信したデータを以下の規則で文字に変換して表示します。
</p>

<pre>
$00 - $FF    2桁の16進数値（アルファベットは大文字）と空白を表示する。
</pre>

<pre>
省略時:
Debug=off
</pre>


<h1 id="statusline">ステータスラインを使用不可にする</h1>

<p>
VT 端末のステータスラインの機能を使用不可にするには、設定ファイルの [Tera Term] セクションの EnableStatusLine 
行を以下のように変更してください。
</p>

<pre>
EnableStatusLine=off
</pre>

<p>
この場合、ステータスラインに関するエスケープシーケンスはすべて無視されます。
</p>

<pre>
省略時:
EnableStatusLine=on
</pre>


<h1 id="tekgin">TEK GIN report のマウスコード</h1>

<p>
ホスト側のアプリケーションによって、TEK window が GIN モード(クロスヘアーカーソルが現れ、座標入力が可能な状態)になったとき、あるキーを押すと TEK window はクロスヘアーカーソルの座標とキーの ASCII コードをホストへ報告します。
</p>

<p>
GIN モードでマウスの左ボタンを押したときに座標とともに送出する キーコード を設定するには、設定ファイルの [Tera Term] セクションの TEKGINMouseCode 行を、
</p>

<pre>
TEKGINMouseCode=&lt;key code&gt;
</pre>

<p>
のように変更してください。
</p>

<pre>
省略時:
TEKGINMouseCode=32
(32はSpace のASCII コード)
</pre>


<h1 id="vttab">行末のタブ表示を VT 端末互換にする</h1>

<p>
on の場合には、行末のタブの動作は VT/PuTTY/xterm 等と同じになります。タブによる自動改行は発生しません。<br>
off の場合には、行末のタブの動作は FreeBSD のコンソール (syscons) 等と同じになります。タブによる自動改行が発生します(VT非互換)。
</p>

<pre>
VTCompatTab=on
</pre>

<pre>
省略時:
VTCompatTab=off
</pre>


<h1 id="ScrollWindowClearScreen">画面クリア時にカレントバッファをスクロールアウトさせるかどうか設定する</h1>

<p>
カーソルが左上(0, 0)にある場合の &lt;ESC&gt;[J (Erase Below) は、&lt;ESC&gt;[2J (Erase All) と同じことになる。<br>
このとき、画面クリア時にカレントバッファをスクロールアウトするかどうかを設定できる。
</p>

<p>
on の場合には、&lt;ESC&gt;[2J と同様にカレントバッファをスクロールアウトする。<br>
off の場合にはカレントバッファをスクロールアウトせず、カーソル位置からスクリーンの最後までを消去する。
</p>

<pre>
省略時:
ScrollWindowClearScreen=on
</pre>


<h1 id="UnknownUnicodeCharacterAsWide">対応していないUnicodeの文字をワイド文字として扱うか設定する</h1>

<p>
受信漢字コードがUTF-8またはUTF-8mの設定の時に、Tera Termが対応していないUnicodeの文字の取り扱いを設定します。<br>
on の場合には、対応していないUnicodeの文字を "??" と表示します。<br>
off の場合には、対応していないUnicodeの文字を "?" と表示します。
</p>

<pre>
省略時:
UnknownUnicodeCharacterAsWide=off
</pre>


<h1 id="UnicodeDecSpMapping">UnicodeからDEC Special Graphicsへのマッピングを設定する</h1>

<p>
日本語環境ではTera Termは罫線や一部の記号を2カラム幅で表示します。しかし、ホスト側のアプリケーションによってはUTF-8エンコーディング時にはこれらの文字が1カラム幅で表示されると期待した出力を行う物があり、その結果画面出力が崩れる場合があります。<br>
また英語環境では罫線を+-|を使って表示したり、対応していない文字を??と表示したりします。<br>
Tera Termでは、これらの文字でDEC Special Graphicsに近い物がある物は、それを使って表示するようにする事ができ、それによって表示の崩れを軽減する事ができます。<br>
ただし、マウスで選択した時にクリップボードにコピーされるのが本来とは別の文字になってしまうという副作用があります。<br>
この設定は、受信漢字コードがUTF-8またはUTF-8mの時のみ効果を持ちます。
</p>

<p>
マップされる文字は幾つかの種類に分類されており、種類毎に変換するか設定する事が出来ます。<br>
変換する種類ごとの値を足した数値をUnicodeToDecSpMappingに指定してください。
</p>

<pre>
種類A: 罫線
値: 1
  Box drawings (U+2500-U+257F)
</pre>

<pre>
種類B: 4.58までは??と表示された文字(英語環境では何も表示されない物も含む)
値: 2
  Bullet (U+2022)
  Hyphenation point (U+2027)
  Light shade (25%) (U+2591)
  Medium shade (50%) (U+2592)
  Dark shade (75%) (U+2593)
  Black small square (U+25AA)
  Black vertical rectangle (U+25AE)
  Black very small square (U+2B1D)
</pre>

<pre>
種類C: 日本語環境では中点、英語環境ではMiddle dotとして表示される文字
       日本語環境以外では指定しない事を勧めます
値: 4
  Middle dot (U+00B7)
  One dot leader (U+2024)
  Bullet operator (U+2219)
</pre>

<pre>
省略時:
# 種類AとB
UnicodeToDecSpMapping=3
</pre>


<h1 id="StrictKeyMapping">ファンクションキー等のデフォルトの動作</h1>

<p>
Tera Term 4.62 より、ファンクションキーやエディタキーパッドのキーのデフォルトの動作が変更になりました。
これにより、キーボード設定ファイルでこれらのキー設定をoffにしたり、キーボード設定ファイルが無い場合も、VT端末の同じようなキーのシーケンスが送出されるようになりました。
</p>

<p>
キーボード設定ファイルでファンクションキー等をoffにした時に、以前のバージョンの Tera Term と同じように何も送出しないようにするには、設定ファイルの [Tera Term] セクションの StrictKeyMapping 行を以下のように変更してください。
</p>

<pre>
StrictKeyMapping=on
</pre>

<pre>
省略時:
StrictKeyMapping=off
</pre>


<h1 id="Meta8Bit">AltキーでMSBをセットした文字を送信する</h1>

<p>
AltキーでMSB(Most Significant Bit 最上位ビット)をセットした文字を送信するには、設定ファイルの [Tera Term] セクションの Meta8Bit 行を以下のようにしてください。
</p>

<pre>
Meta8Bit=raw
</pre>

<p>
また、AltキーでMSB(Most Significant Bit 最上位ビット)をセットした文字を、送信文字コードの設定に従って(UTF-8等に)変換してから送信するには、以下のようにしてください。
</p>

<pre>
Meta8Bit=text
</pre>

<p>
注: どちらの場合も、この機能を有効にするには <a href="../menu/setup-keyboard.html">Meta Key</a> の設定も有効にしておく必要があります。
</p>

<pre>
省略時:
Meta8Bit=off
</pre>


<h1 id="AltScr">代替画面バッファを無効にする</h1>

<p>
Tera Term 4.65より代替画面バッファに対応しました。この為、代替画面バッファに対応したアプリケーション(Vimやlessなど)では終了時に起動前の画面が復元されます。
</p>

<p>
代替画面バッファを無効にするには、設定ファイルの [Tera Term] セクションの AlternateScreenBuffer 行を以下のようにしてください。
</p>

<pre>
AlternateScreenBuffer=off
</pre>

<pre>
省略時:
AlternateScreenBuffer=on
</pre>


<h1 id="TerminalUID">端末固有IDを設定する</h1>

<p>
Tera Term は DA3 制御シーケンスを受信すると、端末固有の ID 応答します。端末固有 ID は 8 桁の 16 進数値で、最初の 2 桁が製造場所を、残りの 6 桁が製造場所内で端末毎に割り振られた固有の番号です。
</p>

<p>
DA3 制御シーケンスに対して応答する端末固有 ID を別の値、例えば 01234567 に変更したい場合は、設定ファイルの [Tera Term] セクションの TerminalUID 行を以下のようにしてください。
</p>

<pre>
TerminalUID=01234567
</pre>

<pre>
省略時:
TerminalUID=FFFFFFFF
</pre>


<h1 id="LockTUID">端末固有IDを変更可能にする</h1>

<p>
端末固有 ID はホスト側から DECSTUI 制御シーケンスを送る事によって変更する事が出来ますが、標準ではこの機能は無効にされています。
</p>

<p>
DECSTUI制御シーケンスによって端末固有 ID を変更できるようにしたい場合は、設定ファイルの [Tera Term] セクションの LockTUID 行を以下のようにしてください。
</p>

<pre>
LockTUID=off
</pre>

<pre>
省略時:
LockTUID=on
</pre>


<h1 id="TabStopModify">タブストップ位置の変更を禁止する</h1>

<p>
制御シーケンスによるタブストップの位置の変更を禁止したい場合は、設定ファイルの [Tera Term] セクションの TabStopModifySequence 行を以下のようにしてください。
</p>

<pre>
TabStopModifySequence=off
</pre>

<p>
また、タブストップの位置を変更する制御シーケンスの内、特定のもののみを禁止する事も出来ます。以下のタブストップ変更シーケンスの内、<strong>許可する</strong>シーケンスの略号の組み合わせを指定します。
</p>

<table>
<tr><th>略号</th> <th>シーケンス</th><th>説明</th></tr>
<tr><td>HTS7</td> <td>ESC H</td>     <td>カーソル位置にタブストップを設定する (7ビット形式)</td></tr>
<tr><td>HTS8</td> <td>0x88</td>      <td>カーソル位置にタブストップを設定する (8ビット形式)</td></tr>
<tr><td>HTS</td>  <td> - </td>       <td>HTS7とHTS8の両方</td></tr>
<tr><td>TBC0</td> <td>ESC [ 0 g</td> <td>カーソル位置のタブストップを削除する</td></tr>
<tr><td>TBC3</td> <td>ESC [ 3 g</td> <td>すべてのタブストップを削除する</td></tr>
<tr><td>TBC</td>  <td> - </td>       <td>TBC0とTBC3の両方</td></tr>
</table>

<p>
例えば、8ビット形式のタブ設定シーケンス(HTS8)のみを禁止したい場合は、設定ファイルの [Tera Term] セクションの TabStopModifySequence 行を以下のようにしてください。
</p>

<pre>
TabStopModifySequence=HTS7,TBC
</pre>

<pre>
省略時:
TabStopModifySequence=on
</pre>


<h1 id="BellLimitting">ベル過使用時の一時無効化</h1>
<p>
ホスト側から BEL 文字 (ASCII $07) が送られて来た時、Tera Term ではビープ音を鳴らしたり、画面を点滅させたりします。
</p>

<p>
誤ってバイナリファイルを表示してしまった時などで多量に BEL 文字が送られて来た時に、自動的にビープ音を鳴らすのを抑制する事が出来ます。<br>
例えば、設定ファイルの [Tera Term] セクションの BeepOverUsedTime, BeepOverUsedCount, BeepSuppressTime 行を以下のようにすると、
2 秒間に 5 回 BEL 文字が送られてくると、BEL 文字が 10 秒間送られて来なくなるまでビープ音をならさないようになります。
</p>

<pre>
; Beep over-used
BeepOverUsedTime=2
BeepOverUsedCount=5
BeepSuppressTime=10
</pre>

<pre>
省略時:
; Beep over-used
BeepOverUsedTime=2
BeepOverUsedCount=5
BeepSuppressTime=5
</pre>


<h1 id="MaxOSCBufferSize">OSC文字列用バッファサイズ</h1>
<p>
Tera Term では OSC 文字列の処理時に処理用のバッファが足りなくなると自動的にバッファを拡張するようになっています。
しかし、バグ等でホスト側が壊れた OSC 文字列送ってきた時などに際限なくメモリを消費するのを防ぐため、
OSC 文字列処理用のバッファの最大サイズを制限しています。
</p>

<p>
通常の使用ではまず問題が発生しませんが、OSC 52 (PASTE64) で多量のデータをやり取りする場合に制限にかかり、
データが途中で切れてしまう場合があります。<br>
設定ファイルの [Tera Term] セクションの MaxOSCBufferSize 行の値を以下のように増やす事によって、OSC 文字列でより多量のデータを扱えるようになります。
</p>

<pre>
MaxOSCBufferSize=16000
</pre>

<pre>
省略時:
MaxOSCBufferSize=4096
</pre>


<h1 id="ISO2022ShiftFunction">ISO/IEC 2022のシフト機能による文字セットの切り替えを禁止する</h1>

<p>
ISO/IEC 2022のシフト機能による文字セットの切り替えを禁止したい場合は、設定ファイルの [Tera Term] セクションの ISO2022ShiftFunction 行を以下のようにしてください。
</p>

<pre>
ISO2022ShiftFunction=off
</pre>

<p>
また、ISO/IEC 2022のシフト機能の内、特定のもののみを禁止する事も出来ます。以下のシフト機能の内、<strong>許可する</strong>機能の略号の組み合わせを指定します。
</p>

<table>
<tr><th>略号</th> <th>コード</th><th>説明</th></tr>
<tr><td>SI</td>   <td>0x0F</td>  <td>GL へ G0 を呼び出す</td></tr>
<tr><td>SO</td>   <td>0x0E</td>  <td>GL へ G1 を呼び出す</td></tr>
<tr><td>LS2</td>  <td>ESC n</td> <td>GL へ G2 を呼び出す</td></tr>
<tr><td>LS3</td>  <td>ESC o</td> <td>GL へ G3 を呼び出す</td></tr>
<tr><td>LS1R</td> <td>ESC ~</td> <td>GR へ G1 を呼び出す</td></tr>
<tr><td>LS2R</td> <td>ESC }</td> <td>GR へ G2 を呼び出す</td></tr>
<tr><td>LS3R</td> <td>ESC |</td> <td>GR へ G3 を呼び出す</td></tr>
<tr><td>SS2</td>  <td>0x8E / ESC N</td> <td>GL または GR へ G2 を次の一文字に限り呼び出す</td></tr>
<tr><td>SS3</td>  <td>0x8F / ESC O</td> <td>GL または GR へ G3 を次の一文字に限り呼び出す</td></tr>
<tr><td>ALL</td>  <td> - </td> <td>上記すべて</td>
<tr><td>NONE</td>  <td> - </td> <td>なし</td>
</table>

<p>
例えば、Shift-In(SI), Shift-Out(SO) のみを禁止したい場合は、設定ファイルの [Tera Term] セクションの ISO2022ShiftFunction 行を以下のようにしてください。
</p>

<pre>
ISO2022ShiftFunction=LS2,LS3,LS1R,LS2R,LS3R,SS2,SS3
</pre>

<p>
また、略号の前に - を付ける事によって指定したシフト機能を無効にする事ができます。前述の Shift-In(SI), Shift-Out(SO) のみを禁止する設定は、以下のようにも指定できます。
</p>

<pre>
ISO2022ShiftFunction=ALL,-SI,-SO
</pre>

<p>
注: この形式で指定した場合、設定の保存を行うと使用する機能のみのリストに置き換えられます。
</p>

<pre>
省略時:
ISO2022ShiftFunction=on
</pre>


</BODY>
</HTML>