xenial (8) chat.8.gz

Provided by: manpages-ja_0.5.0.0.20140515+dfsg-2_all bug

名称

       chat - モデム接続の確立を自動化するスクリプト言語

書式

       chat [ options ] script

解説

       chat  プログラムはコンピュータとモデムの間のメッセージ交換を制御します。 このコマンドの主な目的は、Point-
       to-Point Protocol デーモン (pppd) と リモートの pppd プロセスの間の接続を確立することです。

オプション

       -f <chat file>
              チャットスクリプトを chat file から読み込みます。このオプションと script  パラメータとは、互いに排
              他の関係にあります。  chat コマンドを実行するユーザは、このファイルのリードアクセス権を 持っていな
              ければなりません。このファイルの中では、文字列の区切りとして スペースとタブを使うことができます。

       -t <timeout>
              文字列の受信待ちのタイムアウトを指定します。もし、タイムリミットまでに  指定された文字列を受信でき
              なかった場合には、応答文字列の送信をおこないません。  この時、かわりの応答文字列が指定されていれば
              それが送信され、  指定されていなければ  スクリプトの実行が失敗します。  スクリプトの実行が失敗する
              と、chat プログラムは 0 以外のエラーコードを返して終了します。

       -r <report file>
              レポート文字列を出力するファイルを指定します。  キーワード  REPORT  を用いると、結果の文字列がこの
              ファイルに 出力されます。このオプションを指定せずに REPORT キーワードを 使用すると、レポート文字列
              は stderr に出力されます。

       -e     エコーオプションを有効にして開始します。  chat  スクリプトの特定の場所において ECHO キーワードにて
              エコーの有効および無効を切り替えることができます。  エコーが有効にされると、モデムからの出力は全て
              stderr へエコーされます。

       -v     chat  スクリプトを冗長モードで実行します。 これを指定すると、chat プログラムは、チャットスクリプト
              の実行状態、 モデムから受信した全てのテキスト、 モデムに送った全てのテキストのログをとります。  デ
              フォルトでは  syslogd(8) を介して取得します。ログの方法は -S および -s のフラグで変更できます。 冗
              長トレースのログとりは local2 ファシリティのレベル info  でおこなわれ、エラーについてはレベル  err
              が使われます。

       -V     chat スクリプトを標準エラー出力冗長モードにて実行するように要求します。 chat プログラムは、 モデム
              から受信する全てのテキストおよびモデムへ送信する全てのテキストを  標準エラー出力デバイスへログしま
              す。  chat もしくは pppd プログラムを動作させている場所では、 このデバイスは通常ローカルのコンソー
              ルです。

       -s     標準エラー出力を使用します。'-v' による全ログメッセージ および全エラーメッセージを標準エラー出力へ
              送られます。

       -S     syslog(3) を使用しません。デフォルトではエラーメッセージは syslog(3) へ送られます。-S を使用すると
              '-v' によるログおよびエラーメッセージは syslog(3) へは送られなくなります。

       -T <phone number>
              送信文字列において \T 置換メタ文字を置き換える任意の文字列を渡します。 通常は電話番号です。

       -U <phone number 2>
              送信文字列において \U 置換メタ文字を置き換える第 2 文字列を渡します。 通常は電話番号です。 2  つの
              番号を要する ISDN ターミナルアダプタでタイアルする場合に有用です。

       script -f  オプションのファイルでスクリプトが指定されていなければ、 chat プログラムに対するパラメータ文字
              列が スクリプトとして読み込まれます。

チャットスクリプト

       chat スクリプトには通信の手順を定義します。

       スクリプトは一つまたはそれ以上の「受信待ち-送信」文字列の組からなり、  それぞれは空白で区切られています。
       オプションとして「副受信待ち-副送信」文字列の組を追加することもでき、    その場合には以下の例のようにダッ
       シュで区切ります:

              ogin:-BREAK-ogin: ppp ssword: hello2u2

       これにより、chat プログラムは文字列 "ogin:" の受信待ちをおこないます。 もしもタイムアウトする前にログイン
       プロンプトを受信できなければ、  リモートホストにブレーク信号を送信し、それから文字列 "ogin:" を受信待ちし
       ます。 もしも最初の "ogin:" が受信できていれば、ブレーク信号は送信されません。

       一旦ログインプロンプトを受信すると、chat プログラムは文字列 ppp を 送信して、プロンプト "ssword:"  の受信
       を待ちます。 パスワードプロンプトを 受信すると、chat プログラムはパスワード hello2u2 を送信します。

       応答文字列に続いて、通常はキャリッジリターン文字が送られます。  「受信待ち」文字列中では、\r 文字シーケン
       スで明示的に指定しないかぎり、 キャリッジリターンは文字列に含まれません。

       目的の文字列を識別するのに必要な部分だけを受信待ち文字列に 指定するようにするべきです。  なぜなら、受信待
       ち文字列は通常ディスクファイルに記録されるため、  動的に変化する情報を含むことができないからです。 一般に
       は、時刻を表す文字列やネットワーク ID 文字列その他の 変化するデータの塊を受信待ちさせることはできません。

       通信の初期段階では、文字が化けて受信される場合があります。 この場合にも正しく認識ができるように、  文字列
       "login:" ではなく "ogin:" を待つようにします。 仮に最初の "l" という文字が化けて受信されたとしますと、 リ
       モートシステムが "login:" を送信したとしても、 その文字列は認識されないことになります。  このため、スクリ
       プトでは "login:" ではなく "ogin:" を、 "password:" ではなく "ssword:" を待つようにします。

       非常に単純なスクリプトは、以下のようになるでしょう:

              ogin: ppp ssword: hello2u2

       言いかえると、....ogin: を受信待ちして ppp を送信し、...ssword: を 受信待ちして hello2u2 を送信するという
       ことになります。

       現実問題としては、単純なスクリプトが使われることはほとんどないでしょう。 少なくとも、最初の受信待ち文字列
       が受信できなかった場合に、  副受信待ち文字列を実行するようにするべきでしょう。 たとえば、以下のスクリプト
       を考えてみます:

              ogin:--ogin: ppp ssword: hello2u2

       これは以前に使った単純なものよりも良いスクリプトでしょう。 以前のものと同様に login: プロンプトを待ちます
       が、もし受信できなかった場合には  リターンを一つ送ってから再び login: が送られてくるのを待ちます。 最初の
       ログインプロンプトがラインノイズによって化けたとしても、 空行が送られることで、通常はもう一度ログインプロ
       ンプトが送信されます。

コメント

       コメントを  chat スクリプト中に埋め込むことが可能です。 コメントは # (ハッシュ) 文字をカラム 1 から開始す
       る行です。 このようなコメント行は chat プログラムは単に無視します。 「受信待ち」文字列の最初の文字が  `#'
       文字の場合、 「受信待ち」文字列をクォートする必要があります。 文字 # (ハッシュ)から始まるプロンプトを待ち
       たい場合には、 以下のように書かねばならないでしょう:

              # Now wait for the prompt and send logout string
              ´# ' logout

中断文字列

       多くのモデムはダイヤルの結果を文字列としてレポートします。   これらの文字列は   CONNECTED    だったり、NO
       CARRIERBUSY だったりするでしょう。 モデムが相手との接続に失敗した場合には、スクリプトを終了させたいと
       思うことがよくあるでしょう。 問題は、どの文字列を次に受信するかということを、  スクリプトが正確に知ること
       はできないということです。  ある時には BUSY を受信するかもしれませんが、 次には NO CARRIER を受信するかも
       しれません。

       これらの「中断」文字列は、ABORT シーケンスにより スクリプト中に指定することができます。  それは、以下の例
       のようにスクリプトに指定します:

              ABORT BUSY ABORT 'NO CARRIER' '' ATZ OK ATDT5551212 CONNECT

       このシーケンスは受信待ちをおこないません。それから文字列 ATZ を送信します。 受信待ち文字列は OK です。 OK
       を受信すると、電話をかけるために文字列 ATDT5551212 を送信します。 受信待ち文字列は CONNECT です。  文字列
       CONNECT を受信すると、スクリプトの残りが実行されます。 一方、モデムが話中を検出すると、文字列 BUSY が送ら
       れて 中断文字列への一致が起こります。  この一致が起きたことにより、スクリプトは失敗します。  もしも文字列
       NO CARRIER を受信すると、それは同じ理由で中断されます。 どちらの文字列が受信されても、chat スクリプトは終
       了します。

CLR_ABORT 文字列

       このシーケンスは以前に設定した  ABORT  文字列をクリアします。  ABORT  文字列は規定サイズ(コンパイル時に決
       定)の配列に保持されます;  CLR_ABORT はクリアされたエントリの領域を再要求し、 新たな文字列をそこに格納でき
       るようにします。

SAY 文字列

       SAY ディレクティブにて、 script が標準エラー出力を介してユーザ端末ヘ文字列を送ることができます。 chat  が
       pppd  から起動される場合、  pppd  はデーモンとして実行され(制御端末から切り離され)、 標準エラー出力は通常
       /etc/ppp/connect-errors へとリダイレクトされます。

       SAY 文字列は、シングルクォートもしくはダブルクォートにて 括る必要があります。  出力中にキャリッジリターン
       およびラインフィードが必要な場合、 明示的に文字列中に含める必要があります。

       SAY 文字列を使用して script の進捗状況メッセージを表示することで、'ECHO OFF' しつつもユーザになにが起って
       いるのか示すことが可能です。 例を示します:

              ABORT BUSY
              ECHO OFF
              SAY "Dialling your ISP...\n"
              ´' ATDT5551212
              TIMEOUT 120
              SAY "Waiting up to 2 minutes for connection ... "
              CONNECT ''
              SAY "Connected, now logging in ...\n"
              ogin: account
              ssword: pass
              $ SAY "Logged in OK ...\n" etc ...

       このシーケンスは SAY 文字列のみユーザに示し、script の詳細は隠します。 例えば、上記  script  を実行した場
       合、ユーザが見るのは以下です:

              Dialling your ISP...
              Waiting up to 2 minutes for connection ... Connected, now logging in ...
              Logged in OK ...

レポート文字列

       レポート  文字列は ABORT 文字列に似ています。 違うのは、その文字列自身とキャリッジリターン等の 次の制御文
       字までの 全ての文字がレポートファイルに書かれるということです。

       レポート文字列はモデムのコネクト文字列の転送レートと  chat   ユーザへのリターン値を切りわけるために使えま
       す。 レポート文字列ロジックの分析は、受信待ち文字列の検索などの 他の文字列処理と同時におこなわれます。 レ
       ポート文字列と中断文字列に同じ文字列を使用することも可能ですが、 おそらくあまり使い道がないでしょう。

       レポート文字列はプログラムの終了コードに影響を及ぼしません。

       これらの「レポート」文字列は、REPORT シーケンスにより スクリプト中に指定することができます。 それは、以下
       の例のようにスクリプトに指定します:

              REPORT CONNECT ABORT BUSY '' ATDT5551212 CONNECT '' ogin: account

       このシーケンスは受信待ちをおこなわず、文字列   ATDT5551212   を送信して  電話をかけます。受信待ち文字列は
       CONNECT です。 文字列  CONNECT  を受信すると、スクリプトの残りが実行されます。  さらに、文字列  "CONNECT"
       と、それに続く接続レートなどの 任意の文字がレポートファイルに記録されます。

CLR_REPORT 文字列

       このシーケンスを使用して、以前に設定した  REPORT 文字列をクリア できます。 REPORT 文字列は規定サイズ(コン
       パイル時に決定)の配列に保持されます; CLR_REPORT はクリアされたエントリの領域を再要求し、 新たな文字列をそ
       こに格納できるようにします。

エコー

       エコーオプションはモデムからの出力を  stderr  へエコーするか否か  を制御します。 このオプションを -e オプ
       ションにて設定することができますし、 ECHO キーワードにて制御することもできます。  「受信待ち-送信」文字列
       の組  ECHO ON はエコーを有効にし、 ECHO OFF は無効にします。 このキーワードを使用してどの会話を見せるかを
       選択可能です。 例えば以下の script では:

              ABORT   'BUSY'
              ABORT   'NO CARRIER'
              ''      ATZ
              OK\r\n  ATD1234567
              \r\n    \c
              ECHO    ON
              CONNECT \c
              ogin:   account

       モデム設定結果およびダイヤル結果は見せませんが、 CONNECT (もしくは  BUSY)  メッセージ後は全てをエコーしま
       す。

回線切断

       HANGUP オプションはモデムの回線切断をエラーと扱うか否かを制御します。 このオプションは、 システムにダイヤ
       ル後に回線切断しコールバックする script 中で有効です。 HANGUP オプションは ON もしくは OFF にできます。
       HANGUP  を  OFF  に設定しモデムを回線切断  (つまりコールバックシステムへの最初のログイン)すると、chat  は
       script  の実行を続けます  (つまり呼び出しと二度目のログインプロンプトを待ちます)。 呼び出しにて接続後すぐ
       に、HANGUP ON ディレクティブを使用して 通常の回線切断シグナルの動作を戻す必要があります。 (簡単な) script
       例を示します:

              ABORT   'BUSY'
              OK\r\n  ATD1234567
              \r\n    \c
              CONNECT \c
              ´Callback login:' call_back_ID
              HANGUP OFF
              ABORT "Bad Login"
              ´Callback Password:' Call_back_password
              TIMEOUT 120
              CONNECT \c
              HANGUP ON
              ABORT "NO CARRIER"
              ogin:--BREAK--ogin: real_account
              etc ...

タイムアウト

       タイムアウトの初期値は 45 秒です。これは -t パラメータにより 変更することができます。

       次に受信待ちする文字列のタイムアウト値を変更するには、以下のようにします:

              ATZ OK ATDT5551212 CONNECT TIMEOUT 10 ogin:--ogin: TIMEOUT 5 assword: hello2u2

       これは login: プロンプトを受信待ちする際のタイムアウトを 10 秒に変更します。 さらに password プロンプトを
       受信待ちする際にはタイムアウトを 5 秒に変更します。

       一旦タイムアウト値が変更されると、次に変更されるまでは そのままになります。

EOT の送信

       チャットプログラムは特殊な応答文字列 EOT により、 リモート側へ EOT 文字を送信します。  通常、これはファイ
       ル終了を表す文字です。  EOT に続けてリターン文字が送られることはありません。 ^D シーケンスを使って EOT を
       送信文字列に埋め込むことができます。

ブレークの生成

       特殊な応答文字列  BREAK  により、ブレーク信号が送られます。  ブレークは送信側では特殊な信号として扱われま
       す。 受信側では通常、転送レートの変更要求として処理されます。 これにより、正常に login プロンプトを受信で
       きるまで ブレーク信号を送ることで、リモート側がサポートしている転送レートを  順次切り替えさせることができ
       ます。 \K シーケンスを使ってブレーク信号を送信文字列に埋め込むことができます。

エスケープシーケンス

       受信待ち文字列と応答文字列には、エスケープシーケンスを指定することができます。 応答文字列では、全てのエス
       ケープシーケンスが使えます。 受信待ち文字列では、ほとんどのエスケープシーケンスが使えます。  受信待ち文字
       列では使えないエスケープシーケンスについては、 説明文中にそのことが書かれています。

       ''     空文字列を受信待ちしたり、送信したりします。  もし、空文字列を送信しようとすると、それはリターン文
              字を送ることになります。 このシーケンスはアポストロフィ文字またはクォート文字のペアの どちらでもか
              まいません。

       \b     バックスペース文字を表します。

       \c     応答文字列の末尾の改行を抑制します。 これは末尾に改行文字のつかない文字列を送る唯一の方法です。 こ
              れは送信文字列の最後に置かれなければいけません。 たとえば、文字列 hello\c は単に h, e, l, l, o  と
              いう文字だけを送ります。 (受信待ち文字列では使えません)

       \d     1  秒のディレイです。プログラムは 1 秒のディレイのために sleep(1) を使います。 (受信待ち文字列では
              使えません)

       \K     ブレーク信号を挿入します。 (受信待ち文字列では使えません)

       \n     改行文字を送信します。

       \N     空 (null) 文字を送信します。\0 でも同じシーケンスを表すことができます。  (受信待ち文字列では使えま
              せん)

       \p     1 秒以下のポーズです。ディレイ時間は 1/10 秒です。 (受信待ち文字列では使えません)

       \q     syslogd(8) への文字列出力を抑止します。 かわりに文字列 ?????? がログに出力されます。 (受信待ち文字
              列では使えません)

       \r     キャリッジリターン文字を送信または受信待ちします。

       \s     文字列中のスペース文字を表します。  これはスペースを含む文字列をクォートしたくない場合に使います。
              シーケンス 'HI TIM' と HI\sTIM は等価です。

       \t     タブ文字を送信または受信待ちします。

       \\     バックスラッシュ文字を送信または受信待ちします。

       \ddd   8 進数 (ddd) を一つの ASCII 文字に変換し、その文字を送信します。 (受信待ち文字列では使えない文字が
              いくつかあります)

       ^C     C で表現される制御文字に置きかえられます。 例えば、文字 DC1 (17) は ^Q で表されます。  (受信待ち文
              字列では使えない文字がいくつかあります)

終了コード

       chat プログラムは以下の終了コードを返します。

       0      プログラムは正常終了しました。これは、スクリプトがエラーを起こさずに  実行されて、正常に終了したこ
              とを示します。

       1      一つまたはそれ以上のパラメータが不正であるか、受信待ち文字列が  内部バッファよりも大きすぎます。こ
              れはプログラムが正しく 実行されなかったことを示します。

       2      プログラムの実行中にエラーが発生しました。これは、何らかの理由で  リードまたはライトの操作が失敗し
              たか、chat が SIGINT のような シグナルを受信したためでしょう。

       3      「-副送信」文字列のない受信待ち文字列があり、タイムアウトイベントが 発生しました。これは、スクリプ
              トが正しくプログラムされていないか、  予期しないイベントが発生して受信待ち文字列を見つけられなかっ
              たためでしょう。

       4      ABORT 条件としてマークされた 1 番目の文字列を検出しました。

       5      ABORT 条件としてマークされた 2 番目の文字列を検出しました。

       6      ABORT 条件としてマークされた 3 番目の文字列を検出しました。

       7      ABORT 条件としてマークされた 4 番目の文字列を検出しました。

       ...    その他の終了コードも、ABORT 条件としてマークされた文字列を 検出したことを示します。

       終了コードを使うと、どのイベントによりスクリプトが終了したのかを   判断することができます。   つまり、"NO
       DIAL  TONE"  を受信したのか  "BUSY"  を受信したのかを 識別することができるということです。 最初のイベント
       (BUSY) ならばリトライする価値がありますが、 二つ目のイベント (NO DIAL TONE) だと、 おそらくリトライしても
       それがうまくいく可能性は低いでしょう。

関連項目

       UUCP  のドキュメントからも、chat スクリプトに関する 追加情報が得られるでしょう。 chat スクリプトは uucico
       プログラムで使われる スクリプトによって提示されたアイデアを基にしています。

       uucico(1), uucp(1), syslog(3), syslogd(8).

著作権

       chat プログラムは、パブリックドメインのソフトウェアです。 これは GNU のパブリックライセンス (一般公有使用
       許諾) とは異なります。 このプログラムを分割する場合には、その両方を管理するようにしてください。