20.14。 telnetlib —Telnetクライアント

ソースコード： ：source： `Lib / telnetlib.py`

telnetlib モジュールは、Telnetプロトコルを実装する Telnet クラスを提供します。プロトコルの詳細については、 RFC 854 を参照してください。さらに、プロトコル文字（以下を参照）およびtelnetオプションの記号定数を提供します。 telnetオプションの記号名は、arpa/telnet.hの定義に従い、先頭のTELOPT_は削除されています。従来arpa/telnet.hに含まれていなかったオプションの記号名については、モジュールソース自体を参照してください。

telnetコマンドのシンボリック定数は、IAC、DONT、DO、WONT、WILL、SE（サブネゴシエーション終了）、NOP（操作なし）、DM（データマーク）、BRK（ブレーク）、IP（割り込みプロセス）、AO（出力の中止）、AYT（Are You There）、EC（Erase Character）、EL（Erase Line）、GA（Go Ahead）、SB（サブネゴシエーション開始）。

class telnetlib.Telnet([host[, port[, timeout]]])

Telnet は、Telnetサーバーへの接続を表します。インスタンスは最初はデフォルトで接続されていません。接続を確立するには、 open（）メソッドを使用する必要があります。または、ホスト名とオプションのポート番号をコンストラクターに渡すこともできます。この場合、コンストラクターが戻る前にサーバーへの接続が確立されます。オプションの timeout パラメーターは、接続試行などのブロック操作のタイムアウトを秒単位で指定します（指定されていない場合は、グローバルなデフォルトのタイムアウト設定が使用されます）。

すでに接続されているインスタンスを再度開かないでください。

このクラスには多くのread_*()メソッドがあります。他の理由で空の文字列を返す可能性があるため、接続の終わりが読み取られたときにEOFErrorを発生させるものがあることに注意してください。以下の個別の説明を参照してください。

バージョン2.6で変更： timeout が追加されました。

も参照してください

RFC 854 -Telnetプロトコル仕様: Telnetプロトコルの定義。

20.14.1。 Telnetオブジェクト

Telnet インスタンスには次のメソッドがあります。

Telnet.read_until(expected[, timeout])

指定された文字列 expected が検出されるまで、または timeout 秒が経過するまで読み取ります。

一致するものが見つからない場合は、代わりに使用可能なもの、場合によっては空の文字列を返します。接続が閉じていて、調理済みのデータが利用できない場合は、EOFErrorを上げます。

Telnet.read_all(): EOFまですべてのデータを読み取ります。接続が閉じるまでブロックします。

Telnet.read_some(): EOFがヒットしない限り、少なくとも1バイトのクックされたデータを読み取ります。 EOFがヒットした場合は、を返します。すぐに利用できるデータがない場合はブロックします。

Telnet.read_very_eager()

I / Oをブロックせずにできることをすべて読んでください（熱心に）。

接続が閉じていて、調理済みのデータが利用できない場合は、EOFErrorを上げます。それ以外の方法で利用可能な調理済みデータがない場合は、を返します。 IACシーケンスの途中でない限り、ブロックしないでください。

Telnet.read_eager()

すぐに利用できるデータを読みます。

接続が閉じていて、調理済みのデータが利用できない場合は、EOFErrorを上げます。それ以外の方法で利用可能な調理済みデータがない場合は、を返します。 IACシーケンスの途中でない限り、ブロックしないでください。

Telnet.read_lazy()

すでにキューにあるデータを処理して返します（遅延）。

接続が閉じていてデータが利用できない場合は、EOFErrorを上げます。それ以外の方法で利用可能な調理済みデータがない場合は、を返します。 IACシーケンスの途中でない限り、ブロックしないでください。

Telnet.read_very_lazy()

クックされたキューで利用可能なデータを返します（非常に怠惰です）。

接続が閉じていてデータが利用できない場合は、EOFErrorを上げます。それ以外の方法で利用可能な調理済みデータがない場合は、を返します。このメソッドはブロックしません。

Telnet.read_sb_data(): SB / SEペア間で収集されたデータを返します（サブオプションの開始/終了）。コールバックは、SEコマンドで呼び出されたときに、これらのデータにアクセスする必要があります。このメソッドはブロックしません。

バージョン2.3の新機能。

Telnet.open(host[, port[, timeout]])

ホストに接続します。オプションの2番目の引数はポート番号で、デフォルトでは標準のTelnetポート（23）になります。オプションの timeout パラメーターは、接続試行などのブロック操作のタイムアウトを秒単位で指定します（指定されていない場合は、グローバルなデフォルトのタイムアウト設定が使用されます）。

すでに接続されているインスタンスを再度開かないでください。

バージョン2.6で変更： timeout が追加されました。

Telnet.msg(msg[, *args]): デバッグレベルが> 0の場合、デバッグメッセージを出力します。追加の引数が存在する場合、それらは標準の文字列フォーマット演算子を使用してメッセージに置き換えられます。

Telnet.set_debuglevel(debuglevel): デバッグレベルを設定します。 debuglevel の値が高いほど、（sys.stdoutで）より多くのデバッグ出力が得られます。

Telnet.close(): 接続を閉じます。

Telnet.get_socket(): 内部で使用されているソケットオブジェクトを返します。

Telnet.fileno(): 内部で使用されるソケットオブジェクトのファイル記述子を返します。

Telnet.write(buffer): IAC文字を2倍にして、ソケットに文字列を書き込みます。接続がブロックされている場合、これはブロックされる可能性があります。接続が閉じている場合、 socket.error が発生する可能性があります。

Telnet.interact(): インタラクション関数は、非常に馬鹿げたTelnetクライアントをエミュレートします。

Telnet.mt_interact(): interact（）のマルチスレッドバージョン。

Telnet.expect(list[, timeout])

正規表現のリストから1つが一致するまで読み取ります。

最初の引数は、コンパイル済み（regex objects）または未コンパイル（文字列）の正規表現のリストです。オプションの2番目の引数は、秒単位のタイムアウトです。デフォルトでは、無期限にブロックされます。

3つの項目のタプルを返します。一致する最初の正規表現のリスト内のインデックス。返された一致オブジェクト。そして、テキストは試合まで読み上げられました。

ファイルの終わりが見つかり、テキストが読み取られなかった場合は、EOFErrorを上げます。それ以外の場合、一致するものがない場合は、(-1, None, text)を返します。ここで、 text はこれまでに受信したテキストです（タイムアウトが発生した場合は空の文字列である可能性があります）。

正規表現が貪欲な一致（.*など）で終了する場合、または複数の式が同じ入力に一致する可能性がある場合、結果は非決定的であり、I / Oタイミングに依存する可能性があります。

Telnet.set_option_negotiation_callback(callback): 入力フローでtelnetオプションが読み取られるたびに、この callback （設定されている場合）が次のパラメーターで呼び出されます：callback（telnet socket、command（DO / DONT / WILL / WONT）、option）。その後、telnetlibによって他のアクションは実行されません。

20.14.2。 Telnetの例

典型的な使用法を説明する簡単な例：

import getpass
import sys
import telnetlib

HOST = "localhost"
user = raw_input("Enter your remote account: ")
password = getpass.getpass()

tn = telnetlib.Telnet(HOST)

tn.read_until("login: ")
tn.write(user + "\n")
if password:
    tn.read_until("Password: ")
    tn.write(password + "\n")

tn.write("ls\n")
tn.write("exit\n")

print tn.read_all()

20.14. telnetlib — Telnetクライアント—Pythonドキュメント

20.14。 telnetlib —Telnetクライアント

20.14.1。 Telnetオブジェクト

20.14.2。 Telnetの例