ナビゲーション
- 索引
- モジュール |
- 次へ |
- 前へ |
- Python v2.6.2 documentation »
- Python 標準ライブラリ »
- 18. プロセス間通信とネットワーク »
このモジュールは、PythonでBSD ソケット(socket) インターフェースを利用するために使用します。 最近のUnixシステム、Windows, Max OS X, BeOS, OS/2など、多くのプラットフォームで利用可能です。
ノート
いくつかの振る舞いはプラットフォームに依存します。 オペレーティングシステムのソケットAPIを呼び出しているためです。
C言語によるソケットプログラミングの基礎については、以下の資料を参照してください。 An Introductory 4.3BSD Interprocess Communication Tutorial (Stuart Sechrest), An Advanced 4.3BSD Interprocess Communication Tutorial (Samuel J. Leffler他), UNIX Programmer’s Manual, Supplementary Documents 1(PS1:7章 PS1:8章)。ソケットの詳細については、 各プラットフォームのソケット関連システムコールに関するドキュメント(Unix では マニュアルページ、WindowsではWinSock(またはWinSock2)仕様書)も参照してください。 IPv6対応のAPIについては、 RFC 3493 “Basic Socket Interface Extensions for IPv6” を参照してください。
Pythonインターフェースは、Unixのソケット用システムコールとライブラリを、 そのままPythonのオブジェクト指向スタイルに変換したものです。 各種ソケット関連のシステムコールは、 socket() 関数で生成する ソケットオブジェクト のメソッドとして実装されています。 メソッドのパラメータはCのインターフェースよりも多少高水準で、例えば read() や write() メソッドではファイルオブジェクトと同様、 受信時のバッファ確保や送信時の出力サイズなどは自動的に処理されます。
ソケットのアドレスは以下のように指定します:単一の文字列は、 AF_UNIX アドレスファミリを示します。 (host, port) のペアは AF_INET アドレスファミリを示し、 host は 'daring.cwi.nl' のようなインターネットドメイン形式または '100.50.200.5' のようなIPv4アドレスを文字列で、 port はポート 番号を整数で指定します。 AF_INET6 アドレスファミリは (host, port, flowinfo, scopeid) の長さ4の タプルで示し、 flowinfo と scopeid にはそれぞれCの struct sockaddr_in6 における sin6_flowinfo と sin6_scope_id の値を指定します。後方互換性のため、 socket モジュールのメソッドでは sin6_flowinfo と sin6_scope_id を省略する事ができますが、 scopeid を省略するとスコープを持ったIPv6アドレスの処理で問題が発生する場合があります。 現在サポートされているアドレスファミリは以上です。 ソケットオブジェクトで利用する事のできるアドレス形式は、ソケットオブジェクトの作成時に指定したアドレスファミリで決まります。
IPv4アドレスのホストアドレスが空文字列の場合、 INADDR_ANY として処理されます。また、 '<broadcast>' の場合は INADDR_BROADCAST として処理されます。 IPv6では後方互換性のためこの機能は用意されていませんので、IPv6をサポートするPythonプログラムでは利用しないで下さい。
IPv4/v6ソケットの host 部にホスト名を指定すると、処理結果が一定ではない場合があります。 これはPythonはDNSから取得したアドレスのうち最初のアドレスを使用するので、 DNSの処理やホストの設定によって異なるIPv4/6アドレスを取得する場合があるためです。常に同じ結果が必要であれば、 host に数値のアドレスを指定してください。
バージョン 2.5 で追加: AF_NETLINK ソケットが pid, groups のペアで表現されます.
バージョン 2.6 で追加: .. Linux-only support for TIPC is also available using the AF_TIPC address family. TIPC is an open, non-IP based networked protocol designed for use in clustered computer environments. Addresses are represented by a tuple, and the fields depend on the address type. The general tuple form is (addr_type, v1, v2, v3 [, scope]), where:
Linuxのみ、 AF_TIPC アドレスファミリを使って TIPC を利用することができます。 TIPCはオープンで、IPベースではないクラスターコンピューター環境向けのネットワークプロトコルです。 アドレスはタプルで表現され、その中身はアドレスタイプに依存します。 一般的なタプルの形は (addr_type, v1, v2, v3 [, scope]) で、
エラー時には例外が発生します。引数型のエラーやメモリ不足の場合には通常の例外が発生し、ソケットやアドレス関連のエラーの場合は socket.error が発生します。
setblocking() メソッドで、非ブロッキングモードを使用することがで きます。また、より汎用的に settimeout() メソッドでタイムアウトを指定する事ができます。
socket モジュールでは、以下の定数と関数を提供しています。
この例外は、ソケット関連のエラーが発生した場合に送出されます。例外の値は障害の内容を示す文字列か、または os.error と同様な (errno, string) のペアとなります。オペレーティングシステムで定義されているエラーコードについては errno を参照してください。
バージョン 2.6 で変更: socket.error は IOError の子クラスになりました。
この例外は、C APIの gethostbyname_ex() や gethostbyaddr() などで、 h_errno のようなアドレス関連のエラーが発生した場合に送出されます。
例外の値は (h_errno, string) のペアで、ライブラリの呼び 出し結果を返します。 string はC関数 hstrerror() で取得した、 h_errno の意味を示す文字列です。
この例外は getaddrinfo() と getnameinfo() でアドレス関連のエラーが発生した場合に送出されます。
例外の値は (error, string) のペアで、ライブラリの呼び出 し結果を返します。 string はC関数 gai_strerror() で取得した、 h_errno の意味を示す文字列です。 error の値は、このモジュールで定義される EAI_* 定数の何れかとなります。
この例外は、あらかじめ settimeout() を呼び出してタイムアウトを有効にしてあるソケットでタイムアウトが生じた際に送出されます。 例外に付属する値は文字列で、その内容は現状では常に “timed out” となります。
バージョン 2.3 で追加.
アドレス（およびプロトコル）ファミリを示す定数で、 socket() の 最初の引数に指定することができます。 AF_UNIX ファミリをサポート しないプラットフォームでは、 AF_UNIX は未定義となります。
ソケットタイプを示す定数で、 socket() の2番目の引数に指定することができます。(ほとんどの場合、 SOCK_STREAM と SOCK_DGRAM 以外は必要ありません。)
Unixのソケット・IPプロトコルのドキュメントで定義されている各種定数。 ソケットオブジェクトの setsockopt() や getsockopt() で使用 します。ほとんどのシンボルはUnixのヘッダファイルに従っています。一部のシンボルには、デフォルト値を定義してあります。
WindowsのWSAIoctl()のための定数です。 この定数はソケットオブジェクトの ioctl() メソッドに引数として渡されます。
バージョン 2.6 で追加.
TIPC関連の定数で、CのソケットAPIが公開しているものにマッチします。 詳しい情報はTIPCのドキュメントを参照してください。
バージョン 2.6 で追加.
現在のプラットフォームでIPv6がサポートされているか否かを示す真偽値。
バージョン 2.3 で追加.
便利関数。 address ((host, port) の形のタプル) に接続してソケットオブジェクトを返します。 オプションの timeout 引数を指定すると、接続を試みる前にソケットオブジェクトのタイムアウトを設定します。
バージョン 2.6 で追加.
host / port 引数の指すアドレス情報を解決して、ソケットを作成するために 必要な全ての引数が入った 5 要素のタプルを返します。 host はドメイン名、IPv4/v6アドレスの文字列、または None です。 port は 'http' のようなサービス名文字列、ポート番号を表す数値、または None です。
これ以外の引数は省略可能で、指定する場合には数値でなければなりません。 host と port に None を指定すると C APIに NULL を渡せます。 getattrinfo() 関数は以下の構造をとる 5 要素のタプルのリストを返します:
(family, socktype, proto, canonname, sockaddr)
family, socktype, proto は、 socket() 関数を呼び出す際に指定する値と同じ整数です。 canonname は host の規準名(canonical name)を示す文字列です。 AI_CANONNAME を指定した場合、数値によるIPv4/v6アドレスを返します。 sockaddr は、ソケットアドレスを上述の形式で表すタプルです。 この関数の使い方については、 socket モジュールなどのソースを参考にしてください。
バージョン 2.2 で追加.
name の完全修飾ドメイン名を返します。 name が空または省略された場合、ローカルホストを指定したとみなします。完全修飾ドメイン名の取得には まず gethostbyaddr() でチェックし、次に可能であればエイリアスを調べ、名前にピリオドを含む最初の名前を値として返します。完全修飾ドメイ ン名を取得できない場合、 gethostname() で返されるホスト名を返します。
バージョン 2.0 で追加.
ホスト名を '100.50.200.5' のようなIPv4形式のアドレスに変換します。 ホスト名としてIPv4アドレスを指定した場合、その値は変換せずにそのまま返ります。 gethostbyname() APIへのより完全なインターフェースが必要であれば、 gethostbyname_ex() を参照してください。 gethostbyname() は、IPv6名前解決をサポートしていません。IPv4/ v6のデュアルスタックをサポートする場合は getaddrinfo() を使用します。
ホスト名から、IPv4形式の各種アドレス情報を取得します。戻り値は (hostname, aliaslist, ipaddrlist) のタプルで、 hostname は ip_address で指定したホストの正式名、 aliaslist は同じアドレス の別名のリスト(空の場合もある)、 ipaddrlist は同じホスト上の同一インターフェースのIPv4アドレスのリスト(ほとんどの場合は単一のアドレスのみ) を示します。 gethostbyname() は、IPv6名前解決をサポートしていません。IPv4/v6のデュアルスタックをサポートする場合は getaddrinfo() を使用します。
Pythonインタープリタを現在実行中のマシンのホスト名を示す文字列を取得します。
実行中マシンのIPアドレスが必要であれば、 gethostbyname(gethostname()) を使用してください。 この処理は実行中ホストのアドレス-ホスト名変換が可能であることを前提としていますが、常に変換可能であるとは限りません。
注意: gethostname() は完全修飾ドメイン名を返すとは限りません。完全修飾ドメイン名が必要であれば、 gethostbyaddr(gethostname()) としてください(下記参照)。
(hostname, aliaslist, ipaddrlist) のタプルを返 し、 hostname は ip_address で指定したホストの正式名、 aliaslist は同じアドレスの別名のリスト(空の場合もある)、 ipaddrlist は同じホスト上の同一インターフェースのIPv4アドレスのリ スト(ほとんどの場合は単一のアドレスのみ)を示します。完全修飾ドメイン名が必要であれば、 getfqdn() を使用してください。 gethostbyaddr() は、IPv4/IPv6の両方をサポートしています。
ソケットアドレス sockaddr から、 (host, port) のタプルを取得します。 flags の設定に従い、 host は完全修飾ドメイン 名または数値形式アドレスとなります。同様に、 port は文字列のポート名または数値のポート番号となります。
バージョン 2.2 で追加.
'icmp' のようなインターネットプロトコル名を、 socket() の 第三引数として指定する事ができる定数に変換します。これは主にソケットを” raw”モード(SOCK_RAW)でオープンする場合には必要ですが、通常の ソケットモードでは第三引数に0を指定するか省略すれば正しいプロトコルが自動的に選択されます。
インターネットサービス名とプロトコルから、そのサービスのポート番号を取得します。省略可能なプロトコル名として、 'tcp' か 'udp' のどちら かを指定することができます。指定がなければどちらのプロトコルにもマッチします。
インターネットポート番号とプロトコル名から、サービス名を取得します。省略可能なプロトコル名として、 'tcp' か 'udp' のどちら かを指定することができます。指定がなければどちらのプロトコルにもマッチします。
アドレスファミリ、ソケットタイプ、プロトコル番号を指定してソケットを作成します。アドレスファミリには AF_INET (デフォルト値)・ AF_INET6 ・ AF_UNIX を指定することができます。ソケットタイプには SOCK_STREAM (デフォルト値)・ SOCK_DGRAM ・または他の SOCK_ 定数の何れかを指定します。プロトコル番号は通常省略するか、または0を指定します。
指定されたアドレスファミリ、ソケットタイプ、プロトコル番号から、接続されたソケットのペアを作成します。 アドレスファミリ、ソケットタイプ、プロトコル番号は socket() 関数と同様に指定します。デフォルトのアドレスファミリは、プラットフォームで定義されていれば AF_UNIX 、そうでなければ AF_INET が使われます。
利用可能: Unix.
バージョン 2.4 で追加.
ファイルディスクリプタ (ファイルオブジェクトの fileno() で返る整数) fd を複製して、ソケットオブジェクトを構築します。アドレス ファミリとプロトコル番号は socket() と同様に指定します。ファイルディスクリプタ はソケットを指していなければなりませんが、実際にソケットであるかどうかのチェックは行っていません。このため、ソケット以外のファイルディスクリプタ を指定するとその後の処理が失敗する場合があります。この関数が必要な事はあまりありませんが、Unixのinetデーモンのようにソケットを標準入力や標準 出力として使用するプログラムで使われます。この関数で使用するソケットは、ブロッキングモードと想定しています。利用可能:Unix
32ビットの正の整数のバイトオーダを、ネットワークバイトオーダからホストバイトオーダに変換します。 ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。 それ以外の場合は4バイトのスワップを行います。
16ビットの正の整数のバイトオーダを、ネットワークバイトオーダからホストバイトオーダに変換します。 ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。 それ以外の場合は2バイトのスワップを行います。
32ビットの正の整数のバイトオーダを、ホストバイトオーダからネットワークバイトオーダに変換します。 ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。 それ以外の場合は4バイトのスワップを行います。
16ビットの正の整数のバイトオーダを、ホストバイトオーダからネットワークバイトオーダに変換します。 ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。 それ以外の場合は2バイトのスワップを行います。
ドット記法によるIPv4アドレス('123.45.67.89' など)を32ビットにパックしたバイナリ形式に変換し、 長さ4の文字列として返します。この関数が返す値は、標準Cライブラリの struct in_addr 型を使用する関数に渡す事ができます。
IPv4アドレス文字列が不正であれば、 socket.error が発生します。このチェックは、この関数で使用しているCの実装 inet_aton() で行われます。
inet_aton() は、IPv6をサポートしません。IPv4/v6のデュアルスタックをサポートする場合は getnameinfo() を使用します。
32ビットにパックしたバイナリ形式のIPv4アドレスを、ドット記法による文字列 ('123.45.67.89' など)に変換します。 この関数が返す値は、標準Cライブラリの:ctype:struct in_addr 型を使用する関数に渡す事ができます。
この関数に渡す文字列の長さが4バイト以外であれば、 socket.error が発生します。 inet_ntoa() は、IPv6をサポートしません。IPv4/v6のデュアルスタ ックをサポートする場合は getnameinfo() を使用します。
IPアドレスを、アドレスファミリ固有の文字列からパックしたバイナリ形式に変換します。 inet_pton() は、:ctype:struct in_addr`型 (:func:`inet_aton と同様)や struct in6_addr を使用するライブ ラリやネットワークプロトコルを呼び出す際に使用することができます。
現在サポートされている address_family は、 AF_INET と AF_INET6 です。 ip_string に不正なIPアドレス文字列を指定す ると、 socket.error が発生します。有効な ip_string は、 address_family と inet_pton() の実装によって異なります。
利用可能: Unix (サポートしていないプラットフォームもあります)
バージョン 2.3 で追加.
パックしたIPアドレス(数文字の文字列)を、 '7.10.0.5' や '5aef:2b::8' などの標準的な、アドレスファミリ固有の文字列形式に変 換します。 inet_ntop() は(inet_ntoa() と同様に) struct in_addr`型や :ctype:`struct in6_addr 型のオブジェクトを返すライブラリやネットワークプロトコル等で使用することができます。
現在サポートされている address_family は、 AF_INET と AF_INET6 です。 packed_ip の長さが指定したアドレスファミリ で適切な長さでなければ、 ValueError が発生します。 inet_ntop() でエラーとなると、 socket.error が発生します。
利用可能: Unix (サポートしていないプラットフォームもあります)
バージョン 2.3 で追加.
新規に生成されたソケットオブジェクトの、デフォルトのタイムアウト値を浮動小数点形式の秒数で返します。タイプアウトを使用しない場合には None を返します。最初にsocketモジュールがインポートされた時の初期値は None です。
バージョン 2.3 で追加.
新規に生成されたソケットオブジェクトの、デフォルトのタイムアウト値を浮動小数点形式の秒数で指定します。タイムアウトを使用しない場合には None を指定します。最初にsocketモジュールがインポートされた時の初期値は None です。
バージョン 2.3 で追加.
ソケットオブジェクトの型を示す型オブジェクト。 type(socket(...)) と同じです。
参考
ソケットオブジェクトは以下のメソッドを持ちます。 makefile() 以外のメソッドは、Unixのソケット用システムコールに対応しています。
接続を受け付けます。ソケットはアドレスにbind済みで、listen中である必要があります。戻り値は``(conn, address)``のペアで、 conn は接続を通じてデータの送受信を行うための 新しい ソケットオブジェク ト、 address は接続先でソケットにbindしているアドレスを示します。
ソケットを address にbindします。bind済みのソケットを再バインドする 事はできません。 address のフォーマットはアドレスファミリによって異なります(前述)。
ノート
本来、このメソッドは単一のタプルのみを引数として受け付けますが、以前は AF_INET アドレスを示す二つの値を指定する事ができました。 これは本来の仕様ではなく、Python 2.0以降では使用することはできません。
ソケットをクローズします。以降、このソケットでは全ての操作が失敗します。リモート端点ではキューに溜まったデータがフラッシュされた後はそれ以上の データを受信しません。ソケットはガベージコレクション時に自動的にクローズされます。
address で示されるリモートソケットに接続します。 address のフォーマットはアドレスファミリによって異なります(前述)。
ノート
本来、このメソッドは単一のタプルのみを引数として受け付けますが、以前は AF_INET アドレスを示す二つの値を指定する事ができました。 これは本来の仕様ではなく、Python 2.0以降では使用することはできません。
connect(address) と同様ですが、C言語の connect() 関数の呼び出しでエラーが発生した場合には例外を送出せずにエラーを戻り値として返します。(これ以外の、”host not found,”等のエラーの場合には例外が発生します。)処理が正常に終了した場合には 0 を返し、エラー時には errno の値を返します。この関数は、非同期接続をサポートする場合などに使用することができます。
ノート
本来、このメソッドは単一のタプルのみを引数として受け付けますが、以前は AF_INET アドレスを示す二つの値を指定する事ができました。 これは本来の仕様ではなく、Python 2.0以降では使用することはできません。
ソケットのファイルディスクリプタを整数型で返します。ファイルディスクリプタは、 select.select() などで使用します。
Windowsではこのメソッドで返された小整数をファイルディスクリプタを扱う箇所(os.fdopen() など)で利用できません。 Unix にはこの制限はありません。
ソケットが接続しているリモートアドレスを返します。この関数は、リモート IPv4/v6ソケットのポート番号を調べる場合などに使用します。 address の フォーマットはアドレスファミリによって異なります(前述)。この関数をサポートしていないシステムも存在します。
ソケット自身のアドレスを返します。この関数は、IPv4/v6ソケットのポート番号を調べる場合などに使用します。 address のフォーマットはアドレスフ ァミリによって異なります(前述)。
ソケットに指定されたオプションを返します(Unixのマニュアルページ getsockopt(2) を参照)。 SO_* 等のシンボルは、このモジ ュールで定義しています。 buflen を省略した場合、取得するオブションは整数とみなし、整数型の値を戻り値とします。 buflen を指定した場合、長 さ buflen のバッファでオプションを受け取り、このバッファを文字列として返します。このバッファは、呼び出し元プログラムで struct モジュール等を利用して内容を読み取ることができます。
| Platform : | Windows |
|---|
ioctl() メソッドは WSAIoctl システムインタフェースへの制限されたインタフェースです。 詳しい情報については、MSDNのドキュメントを参照してください。
バージョン 2.6 で追加.
ソケットをListenし、接続を待ちます。引数 backlog には接続キューの最 大の長さ(1以上)を指定します。 backlog の最大数はシステムに依存します (通常は5)。
ソケットに関連付けられた ファイルオブジェクト を返します (ファイルオブジェクトについては:ref:bltin-file-objects を参照)。 ファイルオブジェクトはソケットを dup() したファイルディスクリプタを使用しており、 ソケットオブジェクトとファイルオブジェクトは別々にクローズしたりガベージコレクションで破棄したりする事ができます。 ソケットはブロッキングモードでなければなりません(タイムアウトを設定することもできません)。 オプション引数の mode と bufsize には、 file() 組み込み関数と同じ値を指定します。
ソケットからデータを受信し、文字列として返します。受信する最大バイト数は、 bufsize で指定します。 flags のデフォルト値は0です。 値の意味についてはUnixマニュアルページの recv(2) を参照してください。
ノート
ハードウェアおよびネットワークの現実に最大限マッチするように、 bufsize の値は比較的小さい2の累乗、たとえば 4096、にすべきです。
ソケットからデータを受信し、結果をタプル (string, address) として返します。 string は受信データの文字列で、 address は送信元のアドレスを示します。 オプション引数 flags については、 Unix のマニュアルページ recv(2) を参照してください。デフォルトは0です。 (address のフォーマットはアドレスファミリによって異なります(前述))
ソケットからデータを受信し、そのデータを新しい文字列として返す代わりに buffer に書きます。 戻り値は (nbytes, address) のペアで、 nbytes は受信したデータのバイト数を、 address はデータを送信したソケットのアドレスです。 オプション引数 flags (デフォルト:0) の意味については、 Unix マニュアルページ recv(2) を参照してください。
(address のフォーマットは前述のとおりアドレスファミリーに依存します。)
バージョン 2.5 で追加.
nbytes バイトまでのデータをソケットから受信して、そのデータを新しい文字列にするのではなく buffer に保存します。 nbytes が指定されない(あるいは0が指定された)場合、 buffer の利用可能なサイズまで受信します。 オプション引数 flags (デフォルト:0) の意味については、 Unix マニュアルページ recv(2) を参照してください。
バージョン 2.5 で追加.
ソケットにデータを送信します。ソケットはリモートソケットに接続済みでなければなりません。オプション引数 flags の意味は、上記 recv() と 同じです。戻り値として、送信したバイト数を返します。アプリケーションでは、必ず戻り値をチェックし、全てのデータが送られた事を確認する必要があり ます。データの一部だけが送信された場合、アプリケーションで残りのデータを再送信してください。
ソケットにデータを送信します。ソケットはリモートソケットに接続済みでなければなりません。オプション引数 flags の意味は、上記 recv() と 同じです。 send() と異なり、このメソッドは string の全データを送信するか、エラーが発生するまで処理を継続します。正常終了の場合は None を返し、エラー発生時には例外が発生します。エラー発生時、送信されたバイト数を調べる事はできません。
ソケットにデータを送信します。このメソッドでは接続先を address で指定するので、接続済みではいけません。オプション引数 flags の意味は、 上記 recv() と同じです。戻り値として、送信したバイト数を返します。 address のフォーマットはアドレスファミリによって異なります(前 述)。
ソケットのブロッキング・非ブロッキングモードを指定します。 flag が0 の場合は非ブロッキングモード、0以外の場合はブロッキングモードとなりま す。全てのソケットは、初期状態ではブロッキングモードです。非ブロッキングモードでは、 recv() メソッド呼び出し時に読み込みデータが無かった り send() メソッド呼び出し時にデータを処理する事ができないような場合に error 例外が発生します。しかし、ブロッキングモードでは 呼び出しは処理が行われるまでブロックされます。 s.setblocking(0) は s.settimeout(0) と、 s.setblocking(1) は s.settimeout(None) とそれぞれ同じ意味を持ちます。
ソケットのブロッキング処理のタイムアウト値を指定します。 value には、正の浮動小数点で秒数を指定するか、もしくは None を指定します。 浮動小数点値を指定した場合、操作が完了する前に value で指定した秒数 が経過すると timeout が発生します。タイムアウト値に None を指定すると、ソケットのタイムアウトを無効にします。 s.settimeout(0.0) は s.setblocking(0) と、 s.settimeout(None) は s.setblocking(1) とそれぞれ同じ意味を持ちます。
バージョン 2.3 で追加.
ソケットに指定されたタイムアウト値を取得します。タイムアウト値が設定されている場合には浮動小数点型で秒数が、設定されていなければ None が返 ります。この値は、最後に呼び出された setblocking() または settimeout() によって設定されます。
バージョン 2.3 で追加.
ソケットのブロッキングとタイムアウトについて: ソケットオブジェクトのモードは、ブロッキング・非ブロッキング・タイムアウトの何れかとなります。 初期状態では常にブロッキングモードです。ブロッキングモードでは、処理が完了するまでブロックされます。 非ブロッキングモードでは、処理を行う事ができなければ(不幸にもシステムによって異なる値の)エラーとなります。 タイムアウトモードでは、ソケットに指定したタイムアウトまでに完了しなければ処理は失敗となります。 setblocking() メソッドは、 settimeout() の省略形式です。
内部的には、タイムアウトモードではソケットを非ブロッキングモードに設定します。ブロッキングとタイムアウトの設定は、ソケットと同じネットワーク端点 へ接続するファイルディスクリプタにも反映されます。この結果、 makefile() で作成したファイルオブジェクトはブロッキングモードで のみ使用することができます。これは非ブロッキングモードとタイムアウトモードでは、即座に完了しないファイル操作はエラーとなるためです。
註: connect() はタイムアウト設定に従います。一般的に、 settimeout() を connect() の前に呼ぶことをおすすめします。
ソケットのオプションを設定します(Unixのマニュアルページ setsockopt(2) を参照)。 SO_* 等のシンボルは、このモジ ュールで定義しています。 value には、整数または文字列をバッファとして指定する事ができます。文字列を指定する場合、文字列には適切なビットを設 定するようにします。(struct モジュールを利用すれば、Cの構造体を文字列にエンコードする事ができます。)
接続の片方向、または両方向を切断します。 how が SHUT_RD の場合、以降 は受信を行えません。 how が SHUT_WR の場合、以降は送信を行えません。 how が SHUT_RDWR の場合、以降は送受信を行えません。
read() メソッドと write() メソッドは存在しませんので注意 してください。代わりに flags を省略した recv() と send() を使うことができます。
ソケットオブジェクトには以下の socket コンストラクタに渡された値に対応した(読み出し専用)属性があります。
ソケットファミリー。
バージョン 2.5 で追加.
ソケットタイプ。
バージョン 2.5 で追加.
ソケットプロトコル。
バージョン 2.5 で追加.
以下はTCP/IPプロトコルの簡単なサンプルとして、受信したデータをクライアントにそのまま返送するサーバ(接続可能なクライアントは一件のみ)と、サーバに 接続するクライアントの例を示します。サーバでは、 socket() ・ bind() ・ listen() ・ accept() を実行し(複数のクラ イアントからの接続を受け付ける場合、 accept() を複数回呼び出しま す)、クライアントでは socket() と connect() だけを呼び出 しています。サーバでは send() / recv() メソッドはlisten中 のソケットで実行するのではなく、 accept() で取得したソケットに対して実行している点にも注意してください。
次のクライアントとサーバは、IPv4のみをサポートしています。
# Echo server program
import socket
HOST = None # Symbolic name meaning all available interfaces
PORT = 50007 # Arbitrary non-privileged port
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.bind((HOST, PORT))
s.listen(1)
conn, addr = s.accept()
print 'Connected by', addr
while 1:
data = conn.recv(1024)
if not data: break
conn.send(data)
conn.close()
# Echo client program
import socket
HOST = 'daring.cwi.nl' # The remote host
PORT = 50007 # The same port as used by the server
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect((HOST, PORT))
s.send('Hello, world')
data = s.recv(1024)
s.close()
print 'Received', repr(data)
次のサンプルは上記のサンプルとほとんど同じですが、IPv4とIPv6の両方をサポートしています。サーバでは、IPv4/v6の両方ではなく、 利用可能な最初のアドレスファミリだけをlistenしています。ほとんどのIPv6対応システムではIPv6が先に現れるため、サーバはIPv4には応答しません。 クライアントでは名前解決の結果として取得したアドレスに順次接続を試み、最初に接続に成功したソケットにデータを送信しています。
# Echo server program
import socket
import sys
HOST = None # Symbolic name meaning all available interfaces
PORT = 50007 # Arbitrary non-privileged port
s = None
for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC,
socket.SOCK_STREAM, 0, socket.AI_PASSIVE):
af, socktype, proto, canonname, sa = res
try:
s = socket.socket(af, socktype, proto)
except socket.error, msg:
s = None
continue
try:
s.bind(sa)
s.listen(1)
except socket.error, msg:
s.close()
s = None
continue
break
if s is None:
print 'could not open socket'
sys.exit(1)
conn, addr = s.accept()
print 'Connected by', addr
while 1:
data = conn.recv(1024)
if not data: break
conn.send(data)
conn.close()
# Echo client program
import socket
import sys
HOST = 'daring.cwi.nl' # The remote host
PORT = 50007 # The same port as used by the server
s = None
for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC, socket.SOCK_STREAM):
af, socktype, proto, canonname, sa = res
try:
s = socket.socket(af, socktype, proto)
except socket.error, msg:
s = None
continue
try:
s.connect(sa)
except socket.error, msg:
s.close()
s = None
continue
break
if s is None:
print 'could not open socket'
sys.exit(1)
s.send('Hello, world')
data = s.recv(1024)
s.close()
print 'Received', repr(data)
最後の例は、Windowsで raw socket を利用して非常にシンプルなネットワークスニファーを書きます。 このサンプルを実行するには、インタフェースを操作するための管理者権限が必要です。
import socket
# the public network interface
HOST = socket.gethostbyname(socket.gethostname())
# create a raw socket and bind it to the public interface
s = socket.socket(socket.AF_INET, socket.SOCK_RAW, socket.IPPROTO_IP)
s.bind((HOST, 0))
# Include IP headers
s.setsockopt(socket.IPPROTO_IP, socket.IP_HDRINCL, 1)
# receive all packages
s.ioctl(socket.SIO_RCVALL, socket.RCVALL_ON)
# receive a package
print s.recvfrom(65565)
# disabled promiscuous mode
s.ioctl(socket.SIO_RCVALL, socket.RCVALL_OFF)