expect と interact は両方とも、カレントプロセスが exit した時点を検出して、明示しなくても close を実行する。 しかし、"exec kill $pid" などのように、あなたがプロセスを kill している なら、明示的に close を呼ぶ必要がある。

-onexec フラグを指示すると、新しい spawn が起きた時またはプロセスが重ねられた時に 前の spawn を閉じるべきかどうかを指示することができる。 前の spawn id で開いたままにしておきたければ、値 0 を用いる。 0 でない整数を指示すると、新しいプロセス中では前の spawn はクローズされる (デフォルト)。

-slave フラグを指示すると、その spawn id の抱えているスレーブの spawn もクローズする。 ("spawn -pty"を参照) コネクションがクローズされると、スレーブはオープン状態であっても クローズされる。

コネクションのクローズが明示されていたか否かに全然関わりなく、 関係するカーネルプロセススロットをクリアしてしまいたければ、 wait を呼ぶこと。 close は、 wait を呼ばない。プロセスへのコネクションをクローズすると、そのプロセスが exit するという保証がないからである。 もっと知りたければ、 wait の項を参照すること。

引数がない場合、デバッガが走っていれば 1 を、そうでなければ 0 を返す。

引数が 1 なら、デバッガが起動される。引数が 0 なら、デバッガが停止する。 引数 1 の前に -now フラグがあれば、デバッガは即座に起動される(つまり、 debug コマンドそのものの途中で)。そうでなければ、デバッガは次の Tcl コマンドから 起動される。

debug コマンドはトラップを変更しない。 -D フラグをつけて起動させた場合とはそこが違う(上記参照)。

デバッガについては、README ファイルと関連項目を参照すること。

    if {[fork]!=0} exit
    disconnect
    . . .

    send_user "password?\ "
    expect_user -re "(.*)\n"
    for {} 1 {} {
        if {[fork]!=0} {sleep 3600;continue}
        disconnect
        spawn priv_prog
        expect Password:
        send "$expect_out(1,string)\r"
        . . .
        exit
    }

-onexit フラグは、続く引数を exit ハンドラとして用いる。 引数がなければ、exit ハンドラは何もしない。

-noexit フラグを指定すると Expect は、exit の準備をして OS へ制御を返す直前に停止する。 ユーザーの定義した exit ハンドラは、Expect 自身の内部ハンドラと同じように 実行される。 それ以上 Expect のコマンドが実行されるべきではない。あなたが他の Tcl Extension を Expect につけている場合にこの機能は意味がある。 Expect の exit がもう一度呼び出されると(こういう場合も起こり得る)、ハンドラは処理を 返さない。

exit する際に、全ての spawn されたプロセスへのコネクションはクローズされる。 クローズは EOF 検出によって行なわれる。 exit は、普通の exit(2) が行なう以上のことはしない。 それで、spawn されたプロセスが EOF をチェックしない場合、そのプロセスは 走り続ける。(spawn されたプロセスへ送られたシグナルを判断するといったこと には複数の条件が関わってくる。これらは、システム依存であり、典型的な動作は 各システムの exit(3) のドキュメントに記述されている。)

status (指定がないときは、0 )は、 Expect の、終了ステータスとしてシステムに返される。 exit は、スクリプトの終りに達すると、書いていなくても実行される、

-info フラグは、最後に指定された info フラグでない引数の内容を返す。

-leaveopen フラグは、spawn id をオープンしたままにしておく。 wait が、その spawn id に対して実行されねばならない。

    expect {
        busy               {puts busy\n ; exp_continue}
        failed             abort
        "invalid password" abort
        timeout            abort
        connected
    }

    expect {
        busy       {puts busy\n ; exp_continue}
        -re "failed|invalid password" abort
        timeout    abort
        connected
    }

多くのエディタでは、^ と $ は行頭、行末に正確にマッチする。 しかし、expect は行指向ではないので、(行ではなく)データの始まりと終りに マッチする。 ("EXPECTヒント"内の、バッファリングの消化不良に関する部分を参照のこと)

-ex フラグは、"正確に(exact)"指示された文字列にマッチする。 * や ^ などの解釈は行なわれない。(ただし、通常の Tcl 展開は行なわれる)。 Exact パターンは常に固定されている。

patlist に、キーワード null を指定すると、ヌル文字が許可され ( remove_nulls コマンドを通して)、ヌル文字(ASCII 0)にマッチする。 glob や regexp では 0 バイトにマッチすることができない。

パターン(あるいは、eol, full_buffer)にマッチすると、マッチした部分の文字列か、 その前のマッチしなかった文字列が、変数 expect_out(buffer) に保存される。

9 個までのマッチした部分文字列は、変数 expect_out(1,string) から expect_out(9,string) に保存される。 -indices フラグをパターンの前で指定すると、マッチした部分文字列の 開始位置と終了位置が( lrange の引数として使える形で)、変数 expect_out(X,start) と expect_out(X,end) に保存される。 X は数字で 0 〜 9 まで。 0 はパターン全体がマッチした部分を指示する。 例えば、プロセスが"abcdefgh\n"を出力し、以下の形:

    expect "cd"

    set expect_out(0,string) cd
    set expect_out(buffer) abcd

    expect -indices -re "b(b*).*(k+)"

    set expect_out(0,start) 1
    set expect_out(0,end) 10
    set expect_out(0,string) bbbcabkkkk
    set expect_out(1,start) 2
    set expect_out(1,end) 3
    set expect_out(1,string) bb
    set expect_out(2,start) 10
    set expect_out(2,end) 10
    set expect_out(2,string) k
    set expect_out(buffer) abbbcabkkkk

マッチした出力を送ってきたプロセスへの spawn id は、 expect_out(spawn_id) に保存される。

-timeout フラグは、この expect コマンドの中の timeout 時刻を timeout 変数でなく 指示された値に設定する。

デフォルトでは、パターンはカレントプロセスからの出力にマッチさせるのだが、 -i フラグを設定すると、指定された spawn_id リストに対応するプロセス群からの出力に マッチさせることができる。(次の -i での指定があるまで有効である。) spawn_id リストは、スペースで区切った spawn_id のリストか、そのような値を持つ 変数への参照でなくてはならない。

例えば、以下の例はカレントプロセスからの"connected"と $proc2 と言う名前の spawn_id からの"busy","failed","invalid password" を待ち受ける。

    expect {
        -i $proc2 busy {puts busy\n ; exp_continue}
        -re "failed|invalid password" abort
        timeout abort
        connected
    }

-i フラグには、グローバル変数の名前を指定することもできる。その場合、 その変数は、spawn id のリストである。変数は変わるたびに読み直される。 こうすることで、コマンドが実行されている間に I/O ソースを変更すること ができる。この方法で指定される spawn id を"間接(indirect)" spawn id と呼ぶ。

break や continue などのアクションは、制御構造(すなわち、 for,proc )内で通常通りの振舞いをする。

exp_continue コマンドは、 expect ループから抜けるような状況で実行を続けさせる。

    expect {
        Password: {
            stty -echo
            send_user "password (for $user) on $host: "
            expect_user -re "(.*)\n"
            send_user "\n"
            send "$expect_out(1,string)\r"
            stty echo
            exp_continue
        } incorrect {
            send_user "invalid password or account\n"
            exit
        } timeout {
            send_user "connection to $host timed out\n"
            exit
        } eof {
            send_user \
                "connection to host failed: $expect_out(buffer)"
            exit
        } -re $prompt
    }

    stty raw -echo
    expect_after {
        -i $user_spawn_id
        "p" {send "\r\r\r"; exp_continue}
        "+" {incr foo; exp_continue}
        "i" {interact; exp_continue}
        "quit" exit
    }

expect_background アクションが、評価される時、同じ spawn id を持つ バックグラウンドプロセスはブロックされる。 アクションが完了すると、プロセスがアンブロックされる。 バックグラウンドプロセスがブロックされている間は、 (フォアグラウンドの) expect で、同じ spawn id に接続することができる。 逆に、 expect_background がブロックされていない間は expect することができない。 特定の spawn id への expect_background は、同一 spawn id への新しい expect_background を指定すると 削除される。 パターンをつけない expect_background を指定することで、バックグラウンドでパターンマッチさせること をやめさせられる。

パターンが指示されなかった場合、spawn id は どのパターンでもチェックされない。

-i フラグをさらに指定しない限り、 expect_before パターンは、 expect_before が実行された時に定義されたパターンにマッチする。

-info フラグは expect_before から、マッチパターンの現在の状態を復帰させる。 デフォルトでは、現在の spawn id に報告する。オプションの spawn id を 指定することもできる。例えば、

    expect_before -info -i $proc

spawn id を指示する代わりに、"-all"フラグを使って、 全ての spawn id に "-info" の報告をさせることができる。

-info フラグを使った時の出力結果は、expect_before への引数として 再利用できる。

    set CTRLZ \032
    interact {
        -reset $CTRLZ {exec kill -STOP [pid]}
        \001   {send_user "you typed a control-A\n";
                send "\001"
               }
        $      {send_user "The date is [exec date]."}
        \003   exit
        foo    {send_user "bar"}
        ~~
    }

-re フラグは、正規表現スタイルのパターンとして文字列を解釈する。 この場合、マッチした部分文字列は interact_out に保存される。 expect が、その出力を変数 expect_out に保存するのと似たようなものである。 -indices フラグも同じようにサポートされる。

パターン eof は、end-of-file にマッチした場合にアクションを実行する。 複数に分かれた eof パターンには -output フラグが続いても良い。その場合、出力が書かれている間に eof が検出されると アクションを実行する。 eof のデフォルトアクションは"return"である。 それで、 interact は、EOF を見つけると復帰する。

timeout パターンは、(秒で表現された)タイムアウトにマッチし、アクションを実行する。 timeout パターンは、最後に指示されたプロセスに適用される。タイムアウトには デフォルトの値はない。(expect内で使われる)特殊な変数"timeout"は、 このタイムアウトと関係しない。

例えば、以下の記述は一時間以上タイプしなかったユーザーを自動的にログアウト させる。その前にシステムから頻繁にメッセージを受けとる:

    interact -input $user_spawn_id timeout 3600 return -output \
        $spawn_id 

パターン null と nulls は、( remove_nulls コマンドを通して)、アスキーの 0 にマッチした場合にアクションを実行する。 glob や regexp で 0 バイトにマッチさせることはできない。

このパターンの前に -iwrite フラグをつけると、 変数 interact_out(spawn_id) にパターン(あるいはeof)にマッチした spawn_id が設定される。

break や continue といったアクションは、制御構造 (すなわち、 for や proc )の中で、通常通りに動く。 しかし、 return は、interact を呼出元に復帰させる。一方、 inter_return は、 interact をその呼びだし元内に復帰させる。例えば、"proc foo" は interact を呼ぶ。interact が、さらに、 inter_return を実行すると proc foo が復帰する。(これは、 interact が、 interpreter を呼んで return とタイプすると、そのinteractは継続するが、 inter_return すると、その呼出元に復帰してしまうということである。)

    interact {
        -echo ~g {getcurdirectory 1}
        -echo ~l {getcurdirectory 0}
        -echo ~p {putcurdirectory}
    }

このフラグは、パターンをエコーバックする時に有効である。 例えば、以下は誰かが(ヘイズモデムを)ダイアルするのを監視するのに 使われる。"atd"が見える度にスクリプトが残りのラインをログする。

    proc lognumber {} {
        interact -nobuffer -re "(.*)\r" return
        puts $log "[exec date]: dialed $interact_out(1,string)"
    }
    interact -nobuffer "atd" lognumber

    spawn login
    set login $spawn_id
    spawn tip modem
    # dial back out to user
    # connect user to login
    interact -u $login

2つの入力プロセスはデフォルトで $spawn_id と $user_spawn_id に出力される。 もし、 -input フラグが -output フラグなしで指定された場合、プロセスからの文字は捨てられる。

-i フラグは、現在の spawn_id を書き換える。 ただし、 -input または -output フラグが使われていない場合である。-i フラグは -o フラグを含む。

間接 spawn id を使って会話しているプロセスを切替えることが可能である。 (間接 spawn id は、expect コマンドの項で説明した) 間接 spawn id は、-i, -u, -input, -output フラグで指定できる。

ファイル名の代わりに、Tcl ファイル識別子を指定すると、 -open や -leaveopen フラグが使える。 spawn コマンドと同様だ(より詳しくは、 spawn を参照)

-a フラグは、 log_user コマンドによって抑止されたログに出力を強制するものである。

デフォルトでは、 log_file コマンドは古い記録を消して書き直したりせずに 追記 する。 ログオフや複数のログを書く時に都合が良いように。 ファイルを消して書き直す時は -noappend フラグを使う。

-info フラグは、最後にログした内容を返す(最後が-infoフラグ付きだったら、 その前の内容)。

-info フラグは、最後にログした内容を返す(最後が -info フラグ付きだったら、 その前の内容)。

    overlay -0 $spawn_id -1 $spawn_id -2 $spawn_id chess

ヌルを取り除くかどうかによらず、 Expect は、ログと標準出力にはヌルが記録される。

    send "hello world\r"

-- フラグは、続く引数をフラグと解釈せず文字列として解釈される。 全体としてフラグに見えなくても"--"が前についた文字列はフラグとして 扱われてしまう。このフラグは処理されていない文字列がフラグとして 扱われるのを防ぐ。 ("-"で始まる文字は全て将来のオプションとして予約されている。)

-i フラグは、名前つきの spawn_id に文字列を送ることを宣言する。 その spawn_id が user_spawn_id であれば、端末はraw モードに入り、文字列中の改行が復帰改行シーケンスに 変換される。それで、外からは 端末が cooked モードとなっているように 見える。 -raw フラグは、この変換を抑止する。

-null フラグは、ヌル文字を送る(0 バイト)。デフォルトでは、ヌル文字を 1つ送る。 -null に続く整数はヌル文字をいくつ送るかを指示する。

-break フラグは、ブレーク状態を作る。spawn id が"spawn -open"で指示した tty デバイスを参照する場合のみ意味がある。tip などのプロセスを spawn する場合、tip の都合で ブレーク状態を作るべきである。

-s フラグは、出力を強制的に"遅く"する。結果、コンピュータが打ち込んでいる バッファに人間が打ち込んでしまう状況を避けることができる。この出力は 変数"send_slow"の値で制御される。この変数は二つの要素を持つリストである。 最初の要素は、アトミックに送るバイト数である。2 番めの要素はアトミックに送る 間隔(秒)である。例えば、 "set send_slow {10 .001}" は "send -s" に 10 文字送る毎に1ミリ秒待つように指示する。

-h フラグは、人間の実際の入力に似せて send を行なう。(アルゴリズムは、 Weibull distribution に基づいていて、この特定のアプリケーション Expect? に 合わせるための修正が行なわれている。) この出力は変数"send_human"の値で制御されていて、この変数は 5 つの要素から なるリストで最初の 2 つの要素は文字間の平均インターバル時間(秒)である。 1 つめがデフォルト値で、2 つめが(通常発生する微妙な待ち時間を表現する) 単語の終りの値である。3 つめの要素は変動率である。 可能な値は 0 から 無限大である。最後の 2 つのパラメタは、それぞれ、 インターバル時間の最小値と最大値である。この 2 つの値は最後に使われて、 最終時刻をクリップする。この 2 値が違うと究極の平均は与えられた平均とは、 全く違ったものになる。

例として、続くコマンドが一定の速度で速く打つタイピストを エミュレートする:

    set send_human {.1 .3 1 .05 2}
    send -h "I'm hungry.  Let's do lunch."

    set send_human {.4 .4 .2 .5 100}
    send -h "Goodd party lash night!"

ブレークを送るためや、ゆっくりした出力を行なったり、人間が出力したように 見せかけるためにヌル文字を送るフラグは相互排他される。 最後に指定されたものだけが使われる。それ以上は、 string の引数が、ヌル文字あるいはブレークを送るフラグとして指定できる。

最初の send より前に expect を置いた方が良い。 expect は、プロセスが始まるのを待てるが、 send は待てない。 特に、最初の send は、プロセスが走り始める前に完了する。あなたのデータが無視される 危険がある。 最初にプロンプトを表示しないような対話的なプログラムでは、 次のように send の前にディレイをつけることができる:

    # どのように破るかのヒントをハッカーに与えてしまわないように、
    # このシステムでは外部のパスワードに対するプロンプトを提供しない。
    # exec が完了するのを 5 秒待て。
    spawn telnet very.secure.gov
    sleep 5
    send password\r

error_spawn_id は、標準エラー出力を参照する識別子の入ったグローバル変数である。 例えば、 spawn_id が、この値に設定された場合、 send は、 send_error のような動きをする。

    if {[info vars tty_spawn_id]} {
        # /dev/tty exists
    } else {
        # /dev/tty doesn't exist
        # probably in cron, batch, or at script
    }

内部的に、 spawn は pty を使い、ユーザーの tty と同じように初期化される。これは、かなり 初期化してしまうので全ての設定が (stty(1)によると) "正常(sane)" になる。 変数 stty_init が定義されていると、stty の引数の形式を解釈できるので、より詳細な設定を 行なえる。例えば、 "set stty_init raw" は、以降 spawn されたプロセスの端末を raw モードで開始する。 -nottycopy は、ユーザーの tty に基づいた初期化を飛ばす。 -nottyinit は、"正常な"初期化を飛ばす。

exec(2)が失敗して program が spawn に成功しなかった場合 (例えば、 program がなかった場合など)、エラーメッセージが次の interact か expect コマンドで復帰する。つまり。 program が、出力としてエラーメッセージを出しているように見せる。 この動作は、 spawn の実装の自然な帰結である。内部で、spawn がフォークされ、その後、 spawn されたプロセスがオリジナルの Expect プロセスとその spawn_id で会話を行なう。

-open フラグは、次の引数を Tcl ファイル識別子として解釈する(つまり、 open を行なって復帰する。 ) spawn id は、spawn された id として使われる。(ファイル識別子は、 もう使うべきではない。) これにより、 pty を除く、raw デバイス、ファイル、パイプラインを使うことができる。 0 が返ってくるのは、関連するプロセスがなかった時である。 spawn されたプロセスへの接続がクローズされると、Tcl ファイル識別子も クローズされる。 -leaveopen フラグは、 -open と似た動きをするが、 spawn id をクローズした後もファイル識別子を開いたままにする点が違う。

-pty フラグは、 pty をオープンするがプロセスをspawnしない。0 が復帰するのは、 関連するプロセスがない場合である。spawn_id は、通常通り設定される。

変数 spawn_out(slave,fd) には、pty スレーブとつながっているファイル識別子が設定される。 "close -slave" で close できる。

-ignore フラグは、spawn されたプロセス中で無視されるシグナルの名前を指示する。 なければ、シグナルはデフォルトの振舞いをする。シグナルの名前は trap コマンドで使う名前と同じである。各シグナルを分離するのにフラグが 必要な点を除いては。

    expect -c "strace 4" script.exp

-info フラグを指定すると、strace は最後の info でない指定の内容を復帰する。

デフォルトでは、制御している端末がアクセスされる。他の端末は、 "< /dev/tty..." を追加することでアクセスできる。(引数を一つの引数に まとめるべきではない。)

ステータス要求はコマンドの結果としてステータスを復帰する。 ステータスが要求されずに制御している端末にアクセスする場合、直前の raw と echo の状態を返す。

例えば、引数 raw か -cooked は、端末を raw モードに設定する。 引数 -raw か cooked は、端末を cooked モードに設定する。 引数 echo か -echo は、端末をそれぞれ echo あるいは noecho モードに設定する。

    stty -echo
    send_user "Password: "
    expect_user -re "(.*)\n"
    set password $expect_out(1,string)
    stty echo

-format フラグは、文字列が続くが、その文字列に POSIX の strftime のルールに従って置換がかかる。 例えば、 %a は曜日(すなわち、Sat)とか。他は以下の通りである。:

    %a      略記された曜日の名前
    %A      略されない曜日の名前
    %b      略記された月の名前
    %B      略されない月の名前
    %c      次の形式で書かれた時刻: Wed Oct  6 11:45:56 1993
    %d      日 (01-31)
    %H      時 (00-23)
    %I      時 (01-12)
    %j      日 (001-366)
    %m      月 (01-12)
    %M      分 (00-59)
    %p      am または pm
    %S      秒 (00-61)
    %u      日 (1-7, 月曜日が週の最初の日)
    %U      週 (00-53, 最初の日曜日が第1週の最初の日)
    %V      週 (01-53, ISO 8601 スタイル)
    %w      日 (0-6)
    %W      週 (00-53, 最初の月曜日が第1週の最初の日)
    %x      date-time as in: Wed Oct  6 1993
    %X      time as in: 23:59:59
    %y      year (00-99)
    %Y      year as in: 1993
    %Z      timezone (or nothing if not determinable)
    %%      a bare percent sign

-seconds フラグは、 タイムスタンプを秒で表す。

-gmt GMT タイムゾーンで出力する。デフォルトはローカルタイムゾーンである。

引数がなければ(または、引数 -number であれば)、 trap は、trapコマンドで横取りされているシグナル番号を復帰する。

-code フラグはコマンドコードを返す。Tcl がコマンドを動かし始めた時に 帰そうとしたコードである。

-interp フラグは、trap が宣言された時でなくコマンドが開始された時にインタプリタに コマンドを評価させる。

-name フラグは、 trap コマンドに trap のかかっているシグナル名を帰す。

-max フラグは、 trap コマンドに設定できる最も大きなシグナル番号を帰す。

例えば、"trap {send_user "Ouch!"} SIGINT" は、 ユーザーが ^C を押す度に "Ouch!" を表示する。

デフォルトでは、SIGINT(通常 ^C を押すと発生する)や SIGTERM は、Expect を exit させてしまう。これは、Expect が起動時に 実行する以下の trap によって起こっている。

    trap exit {SIGINT SIGTERM}

    trap {exp_debug 1} SIGINT

もちろん、スクリプトにtrapコマンドを足すだけで例のトラップは両方とも 上書きできる。特に、自作の "trap exit SIGINT" があるなら、これは デバッガのトラップを上書きしてしまう。ユーザーにデバッガを全く 触らせないようにするのに、便利である。

SIGINT のトラップを独自に定義したいけれど、デバッガにも同時に割り込んで もらいたいのであれば、こう書く。:

    if ![exp_debug] {trap mystuff SIGINT}

trap は、SIGALRM のアクションを上書きしない。 Expect が内部で使用しない。 disconnect コマンドは、SIGALRMを SIG_IGN (ignore)に設定する。 後から発行される spawn コマンドを実行している間、SIGALRM は ディスエーブル中であれば再度イネーブルにできる。

もっと情報が欲しい場合、signal(3) を参照すること。

追加の要素が wait の復帰値に加わっても構わない。オプションの5つめの要素は、情報クラスの 識別子である。今のところ、この要素の唯一可能な値は CHILDKILLED で、 その場合、次の二つの値が C スタイルのシグナル名と短い文書による記述である。

-nowait フラグを指定すると、wait が成功の復帰値で即時復帰する。 (あとで)そのプロセスが exit すると、自動的に後始末が行なわれ、明示的に wait する必要がない。

wait コマンドは、引数に "-i -1" を指定することによって、 fork したプロセスを待つためにも使われる。 spawn したプロセスに用いられる場合と異なり、 このコマンドはいつでも実行できる。 どのプロセスを待つかを制御することは出来ないが、 返り値はプロセス ID としてチェックできる。