html/commandline/teraterm.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 Pro コマンドライン</title>
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="../style.css" type="text/css">
</head>
<body>


<h1>Tera Term Pro コマンドライン</h1>

<p>
Tera Term Pro を起動するときのコマンドライン(ショートカットのリンク先)の形式
</p>

<pre class="syntax">
TTERMPRO [ &lt;host&gt;[[:]&lt;TCP port#&gt;] | telnet://&lt;host&gt;[:&lt;TCP port#&gt;][/] | \\&lt;server&gt;\pipe\&lt;pipe name&gt;]
         [/B] [/BAUD=&lt;speed&gt;] [/C=&lt;serial port#&gt;] [/DS] [/E] [/ES]
         [/F=&lt;setup file&gt;] [/FD=&lt;file transfer directory&gt;]
         [/H] [/I] [/K=&lt;keyboard setup file&gt;]
         [/KR=&lt;kanji code (receive)&gt;] [/KT=&lt;kanji code (transmit)&gt;]
         [/L=&lt;log file&gt;] [/LA=&lt;language&gt;] [/M=&lt;macro file&gt;] [/NOLOG]
         [/P=&lt;TCP port#&gt;] [/R=&lt;replay file&gt;] [/SPEED=&lt;speed&gt;] [/T=&lt;telnet flag&gt;]
         [/TEKICON=&lt;icon name&gt;] [/TIMEOUT=&lt;connecting timeout value&gt;]
         [/V] [/VTICON=&lt;icon name&gt;] [/W="&lt;window title&gt;"] [/WAITCOM]
         [/X=&lt;window pos (x)&gt;] [/Y=&lt;window pos (y)&gt;] [/PIPE]
         [/AUTOWINCLOSE=&lt;flag&gt;] [/OSC52=&lt;operations to permit&gt;]
         [;&lt;comment&gt;]
</pre>


<h2 id="options">オプション</h2>

<dl>
  <dt id="host">&lt;host&gt;</dt>
  <dd>ホスト名または IP アドレス</dd>

  <dt>&lt;host&gt;:&lt;TCP port#&gt;</dt>
  <dd>TCP ポート番号つき &lt;host&gt;<br>
      &lt;host&gt; と &lt;TCP port#&gt; の間に":"が置かれる。</dd>

  <dt>&lt;host&gt; &lt;TCP port#&gt;</dt>
  <dd>TCP ポート番号つき &lt;host&gt;<br>
      &lt;host&gt; と &lt;TCP port#&gt; の間に1個以上の空白文字が置かれる。<br>
      &lt;host&gt; のすぐ後にくる数字は TCP ポート番号とみなされる。</dd>

  <dt>telnet://&lt;host&gt;[:&lt;TCP port#&gt;][/]</dt>
  <dd>URL形式 - telnetハンドラ用<br>
      TCP ポート番号および末尾の / は省略可能。<br>
      TCP ポート番号が省略された場合は23となる。(設定ファイルのTCPPortの値は無視される)
  </dd>

  <dt>\\&lt;server&gt;\pipe\&lt;pipe name&gt;</dt>
  <dd>パイプ名<br>
      &lt;server&gt; 上の名前付きパイプ &lt;pipe name&gt; に接続する。<br>
      \\.\pipe\&lt;pipe name&gt; とした場合はローカルの名前付きパイプに接続する。
  </dd>

  <dt id="b">/B</dt>
  <dd>Telnet バイナリオプション</dd>

  <dt id="baud">/BAUD=&lt;speed&gt;</dt>
  <dd>
    シリアルポートのスピードを指定します。<a href="#speed">/SPEED=</a> と同じ動作です。
    指定した値が実際に反映されるかは、シリアルポートのチップ・ドライバの仕様によります。
  </dd>

  <dt id="c">/C=&lt;serial port#&gt;</dt>
  <dd>シリアルポート
      <ul>
        <li><span class="syntax">/C=1</span> COM1</li>
        <li><span class="syntax">/C=2</span> COM2</li>
        <li><span class="syntax">/C=3</span> COM3</li>
        <li>:</li>
        <li><span class="syntax">/C=256</span> COM256</li>
      </ul>
      シリアルポート番号の最大値はデフォルトで256となっています。<a href="../setup/teraterm-com.html#maxport">MaxComPort</a>で最大値を変更できます。
      </dd>

  <dt id="cdatabit">/CDATABIT=&lt;value&gt;</dt>
  <dd>シリアルポートのデータビット
      <ul>
        <li><span class="syntax">/CDATABIT=7</span> 7bit</li>
        <li><span class="syntax">/CDATABIT=8</span> 8bit</li>
      </ul>
      </dd>

  <dt id="cparity">/CPARITY=&lt;value&gt;</dt>
  <dd>シリアルポートのパリティ
      <ul>
        <li><span class="syntax">/CPARITY=none</span> none</li>
        <li><span class="syntax">/CPARITY=odd</span> odd</li>
        <li><span class="syntax">/CPARITY=even</span> even</li>
        <li><span class="syntax">/CPARITY=mark</span> mark</li>
        <li><span class="syntax">/CPARITY=space</span> space</li>
      </ul>
      </dd>

  <dt id="cstopbit">/CSTOPBIT=&lt;value&gt;</dt>
  <dd>シリアルポートのストップビット
      <ul>
        <li><span class="syntax">/CSTOPBIT=1</span> 1bit</li>
        <li><span class="syntax">/CSTOPBIT=1.5</span> 1.5bit</li>
        <li><span class="syntax">/CSTOPBIT=2</span> 2bit</li>
      </ul>
      </dd>

  <dt id="cflowctrl">/CFLOWCTRL=&lt;value&gt;</dt>
  <dd>シリアルポートのフロー制御
      <ul>
        <li><span class="syntax">/CFLOWCTRL=x</span> Xon/Xoff</li>
        <li><span class="syntax">/CFLOWCTRL=hard</span> RTS/CTS</li>
        <li><span class="syntax">/CFLOWCTRL=rtscts</span> RTS/CTS</li>
        <li><span class="syntax">/CFLOWCTRL=none</span> none</li>
        <li><span class="syntax">/CFLOWCTRL=dsrdtr</span> DSR/DTR</li>
      </ul>
      </dd>

  <dt id="cdelayperchar">/CDELAYPERCHAR=&lt;value&gt;</dt>
  <dd>シリアルポートの一文字あたりの送信遅延時間(ミリ秒)
      <ul>
        <li><span class="syntax">/CDELAYPERCHAR=n</span> nミリ秒</li>
      </ul>
      </dd>

  <dt id="cdelayperline">/CDELAYPERLINE=&lt;value&gt;</dt>
  <dd>シリアルポートの一行あたりの送信遅延時間(ミリ秒)
      <ul>
        <li><span class="syntax">/CDELAYPERLINE=n</span> nミリ秒</li>
      </ul>
      </dd>

<!--
  <dt id="duplicate">/DUPLICATE</dt>
  <dd>使用禁止（セッションの複製で内部で使われる）</dd>
-->

  <dt id="ds">/DS</dt>
  <dd>起動時に "New connection" ダイアログを表示しない</dd>

  <dt id="e">/E</dt>
  <dd>TCPLocalEcho/TCPCRSend の設定を無効にする</dd>

  <dt id="es">/ES</dt>
  <dd>起動時に "<a href="../menu/file-new.html">New connection</a>" ダイアログを表示する<br>
      Tera Term はポートの種類が TCP/IP の場合に "New connection" ダイアログを表示しますが、<a href="../setup/teraterm-ini.html#HostDialogOnStartup">HostDialogOnStartup</a> を off にすることでダイアログを表示しないようにできます。/ES オプションは HostDialogOnStartup が off になっていても "New connection" ダイアログを表示させるために用います。<br>
      Tera Term はポートの種類が Serial の場合には "New connection" ダイアログを表示しません。ポートの種類が Serial の場合に /ES オプションはなにも作用しません。</dd>

  <dt id="f">/F=&lt;setup file&gt;</dt>
  <dd>設定ファイル<br>
      <span class="syntax">/F=TERATERM.INI</span> (省略時)<br>
      ファイル名が絶対パスでないときは、ttermpro.exe からの相対パスと見なされます。</dd>

  <dt id="fd">/FD=&lt;file transfer directory&gt;</dt>
  <dd>ファイル転送用ディレクトリ</dd>

  <dt id="h">/H</dt>
  <dd>タイトルバーを隠す</dd>

  <dt id="i">/I</dt>
  <dd>起動時にアイコン状態にする<br>
      ※ログオフ状態でWindowsタスクスケジューラから実行する場合にも指定してください。
      </dd>

  <dt id="k">/K=&lt;keyboard setup file&gt;</dt>
  <dd>キーボード設定ファイル<br>
      <span class="syntax">/K=KEYBOARD.CNF</span> (省略時)<br>
      ファイル名が絶対パスでないときは、ttermpro.exe からの相対パスと見なされます。</dd>

  <dt id="kr">/KR=&lt;kanji code (receive)&gt;</dt>
  <dd>漢字コード (受信)
      <ul>
        <li><span class="syntax">/KR=SJIS</span></li>
        <li><span class="syntax">/KR=EUC</span></li>
        <li><span class="syntax">/KR=JIS</span></li>
        <li><span class="syntax">/KR=UTF8</span> UTF-8(正規化形式 C: Windows, Linux)</li>
        <li><span class="syntax">/KR=UTF8m</span> UTF-8(正規化形式 D: Mac OS X)</li>
        <li><span class="syntax">/KR=KS5601</span> 韓国語モード用</li>
      </ul></dd>

  <dt id="kt">/KT=&lt;kanji code (transmit)&gt;</dt>
  <dd>漢字コード (送信)
      <ul>
        <li><span class="syntax">/KT=SJIS</span></li>
        <li><span class="syntax">/KT=EUC</span></li>
        <li><span class="syntax">/KT=JIS</span></li>
        <li><span class="syntax">/KT=UTF8</span></li>
        <li><span class="syntax">/KT=KS5601</span> 韓国語モード用</li>
      </ul></dd>

  <dt id="l">/L=&lt;log file&gt;</dt>
  <dd>起動時にログを開始<br />
      ファイル名に含まれた<a href="../menu/setup-additional.html#LogFileNameFormat">Tera Term と strftime の書式</a>が解釈されます。<br />
      ファイル名がフルパスでないときは、<a href="../menu/setup-additional.html#LogFullpath">フルパスに変換</a>して開かれます。</dd>

  <dt id="la">/LA=&lt;language&gt;</dt>
  <dd>言語モード
      <ul>
        <li><span class="syntax">/LA=E</span> 英語</li>
        <li><span class="syntax">/LA=J</span> 日本語</li>
        <li><span class="syntax">/LA=K</span> 韓国語</li>
        <li><span class="syntax">/LA=R</span> ロシア語</li>
        <li><span class="syntax">/LA=U</span> UTF-8</li>
      </ul></dd>

  <dt id="m">/M=&lt;macro file&gt;</dt>
  <dd>起動時にマクロを実行<br>
      ファイル名が絶対パスでないときは、ttermpro.exe からの相対パスと見なされます。</dd>

  <dt id="mn">/MN=&lt;multicastname&gt;</dt>
  <dd><a href="../macro/command/sendmulticast.html">sendmulticast</a> マクロコマンドで指定するためのマルチキャスト名</dd>

  <dt id="nolog">/NOLOG</dt>
  <dd>起動時にログを開始しない</dd>

  <dt id="osc52">/OSC52=&lt;operations to permit&gt;</dt>
  <dd>
    ホストからのクリップボードアクセスで許可する操作
    <ul>
      <li><span class="syntax">/OSC52=off</span> 許可しない</li>
      <li><span class="syntax">/OSC52=read</span> 読み込みのみ許可する</li>
      <li><span class="syntax">/OSC52=write</span> 書き込みのみ許可する</li>
      <li><span class="syntax">/OSC52=readwrite</span> 読み書きを許可する</li>
    </ul>
  </dd>

  <dt id="p">/P=&lt;TCP port#&gt;</dt>
  <dd>TCP ポート番号</dd>

  <dt id="r">/R=&lt;replay file&gt;</dt>
  <dd>ファイルを再生</dd>

  <dt id="speed">/SPEED=&lt;speed&gt;</dt>
  <dd>
    シリアルポートのスピードを指定します。<a href="#speed">/BAUD=</a> と同じ動作です。
    指定した値が実際に反映されるかは、シリアルポートのチップ・ドライバの仕様によります。
  </dd>

  <dt id="t">/T=&lt;telnet flag&gt;</dt>
  <dd><ul>
        <li><span class="syntax">/T=1</span> Telnet プロトコルを使用</li>
        <li><span class="syntax">/T=0</span> Telnet プロトコルを不使用</li>
      </ul></dd>

  <dt id="tekicon">/TEKICON=&lt;icon name&gt;</dt>
  <dd>TEKウインドウのウインドウアイコンを指定する<br>
      icon nameには、設定ファイルの<a href="../setup/teraterm-win.html#WindowIcon">TEKIcon設定</a>と同じものが使用できます。</dd>

  <dt id="timeout">/TIMEOUT=&lt;connecting timeout value&gt;</dt>
  <dd>接続中の処理をキャンセルするまでの時間（秒単位）</dd>

  <dt id="v">/V</dt>
  <dd>ウィンドウが見えない状態で起動</dd>

  <dt id="vticon">/VTICON=&lt;icon name&gt;</dt>
  <dd>VTウインドウのウインドウアイコンを指定する<br>
      icon nameには、設定ファイルの<a href="../setup/teraterm-win.html#WindowIcon">VTIcon設定</a>と同じものが使用できます。</dd>

  <dt id="w">/W=&lt;window title&gt;</dt>
  <dd>ウィンドウのタイトル</dd>

  <dt id="waitcom">/WAITCOM</dt>
  <dd>起動時に/Cで指定されたシリアルポートが存在しない場合、シリアルポートの接続を待ちます。</dd>

  <dt id="x">/X=&lt;window position (x)&gt;</dt>
  <dd>ウィンドウの位置(水平)</dd>

  <dt id="y">/Y=&lt;window position (y)&gt;</dt>
  <dd>ウィンドウの位置(垂直)</dd>

  <dt id="pipe">/PIPE</dt>
  <dd>名前付きパイプへ接続する。このオプションを指定すると、以下のルールでホスト名(パイプ名)が補われる。
      <ul>
        <li>ホスト名が \ で始まる場合はそのまま使われる。</li>
        <li>ホスト名に \ が含まれない場合は先頭に \\.\pipe\ が付加される。</li>
        <li>ホスト名の先頭以外に \ が有る場合は、それより前をサーバ名、後ろをパイプ名として扱う。</li>
      </ul>
  </dd>

  <dt id="autowinclose">/AUTOWINCLOSE=&lt;flag&gt;</dt>
  <dd>自動的にウィンドウを閉じる(AutoWinClose)
      <ul>
        <li><span class="syntax">/AUTOWINCLOSE=on</span> 切断時、自動的にウィンドウを閉じる。</li>
        <li><span class="syntax">/AUTOWINCLOSE=off</span> 切断時、自動的にウィンドウを閉じない。</li>
      </ul></dd>

  <dt id="comment">;&lt;comment&gt;</dt>
  <dd>コメント。コマンドラインの最後に置く必要がある。</dd>
</dl>


<h2 id="example">例</h2>

<pre>
TTERMPRO
TTERMPRO myhost.example.com
TTERMPRO myhost.example.com:23
TTERMPRO myhost.example.com 23
TTERMPRO 192.0.2.1
TTERMPRO myhost.example.com /T=0 /P=7
TTERMPRO \\.\pipe\vmware-serial-port
TTERMPRO /C=1
TTERMPRO /F=TELNET.INI
TTERMPRO foohost.example.org /F=FOOHOST.INI
TTERMPRO /C=2 /SPEED=9600 /F=MYSETUP.INI
TTERMPRO /K=MYKEY.CNF /W="My host"
TTERMPRO /R=README.TXT ; replay a file
TTERMPRO myhost /B /X=100 /Y=50
TTERMPRO /PIPE pipename ; \\.\pipe\pipename への接続
</pre>


<h2 id="default">省略時の値</h2>

<p>
以下の省略時の値は Tera Term 設定ファイルに保存されています。
</p>

<pre>
&lt;TCP port#&gt;
/B
&lt;speed&gt;
&lt;serial port#&gt;
&lt;file transfer directory&gt;
/H
&lt;kanji code (receive)&gt;
&lt;kanji code (transmit)&gt;
&lt;language&gt;
&lt;macro file&gt;
&lt;telnet flag&gt;
&lt;icon name&gt;
&lt;window title&gt;
&lt;window pos (x)&gt;
&lt;window pos (y)&gt;
</pre>


<h2 id="notes">注</h2>

<p id="note1">
[1] &lt;telnet flag&gt; が 1 で、かつ &lt;TCP port#&gt; が 23 のときだけ、Tera Term から自発的に telnet の option negotiation を開始します。それ以外の場合でも Tera Term はホストから送られてきた telnet コマンドに応答することができます。
</p>

<p id="note2">
[2] パラメータの値にスペースや `"' を含めるためには、値全体を `"' で囲んでください。<br />
値に " を含めるためには、連続した `"'("") を指定してください。(バージョン 4.63以降)
</p>

<pre>
/F="C:\Document and Settings\user\My Documents\teraterm\server1.INI"
/W="Tera Term"
/W="""Tera Term"""
/W="Tera;Term"
</pre>


<h2 id="refs">参照</h2>

<p>
<a href="../usage/tips/not_port23.html">Telnet 用ポート番号 / 非 telnet 接続用の端末設定</a>
</p>


</body>
</html>