"socket" --- 低水準ネットワークインターフェース
***********************************************

**ソースコード:** Lib/socket.py

======================================================================

このモジュールはBSDの *ソケット(socket)* インターフェイスへのアクセス
を提供します。これは、近代的なUnixシステム、Windows、MacOS、その他多く
のプラットフォームで動作します。

注釈:

  いくつかの挙動はプラットフォームに依存します。オペレーティングシステ
  ムのソケットAPIを呼び出しているためです。

Availability: not WASI.

このモジュールは WebAssembly では動作しないか、利用不可です。詳しくは
、WebAssembly プラットフォーム を見てください。

Pythonインターフェースは、Unixのソケット用システムコールとライブラリイ
ンターフェースを、そのままPythonのオブジェクト指向スタイルに変換したも
のです。各種ソケット関連のシステムコールは、 "socket()" 関数で生成され
る *socket オブジェクト* のメソッドとして実装されています。 メソッドの
引数は C のインターフェイスよりも多少高水準で、例えばファイルに対する
"read()" や "write()" メソッドと同様に、 受信時のバッファ確保は自動的
に処理され、送信時のバッファ長は暗黙的に決まります。

参考:

  Module "socketserver"
     ネットワークサーバの開発を省力化するためのクラス群。

  Module "ssl"
     ソケットオブジェクトに対する TLS/SSL ラッパー.


ソケットファミリー
==================

どのシステムで実行するかとビルドオプションに依存しますが、このモジュー
ルによって多様なソケットファミリーをサポートします。

特定のソケットオブジェクトによって必要とされるアドレスフォーマットは、
ソケットオブジェクトが生成されたときに指定されたアドレスファミリーを元
に自動的に選択されます。ソケットアドレスは次の通りです。

* ファイルシステム上のノードに束縛された "AF_UNIX" ソケットのアドレス
  は、ファイルシステムエンコーディングと "'surrogateescape'" エラーハ
  ンドラ (**PEP 383** を参照) を使って文字列として表現されます。 Linux
  の抽象名前空間のアドレスは、先頭が null バイトとなる *bytes-like
  object* として返されます。この名前空間のソケットは通常のファイルシス
  テム上のソケットと通信できるので、 Linux 上で動作することを意図した
  プログラムは両方のアドレスを扱う必要がある可能性があります。文字列と
  bytes-like オブジェクトはどちらのタイプのアドレスにも引数として渡す
  ことができます。

  バージョン 3.3 で変更: これまでは "AF_UNIX" ソケットパスは UTF-8 エ
  ンコーディングを使用するものとされていました。

  バージョン 3.5 で変更: 書き込み可能な *bytes-like object* を使用でき
  るようになりました。

* "AF_INET" アドレスファミリーには、 "(host, port)" ペアがアドレスとし
  て利用されます。 *host* はホスト名か "'daring.cwi.nl'" のようなイン
  ターネットドメインか、 "'100.50.200.5'" のような IPv4 アドレスで、
  *port* は整数です。

  * IPv4ではホストアドレスのほかに2つの特別な形式が使用できます。"''"
    はすべてのインターフェイスにバインドされるために使われる
    "INADDR_ANY" を表し、"'<broadcast>'" は "INADDR_BROADCAST" を表し
    ます。これらの動作はIPv6と互換性がありません。そのためもしもあなた
    がPythonプログラムでIPv6をサポートする予定があるのならばこれらを避
    けたほうが良いでしょう。

* For "AF_INET6" address family, a four-tuple "(host, port, flowinfo,
  scope_id)" is used, where *flowinfo* and *scope_id* represent the
  "sin6_flowinfo" and "sin6_scope_id" members in "struct sockaddr_in6"
  in C.  For "socket" module methods, *flowinfo* and *scope_id* can be
  omitted just for backward compatibility.  Note, however, omission of
  *scope_id* can cause problems in manipulating scoped IPv6 addresses.

  バージョン 3.7 で変更: For multicast addresses (with *scope_id*
  meaningful) *address* may not contain "%scope_id" (or "zone id")
  part. This information is superfluous and may be safely omitted
  (recommended).

* "AF_NETLINK" ソケットのアドレスは "(pid, groups)" のペアで表されます
  。

* Linux 限定で、 "AF_TIPC" アドレスファミリーを用いて TIPC がサポート
  されます。 TIPC は、クラスタコンピューティング環境のために設計された
  、IP ベースではないオープンなネットワークプロトコルです。アドレスは
  タプルで表現され、フィールドはアドレスタイプに依存します。一般的なタ
  プルの形式は "(addr_type, v1, v2, v3 [, scope])" で、それぞれは次の
  通りです:

  * *addr_type* は "TIPC_ADDR_NAMESEQ", "TIPC_ADDR_NAME",
    "TIPC_ADDR_ID" の1つ。

  * *scope* は "TIPC_ZONE_SCOPE", "TIPC_CLUSTER_SCOPE",
    "TIPC_NODE_SCOPE" の1つ。

  * *addr_type* が "TIPC_ADDR_NAME" の場合、 *v1* はサーバータイプ、
    *v2* はポートID (the port identifier)、そして *v3* は 0 であるべき
    です。

    *addr_type* が "TIPC_ADDR_NAMESEQ" の場合、 *v1* はサーバータイプ
    、 *v2* はポート番号下位(lower port number)、 *v3* はポート番号上
    位(upper port number) です。

    *addr_type* が "TIPC_ADDR_ID" の場合、 *v1* はノード、 *v2* は参照
    、 *v3* は0であるべきです。

* "AF_CAN" アドレスファミリーには "(interface, )" というタプルを利用し
  ます。 *interface* は "'can0'" のようなネットワークインターフェース
  名を表す文字列です。このファミリーの全てのネットワークインターフェー
  スからパケットを受信するために、ネットワークインターフェース名 "''"
  を利用できます。

  * "CAN_ISOTP" protocol requires a tuple "(interface, rx_addr,
    tx_addr)" where both additional parameters are unsigned long
    integer that represent a CAN identifier (standard or extended).

  * "CAN_J1939" protocol requires a tuple "(interface, name, pgn,
    addr)" where additional parameters are 64-bit unsigned integer
    representing the ECU name, a 32-bit unsigned integer representing
    the Parameter Group Number (PGN), and an 8-bit integer
    representing the address.

* 文字列またはタプル "(id, unit)" は "PF_SYSTEM" ファミリーの
  "SYSPROTO_CONTROL" プロトコルのために使用されます。この文字列は、動
  的に割り当てられたIDによるカーネルコントロールの名前です。このタプル
  は、カーネルコントロールのIDとユニット番号が既知の場合、または登録済
  みIDが使用中の場合に使用することができます。

  Added in version 3.3.

* "AF_BLUETOOTH" は以下のプロトコルとアドレスフォーマットをサポートし
  ています。

  * "BTPROTO_L2CAP" accepts a tuple "(bdaddr, psm[, cid[,
    bdaddr_type]])" where:

    * "bdaddr" is a string specifying the Bluetooth address.

    * "psm" is an integer specifying the Protocol/Service Multiplexer.

    * "cid" is an optional integer specifying the Channel Identifier.
      If not given, defaults to zero.

    * "bdaddr_type" is an optional integer specifying the address
      type; one of "BDADDR_BREDR" (default), "BDADDR_LE_PUBLIC",
      "BDADDR_LE_RANDOM".

    バージョン 3.14 で変更: Added "cid" and "bdaddr_type" fields.

  * "BTPROTO_RFCOMM" は "(bdaddr, channel)" を受け取ります。 "bdaddr"
    は Bluetooth アドレスを表す文字列で、 "channel" は整数です。

  * "BTPROTO_HCI" accepts a format that depends on your OS.

    * On Linux it accepts an integer "device_id" or a tuple
      "(device_id, [channel])" where "device_id" specifies the number
      of the Bluetooth device, and "channel" is an optional integer
      specifying the HCI channel ("HCI_CHANNEL_RAW" by default).

    * On FreeBSD, NetBSD and DragonFly BSD it accepts "bdaddr" where
      "bdaddr" is the Bluetooth address as a string.

    バージョン 3.2 で変更: NetBSD と DragonFlyBSD のサポートが追加され
    ました。

    バージョン 3.13.3 で変更: FreeBSD support added.

    バージョン 3.14 で変更: Added "channel" field. "device_id" not
    packed in a tuple is now accepted.

  * "BTPROTO_SCO" accepts "bdaddr" where "bdaddr" is the Bluetooth
    address as a string or a "bytes" object. (ex.
    "'12:23:34:45:56:67'" or "b'12:23:34:45:56:67'")

    バージョン 3.14 で変更: FreeBSD support added.

* "AF_ALG" はカーネル暗号へのソケットベースのインターフェイスで、Linux
  でのみ使用できます。アルゴリズムソケットは、2 つから 4 つの要素を持
  つタプル "(type, name [, feat [, mask]])" で構成されます。各要素の意
  味は、以下の通りです。

  * *type* はアルゴリズムタイプを示す文字列です。例: "aead", "hash",
    "skcipher" または "rng"。

  * *name* はアルゴリズム名及び操作モードを示す文字列です。例:
    "sha256", "hmac(sha256)", "cbc(aes)" または "drbg_nopr_ctr_aes256"
    。

  * *feat* と *mask* は、符号を持たない 32 ビットの整数です。

  Availability: Linux >= 2.6.38.

  一部のアルゴリズムタイプでは、さらに新しいカーネルが必要です。

  Added in version 3.6.

* "AF_VSOCK" allows communication between virtual machines and their
  hosts. The sockets are represented as a "(CID, port)" tuple where
  the context ID or CID and port are integers.

  Availability: Linux >= 3.9

  See *vsock(7)*

  Added in version 3.7.

* "AF_PACKET" is a low-level interface directly to network devices.
  The addresses are represented by the tuple "(ifname, proto[,
  pkttype[, hatype[, addr]]])" where:

  * *ifname* - デバイス名を指定する文字列。

  * *proto* - The Ethernet protocol number. May be "ETH_P_ALL" to
    capture all protocols, one of the ETHERTYPE_* constants or any
    other Ethernet protocol number.

  * *pkttype* - パケットタイプを指定するオプションの整数:

    * "PACKET_HOST" (the default) - Packet addressed to the local
      host.

    * "PACKET_BROADCAST" - Physical-layer broadcast packet.

    * "PACKET_MULTICAST" - Packet sent to a physical-layer multicast
      address.

    * "PACKET_OTHERHOST" - Packet to some other host that has been
      caught by a device driver in promiscuous mode.

    * "PACKET_OUTGOING" - Packet originating from the local host that
      is looped back to a packet socket.

  * *hatype* - Optional integer specifying the ARP hardware address
    type.

  * *addr* - Optional bytes-like object specifying the hardware
    physical address, whose interpretation depends on the device.

  Availability: Linux >= 2.2.

* "AF_QIPCRTR" is a Linux-only socket based interface for
  communicating with services running on co-processors in Qualcomm
  platforms. The address family is represented as a "(node, port)"
  tuple where the *node* and *port* are non-negative integers.

  Availability: Linux >= 4.7.

  Added in version 3.8.

* "IPPROTO_UDPLITE" is a variant of UDP which allows you to specify
  what portion of a packet is covered with the checksum. It adds two
  socket options that you can change.
  "self.setsockopt(IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV, length)" will
  change what portion of outgoing packets are covered by the checksum
  and "self.setsockopt(IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV, length)"
  will filter out packets which cover too little of their data. In
  both cases "length" should be in "range(8, 2**16, 8)".

  Such a socket should be constructed with "socket(AF_INET,
  SOCK_DGRAM, IPPROTO_UDPLITE)" for IPv4 or "socket(AF_INET6,
  SOCK_DGRAM, IPPROTO_UDPLITE)" for IPv6.

  Availability: Linux >= 2.6.20, FreeBSD >= 10.1

  Added in version 3.9.

* "AF_HYPERV" is a Windows-only socket based interface for
  communicating with Hyper-V hosts and guests. The address family is
  represented as a "(vm_id, service_id)" tuple where the "vm_id" and
  "service_id" are UUID strings.

  The "vm_id" is the virtual machine identifier or a set of known VMID
  values if the target is not a specific virtual machine. Known VMID
  constants defined on "socket" are:

  * "HV_GUID_ZERO"

  * "HV_GUID_BROADCAST"

  * "HV_GUID_WILDCARD" - Used to bind on itself and accept connections
    from all partitions.

  * "HV_GUID_CHILDREN" - Used to bind on itself and accept connection
    from child partitions.

  * "HV_GUID_LOOPBACK" - Used as a target to itself.

  * "HV_GUID_PARENT" - When used as a bind accepts connection from the
    parent partition. When used as an address target it will connect
    to the parent partition.

  The "service_id" is the service identifier of the registered
  service.

  Added in version 3.12.

IPv4/v6ソケットの *host* 部にホスト名を指定すると、処理結果が一定では
ない場合があります。これはPythonはDNSから取得したアドレスのうち最初の
アドレスを使用するので、 DNSの処理やホストの設定によって異なるIPv4/6ア
ドレスを取得する場合があるためです。常に同じ結果が必要であれば、
*host* に数値のアドレスを指定してください。

エラー時には例外が発生します。引数型のエラーやメモリ不足の場合には通常
の例外が発生し、ソケットやアドレス関連のエラーの場合は "OSError" また
はそのサブクラスが発生します。

"setblocking()" メソッドで、非ブロッキングモードを使用することができま
す。また、より汎用的に "settimeout()" メソッドでタイムアウトを指定する
事ができます。


モジュールの内容
================

The module "socket" exports the following elements.


例外
----

exception socket.error

   "OSError" の非推奨のエイリアスです。

   バージョン 3.3 で変更: **PEP 3151** に基づき、このクラスは
   "OSError" のエイリアスになりました。

exception socket.herror

   "OSError" のサブクラス。この例外はアドレス関連のエラー、つまり
   "gethostbyname_ex()" と "gethostbyaddr()" などの、 POSIX C API の
   *h_errno* を利用する関数のために利用されます。例外に付随する
   "(h_errno, string)" ペアはライブラリの呼び出しによって返されたエラ
   ーを表します。 *h_errno* は数値で、 *string* は、 "hstrerror()" C関
   数によって返される *h_errno* を説明する文字列です。

   バージョン 3.3 で変更: このクラスは "OSError" のサブクラスになりま
   した。

exception socket.gaierror

   A subclass of "OSError", this exception is raised for address-
   related errors by "getaddrinfo()" and "getnameinfo()". The
   accompanying value is a pair "(error, string)" representing an
   error returned by a library call.  *string* represents the
   description of *error*, as returned by the "gai_strerror()" C
   function.  The numeric *error* value will match one of the "EAI_*"
   constants defined in this module.

   バージョン 3.3 で変更: このクラスは "OSError" のサブクラスになりま
   した。

exception socket.timeout

   "TimeoutError" の非推奨のエイリアスです。

   "OSError" のサブクラスです。この例外は、あらかじめ "settimeout()"
   を呼び出して (あるいは "setdefaulttimeout()" を利用して暗黙に) タイ
   ムアウトを有効にしてあるソケットでタイムアウトが生じた際に送出され
   ます。 例外に付属する値は文字列で、その内容は現状では常に "timed
   out" となります。

   バージョン 3.3 で変更: このクラスは "OSError" のサブクラスになりま
   した。

   バージョン 3.10 で変更: このクラスは "TimeoutError" のエイリアスに
   なりました。


定数
----

AF_* 定数と SOCK_* 定数は、 "AddressFamily" と "SocketKind" "IntEnum"
collection になりました。

Added in version 3.4.

socket.AF_UNIX
socket.AF_INET
socket.AF_INET6

   These constants represent the address (and protocol) families, used
   for the first argument to "socket()".  If the "AF_UNIX" constant is
   not defined then this protocol is unsupported.  More constants may
   be available depending on the system.

socket.AF_UNSPEC

   "AF_UNSPEC" means that "getaddrinfo()" should return socket
   addresses for any address family (either IPv4, IPv6, or any other)
   that can be used.

socket.SOCK_STREAM
socket.SOCK_DGRAM
socket.SOCK_RAW
socket.SOCK_RDM
socket.SOCK_SEQPACKET

   These constants represent the socket types, used for the second
   argument to "socket()".  More constants may be available depending
   on the system. (Only "SOCK_STREAM" and "SOCK_DGRAM" appear to be
   generally useful.)

socket.SOCK_CLOEXEC
socket.SOCK_NONBLOCK

   この2つの定数が定義されていた場合、ソケットタイプと組み合わせていく
   つかの flags をアトミックに設定することができます (別の呼び出しを不
   要にして競合状態を避ける事ができます)。

   参考: より完全な説明は Secure File Descriptor Handling を参照してくださ
       い。

   Availability: Linux >= 2.6.27.

   Added in version 3.2.

SO_*
socket.SOMAXCONN
MSG_*
SOL_*
SCM_*
IPPROTO_*
IPPORT_*
INADDR_*
IP_*
IPV6_*
EAI_*
AI_*
NI_*
TCP_*

   Many constants of these forms, documented in the Unix documentation
   on sockets and/or the IP protocol, are also defined in the socket
   module. They are generally used in arguments to the "setsockopt()"
   and "getsockopt()" methods of socket objects.  In most cases, only
   those symbols that are defined in the Unix header files are
   defined; for a few symbols, default values are provided.

   バージョン 3.6 で変更: "SO_DOMAIN", "SO_PROTOCOL", "SO_PEERSEC",
   "SO_PASSSEC", "TCP_USER_TIMEOUT", "TCP_CONGESTION" が追加されました
   。

   バージョン 3.6.5 で変更: Added support for "TCP_FASTOPEN",
   "TCP_KEEPCNT" on Windows platforms when available.

   バージョン 3.7 で変更: "TCP_NOTSENT_LOWAT" が追加されました。Added
   support for "TCP_KEEPIDLE", "TCP_KEEPINTVL" on Windows platforms
   when available.

   バージョン 3.10 で変更: "IP_RECVTOS" was added.  Added
   "TCP_KEEPALIVE". On MacOS this constant can be used in the same
   way that "TCP_KEEPIDLE" is used on Linux.

   バージョン 3.11 で変更: Added "TCP_CONNECTION_INFO". On MacOS this
   constant can be used in the same way that "TCP_INFO" is used on
   Linux and BSD.

   バージョン 3.12 で変更: Added "SO_RTABLE" and "SO_USER_COOKIE". On
   OpenBSD and FreeBSD respectively those constants can be used in the
   same way that "SO_MARK" is used on Linux. Also added missing TCP
   socket options from Linux: "TCP_MD5SIG",
   "TCP_THIN_LINEAR_TIMEOUTS", "TCP_THIN_DUPACK", "TCP_REPAIR",
   "TCP_REPAIR_QUEUE", "TCP_QUEUE_SEQ", "TCP_REPAIR_OPTIONS",
   "TCP_TIMESTAMP", "TCP_CC_INFO", "TCP_SAVE_SYN", "TCP_SAVED_SYN",
   "TCP_REPAIR_WINDOW", "TCP_FASTOPEN_CONNECT", "TCP_ULP",
   "TCP_MD5SIG_EXT", "TCP_FASTOPEN_KEY", "TCP_FASTOPEN_NO_COOKIE",
   "TCP_ZEROCOPY_RECEIVE", "TCP_INQ", "TCP_TX_DELAY". Added
   "IP_PKTINFO", "IP_UNBLOCK_SOURCE", "IP_BLOCK_SOURCE",
   "IP_ADD_SOURCE_MEMBERSHIP", "IP_DROP_SOURCE_MEMBERSHIP".

   バージョン 3.13 で変更: Added "SO_BINDTOIFINDEX". On Linux this
   constant can be used in the same way that "SO_BINDTODEVICE" is
   used, but with the index of a network interface instead of its
   name.

   バージョン 3.14 で変更: Added missing "IP_FREEBIND", "IP_RECVERR",
   "IPV6_RECVERR", "IP_RECVTTL", and "IP_RECVORIGDSTADDR" on Linux.

   バージョン 3.14 で変更: Added support for "TCP_QUICKACK" on Windows
   platforms when available.

socket.AF_CAN
socket.PF_CAN
SOL_CAN_*
CAN_*

   Linux ドキュメントにあるこの形式の定数は socket モジュールでも定義
   されています。

   Availability: Linux >= 2.6.25, NetBSD >= 8.

   Added in version 3.3.

   バージョン 3.11 で変更: NetBSD サポートが追加されました。

   バージョン 3.14 で変更: Restored missing "CAN_RAW_ERR_FILTER" on
   Linux.

socket.CAN_BCM
CAN_BCM_*

   CANプロトコルファミリーのCAN_BCMは、ブロードキャストマネージャー
   (BCM)プロトコルです。Linuxドキュメントにあるこの形式の定数は、
   socketモジュールでも定義されています。

   Availability: Linux >= 2.6.25.

   注釈:

     The "CAN_BCM_CAN_FD_FRAME" flag is only available on Linux >=
     4.8.

   Added in version 3.4.

socket.CAN_RAW_FD_FRAMES

   CAN_RAW ソケットで CAN FD をサポートします。これはデフォルトで無効
   になっています。これにより、アプリケーションが CAN フレームと CAN
   FD フレームを送信できるようになります。ただし、ソケットからの読み出
   し時に、CAN と CAN FD の両方のフレームを受け入れなければなりません
   。

   この定数は、 Linux のドキュメンテーションで説明されています。

   Availability: Linux >= 3.6.

   Added in version 3.5.

socket.CAN_RAW_JOIN_FILTERS

   Joins the applied CAN filters such that only CAN frames that match
   all given CAN filters are passed to user space.

   この定数は、 Linux のドキュメンテーションで説明されています。

   Availability: Linux >= 4.1.

   Added in version 3.9.

socket.CAN_ISOTP

   CAN_ISOTP, in the CAN protocol family, is the ISO-TP (ISO 15765-2)
   protocol. ISO-TP constants, documented in the Linux documentation.

   Availability: Linux >= 2.6.25.

   Added in version 3.7.

socket.CAN_J1939

   CAN_J1939, in the CAN protocol family, is the SAE J1939 protocol.
   J1939 constants, documented in the Linux documentation.

   Availability: Linux >= 5.4.

   Added in version 3.9.

socket.AF_DIVERT
socket.PF_DIVERT

   These two constants, documented in the FreeBSD divert(4) manual
   page, are also defined in the socket module.

   Availability: FreeBSD >= 14.0.

   Added in version 3.12.

socket.AF_PACKET
socket.PF_PACKET
PACKET_*

   Linux ドキュメントにあるこの形式の定数は socket モジュールでも定義
   されています。

   Availability: Linux >= 2.2.

socket.ETH_P_ALL

   "ETH_P_ALL" can be used in the "socket" constructor as *proto* for
   the "AF_PACKET" family in order to capture every packet, regardless
   of protocol.

   For more information, see the *packet(7)* manpage.

   Availability: Linux.

   Added in version 3.12.

socket.AF_RDS
socket.PF_RDS
socket.SOL_RDS
RDS_*

   Linux ドキュメントにあるこの形式の定数は socket モジュールでも定義
   されています。

   Availability: Linux >= 2.6.30.

   Added in version 3.3.

socket.SIO_RCVALL
socket.SIO_KEEPALIVE_VALS
socket.SIO_LOOPBACK_FAST_PATH
RCVALL_*

   Windows の WSAIoctl() のための定数です。この定数はソケットオブジェ
   クトの "ioctl()" メソッドに引数として渡されます。

   バージョン 3.6 で変更: "SIO_LOOPBACK_FAST_PATH" が追加されました。

TIPC_*

   TIPC 関連の定数で、C のソケットAPIが公開しているものにマッチします
   。詳しい情報は TIPC のドキュメントを参照してください。

socket.AF_ALG
socket.SOL_ALG
ALG_*

   Linux カーネル暗号用の定数です。

   Availability: Linux >= 2.6.38.

   Added in version 3.6.

socket.AF_VSOCK
socket.IOCTL_VM_SOCKETS_GET_LOCAL_CID
VMADDR*
SO_VM*

   Constants for Linux host/guest communication.

   Availability: Linux >= 4.8.

   Added in version 3.7.

socket.AF_LINK

   Availability: BSD, macOS.

   Added in version 3.4.

socket.has_ipv6

   現在のプラットフォームでIPv6がサポートされているか否かを示す真偽値
   。

socket.AF_BLUETOOTH
socket.BTPROTO_L2CAP
socket.BTPROTO_RFCOMM
socket.BTPROTO_HCI
socket.BTPROTO_SCO

   Integer constants for use with Bluetooth addresses.

socket.BDADDR_ANY
socket.BDADDR_LOCAL

   これらは、特別な意味を持つ Bluetooth アドレスを含む文字列定数です。
   例えば、"BDADDR_ANY" を使用すると、 "BTPROTO_RFCOMM" で束縛ソケット
   を指定する際に、任意のアドレスを指し示すことができます。

socket.BDADDR_BREDR
socket.BDADDR_LE_PUBLIC
socket.BDADDR_LE_RANDOM

   These constants describe the Bluetooth address type when binding or
   connecting a "BTPROTO_L2CAP" socket.

   Availability: Linux, FreeBSD

   Added in version 3.14.

socket.SOL_RFCOMM
socket.SOL_L2CAP
socket.SOL_HCI
socket.SOL_SCO
socket.SOL_BLUETOOTH

   Used in the level argument to the "setsockopt()" and "getsockopt()"
   methods of Bluetooth socket objects.

   "SOL_BLUETOOTH" is only available on Linux. Other constants are
   available if the corresponding protocol is supported.

SO_L2CAP_*
socket.L2CAP_LM
L2CAP_LM_*
SO_RFCOMM_*
RFCOMM_LM_*
SO_SCO_*
SO_BTH_*
BT_*

   Used in the option name and value argument to the "setsockopt()"
   and "getsockopt()" methods of Bluetooth socket objects.

   "BT_*" and "L2CAP_LM" are only available on Linux. "SO_BTH_*" are
   only available on Windows. Other constants may be available on
   Linux and various BSD platforms.

   Added in version 3.14.

socket.HCI_FILTER
socket.HCI_TIME_STAMP
socket.HCI_DATA_DIR
socket.SO_HCI_EVT_FILTER
socket.SO_HCI_PKT_FILTER

   Option names for use with "BTPROTO_HCI". Availability and format of
   the option values depend on platform.

   バージョン 3.14 で変更: Added "SO_HCI_EVT_FILTER" and
   "SO_HCI_PKT_FILTER" on NetBSD and DragonFly BSD. Added
   "HCI_DATA_DIR" on FreeBSD, NetBSD and DragonFly BSD.

socket.HCI_DEV_NONE

   The "device_id" value used to create an HCI socket that isn't
   specific to a single Bluetooth adapter.

   Availability: Linux

   Added in version 3.14.

socket.HCI_CHANNEL_RAW
socket.HCI_CHANNEL_USER
socket.HCI_CHANNEL_MONITOR
socket.HCI_CHANNEL_CONTROL
socket.HCI_CHANNEL_LOGGING

   Possible values for "channel" field in the "BTPROTO_HCI" address.

   Availability: Linux

   Added in version 3.14.

socket.AF_QIPCRTR

   Constant for Qualcomm's IPC router protocol, used to communicate
   with service providing remote processors.

   Availability: Linux >= 4.7.

socket.SCM_CREDS2
socket.LOCAL_CREDS
socket.LOCAL_CREDS_PERSISTENT

   LOCAL_CREDS and LOCAL_CREDS_PERSISTENT can be used with SOCK_DGRAM,
   SOCK_STREAM sockets, equivalent to Linux/DragonFlyBSD SO_PASSCRED,
   while LOCAL_CREDS sends the credentials at first read,
   LOCAL_CREDS_PERSISTENT sends for each read, SCM_CREDS2 must be then
   used for the latter for the message type.

   Added in version 3.11.

   Availability: FreeBSD.

socket.SO_INCOMING_CPU

   Constant to optimize CPU locality, to be used in conjunction with
   "SO_REUSEPORT".

   Added in version 3.11.

   Availability: Linux >= 3.9

socket.SO_REUSEPORT_LB

      Constant to enable duplicate address and port bindings with load
      balancing.

   Added in version 3.14.

   Availability: FreeBSD >= 12.0

socket.AF_HYPERV
socket.HV_PROTOCOL_RAW
socket.HVSOCKET_CONNECT_TIMEOUT
socket.HVSOCKET_CONNECT_TIMEOUT_MAX
socket.HVSOCKET_CONNECTED_SUSPEND
socket.HVSOCKET_ADDRESS_FLAG_PASSTHRU
socket.HV_GUID_ZERO
socket.HV_GUID_WILDCARD
socket.HV_GUID_BROADCAST
socket.HV_GUID_CHILDREN
socket.HV_GUID_LOOPBACK
socket.HV_GUID_PARENT

   Constants for Windows Hyper-V sockets for host/guest
   communications.

   Availability: Windows.

   Added in version 3.12.

socket.ETHERTYPE_ARP
socket.ETHERTYPE_IP
socket.ETHERTYPE_IPV6
socket.ETHERTYPE_VLAN

   IEEE 802.3 protocol number. constants.

   Availability: Linux, FreeBSD, macOS.

   Added in version 3.12.

socket.SHUT_RD
socket.SHUT_WR
socket.SHUT_RDWR

   These constants are used by the "shutdown()" method of socket
   objects.

   Availability: not WASI.


関数
----


ソケットの作成
~~~~~~~~~~~~~~

以下の関数は全て socket object を生成します。

The "socket" class constructor creates a new socket directly; see
socket オブジェクト for its parameters and full description.

socket.socketpair([family[, type[, proto]]])

   Build a pair of connected socket objects using the given address
   family, socket type, and protocol number.  Address family, socket
   type, and protocol number are as for the "socket()" function. The
   default family is "AF_UNIX" if defined on the platform; otherwise,
   the default is "AF_INET".

   新たに作成されたソケットは 継承不可 です。

   バージョン 3.2 で変更: 返されるソケットオブジェクトが、サブセットで
   はなく完全なソケットAPIを提供するようになりました。

   バージョン 3.4 で変更: 返されるソケットの組は、どちらも継承不可にな
   りました。

   バージョン 3.5 で変更: Windows のサポートが追加されました。

socket.create_connection(address, timeout=GLOBAL_DEFAULT, source_address=None, *, all_errors=False)

   インターネット *address* ("(host, port)" ペア) で listen している
   TCPサービスに接続し、ソケットオブジェクトを返します。これは
   "socket.connect()" を高級にした関数です。 *host* が数値でないホスト
   名の場合、 "AF_INET" と "AF_INET6" の両方で名前解決を試み、得られた
   全てのアドレスに対して成功するまで接続を試みます。この関数を使って
   IPv4 と IPv6 に両対応したクライアントを簡単に書くことができます。

   オプションの *timeout* 引数を指定すると、接続を試みる前にソケットオ
   ブジェクトのタイムアウトを設定します。 *timeout* が指定されない場合
   、 "getdefaulttimeout()" が返すデフォルトのタイムアウト設定値を利用
   します。

   *source_address* は接続する前にバインドするソースアドレスを指定する
   オプション引数で、指定する場合は "(host, port)" の2要素タプルでなけ
   ればなりません。 host や port が '' か 0 だった場合は、OSのデフォル
   トの動作になります。

   When a connection cannot be created, an exception is raised. By
   default, it is the exception from the last address in the list. If
   *all_errors* is "True", it is an "ExceptionGroup" containing the
   errors of all attempts.

   バージョン 3.2 で変更: *source_address* が追加されました。

   バージョン 3.11 で変更: *all_errors* が追加されました

socket.create_server(address, *, family=AF_INET, backlog=None, reuse_port=False, dualstack_ipv6=False)

   Convenience function which creates a TCP socket bound to *address*
   (a 2-tuple "(host, port)") and returns the socket object.

   *family* should be either "AF_INET" or "AF_INET6". *backlog* is the
   queue size passed to "socket.listen()"; if not specified , a
   default reasonable value is chosen. *reuse_port* dictates whether
   to set the "SO_REUSEPORT" socket option.

   If *dualstack_ipv6* is true, *family* is "AF_INET6" and the
   platform supports it the socket will be able to accept both IPv4
   and IPv6 connections, else it will raise "ValueError". Most POSIX
   platforms and Windows are supposed to support this functionality.
   When this functionality is enabled the address returned by
   "socket.getpeername()" when an IPv4 connection occurs will be an
   IPv6 address represented as an IPv4-mapped IPv6 address. If
   *dualstack_ipv6* is false it will explicitly disable this
   functionality on platforms that enable it by default (e.g. Linux).
   This parameter can be used in conjunction with
   "has_dualstack_ipv6()":

      import socket

      addr = ("", 8080)  # all interfaces, port 8080
      if socket.has_dualstack_ipv6():
          s = socket.create_server(addr, family=socket.AF_INET6, dualstack_ipv6=True)
      else:
          s = socket.create_server(addr)

   注釈:

     On POSIX platforms the "SO_REUSEADDR" socket option is set in
     order to immediately reuse previous sockets which were bound on
     the same *address* and remained in TIME_WAIT state.

   Added in version 3.8.

socket.has_dualstack_ipv6()

   Return "True" if the platform supports creating a TCP socket which
   can handle both IPv4 and IPv6 connections.

   Added in version 3.8.

socket.fromfd(fd, family, type, proto=0)

   Duplicate the file descriptor *fd* (an integer as returned by a
   file object's "fileno()" method) and build a socket object from the
   result.  Address family, socket type and protocol number are as for
   the "socket()" function. The file descriptor should refer to a
   socket, but this is not checked --- subsequent operations on the
   object may fail if the file descriptor is invalid. This function is
   rarely needed, but can be used to get or set socket options on a
   socket passed to a program as standard input or output (such as a
   server started by the Unix inet daemon).  The socket is assumed to
   be in blocking mode.

   新たに作成されたソケットは 継承不可  です。

   バージョン 3.4 で変更: 返されるソケットは継承不可になりました。

socket.fromshare(data)

   "socket.share()" メソッドから取得した data からソケットオブジェクト
   を生成します。ソケットはブロッキングモードだと仮定されます。

   Availability: Windows.

   Added in version 3.3.


その他の関数
~~~~~~~~~~~~

The "socket" module also offers various network-related services:

socket.close(fd)

   Close a socket file descriptor. This is like "os.close()", but for
   sockets. On some platforms (most notably Windows) "os.close()" does
   not work for socket file descriptors.

   Added in version 3.7.

socket.getaddrinfo(host, port, family=AF_UNSPEC, type=0, proto=0, flags=0)

   This function wraps the C function "getaddrinfo" of the underlying
   system.

   *host* / *port* 引数の指すアドレス情報を、そのサービスに接続された
   ソケットを作成するために必要な全ての引数が入った 5 要素のタプルに変
   換します。 *host* はドメイン名、IPv4/v6アドレスの文字列、または
   "None" です。 *port* は "'http'" のようなサービス名文字列、ポート番
   号を表す数値、または "None" です。 *host* と *port* に "None" を指
   定すると C APIに "NULL" を渡せます。

   The *family*, *type* and *proto* arguments can be optionally
   specified in order to provide options and limit the list of
   addresses returned. Pass their default values ("AF_UNSPEC", 0, and
   0, respectively) to not limit the results. See the note below for
   details.

   The *flags* argument can be one or several of the "AI_*" constants,
   and will influence how results are computed and returned. For
   example, "AI_NUMERICHOST" will disable domain name resolution and
   will raise an error if *host* is a domain name.

   この関数は以下の構造をとる 5 要素のタプルのリストを返します:

   "(family, type, proto, canonname, sockaddr)"

   In these tuples, *family*, *type*, *proto* are all integers and are
   meant to be passed to the "socket()" function.  *canonname* will be
   a string representing the canonical name of the *host* if
   "AI_CANONNAME" is part of the *flags* argument; else *canonname*
   will be empty.  *sockaddr* is a tuple describing a socket address,
   whose format depends on the returned *family* (a "(address, port)"
   2-tuple for "AF_INET", a "(address, port, flowinfo, scope_id)"
   4-tuple for "AF_INET6"), and is meant to be passed to the
   "socket.connect()" method.

   注釈:

     If you intend to use results from "getaddrinfo()" to create a
     socket (rather than, for example, retrieve *canonname*), consider
     limiting the results by *type* (e.g. "SOCK_STREAM" or
     "SOCK_DGRAM") and/or *proto* (e.g. "IPPROTO_TCP" or
     "IPPROTO_UDP") that your application can handle.The behavior with
     default values of *family*, *type*, *proto* and *flags* is
     system-specific.Many systems (for example, most Linux
     configurations) will return a sorted list of all matching
     addresses. These addresses should generally be tried in order
     until a connection succeeds (possibly tried in parallel, for
     example, using a Happy Eyeballs algorithm). In these cases,
     limiting the *type* and/or *proto* can help eliminate
     unsuccessful or unusable connection attempts.Some systems will,
     however, only return a single address. (For example, this was
     reported on Solaris and AIX configurations.) On these systems,
     limiting the *type* and/or *proto* helps ensure that this address
     is usable.

   引数 "host", "port", "family", "type", "protocol" 付きで 監査イベン
   ト "socket.getaddrinfo" を送出します。

   次の例では "example.org" の 80 番ポートポートへの TCP 接続を得るた
   めのアドレス情報を取得しようとしています。 (結果は IPv6 をサポート
   しているかどうかで変わります):

      >>> socket.getaddrinfo("example.org", 80, proto=socket.IPPROTO_TCP)
      [(socket.AF_INET6, socket.SOCK_STREAM,
       6, '', ('2606:2800:220:1:248:1893:25c8:1946', 80, 0, 0)),
       (socket.AF_INET, socket.SOCK_STREAM,
       6, '', ('93.184.216.34', 80))]

   バージョン 3.2 で変更: パラメータをキーワード引数で渡すことができる
   ようになりました。

   バージョン 3.7 で変更: for IPv6 multicast addresses, string
   representing an address will not contain "%scope_id" part.

socket.getfqdn([name])

   Return a fully qualified domain name for *name*. If *name* is
   omitted or empty, it is interpreted as the local host.  To find the
   fully qualified name, the hostname returned by "gethostbyaddr()" is
   checked, followed by aliases for the host, if available.  The first
   name which includes a period is selected.  In case no fully
   qualified domain name is available and *name* was provided, it is
   returned unchanged.  If *name* was empty or equal to "'0.0.0.0'",
   the hostname from "gethostname()" is returned.

socket.gethostbyname(hostname)

   ホスト名を "'100.50.200.5'" のようなIPv4形式のアドレスに変換します
   。ホスト名としてIPv4アドレスを指定した場合、その値は変換せずにその
   まま返ります。 "gethostbyname()" APIへのより完全なインターフェイス
   が必要であれば、 "gethostbyname_ex()" を参照してください。
   "gethostbyname()" は、IPv6名前解決をサポートしていません。IPv4/ v6
   のデュアルスタックをサポートする場合は "getaddrinfo()" を使用します
   。

   引数 "hostname" を指定して 監査イベント "socket.gethostbyname" を送
   出します。

   Availability: not WASI.

socket.gethostbyname_ex(hostname)

   Translate a host name to IPv4 address format, extended interface.
   Return a 3-tuple "(hostname, aliaslist, ipaddrlist)" where
   *hostname* is the host's primary host name, *aliaslist* is a
   (possibly empty) list of alternative host names for the same
   address, and *ipaddrlist* is a list of IPv4 addresses for the same
   interface on the same host (often but not always a single address).
   "gethostbyname_ex()" does not support IPv6 name resolution, and
   "getaddrinfo()" should be used instead for IPv4/v6 dual stack
   support.

   引数 "hostname" を指定して 監査イベント "socket.gethostbyname" を送
   出します。

   Availability: not WASI.

socket.gethostname()

   Pythonインタープリタを現在実行しているマシンのホスト名を含む文字列
   を返します。

   引数無しで 監査イベント "socket.gethostname" を送出します。

   注意: "gethostname()" は完全修飾ドメイン名を返すとは限りません。完
   全修飾ドメイン名が必要であれば、"getfqdn()" を使用してください。

   Availability: not WASI.

socket.gethostbyaddr(ip_address)

   Return a 3-tuple "(hostname, aliaslist, ipaddrlist)" where
   *hostname* is the primary host name responding to the given
   *ip_address*, *aliaslist* is a (possibly empty) list of alternative
   host names for the same address, and *ipaddrlist* is a list of
   IPv4/v6 addresses for the same interface on the same host (most
   likely containing only a single address). To find the fully
   qualified domain name, use the function "getfqdn()".
   "gethostbyaddr()" supports both IPv4 and IPv6.

   引数 "ip_address" を指定して 監査イベント "socket.gethostbyaddr" を
   送出します。

   Availability: not WASI.

socket.getnameinfo(sockaddr, flags)

   Translate a socket address *sockaddr* into a 2-tuple "(host,
   port)". Depending on the settings of *flags*, the result can
   contain a fully qualified domain name or numeric address
   representation in *host*.  Similarly, *port* can contain a string
   port name or a numeric port number.

   For IPv6 addresses, "%scope_id" is appended to the host part if
   *sockaddr* contains meaningful *scope_id*. Usually this happens for
   multicast addresses.

   For more information about *flags* you can consult
   *getnameinfo(3)*.

   引数 "sockaddr" を指定して 監査イベント "socket.getnameinfo" を送出
   します。

   Availability: not WASI.

socket.getprotobyname(protocolname)

   Translate an internet protocol name (for example, "'icmp'") to a
   constant suitable for passing as the (optional) third argument to
   the "socket()" function.  This is usually only needed for sockets
   opened in "raw" mode ("SOCK_RAW"); for the normal socket modes, the
   correct protocol is chosen automatically if the protocol is omitted
   or zero.

   Availability: not WASI.

socket.getservbyname(servicename[, protocolname])

   インターネットサービス名とプロトコルから、そのサービスのポート番号
   を取得します。省略可能なプロトコル名として、 "'tcp'" か "'udp'" の
   どちらかを指定することができます。指定がなければどちらのプロトコル
   にもマッチします。

   引数 "servicename", "protocolname" を指定して 監査イベント
   "socket.getservbyname" を送出します。

   Availability: not WASI.

socket.getservbyport(port[, protocolname])

   インターネットポート番号とプロトコル名から、サービス名を取得します
   。省略可能なプロトコル名として、 "'tcp'" か "'udp'" のどちらかを指
   定することができます。指定がなければどちらのプロトコルにもマッチし
   ます。

   引数 "port", "protocolname" を指定して 監査イベント
   "socket.getservbyport" を送出します。

   Availability: not WASI.

socket.ntohl(x)

   32ビットの正の整数のバイトオーダを、ネットワークバイトオーダからホ
   ストバイトオーダに変換します。ホストバイトオーダとネットワークバイ
   トオーダが一致するマシンでは、この関数は何もしません。それ以外の場
   合は4バイトのスワップを行います。

socket.ntohs(x)

   16ビットの正の整数のバイトオーダを、ネットワークバイトオーダからホ
   ストバイトオーダに変換します。ホストバイトオーダとネットワークバイ
   トオーダが一致するマシンでは、この関数は何もしません。それ以外の場
   合は2バイトのスワップを行います。

   バージョン 3.10 で変更: Raises "OverflowError" if *x* does not fit
   in a 16-bit unsigned integer.

socket.htonl(x)

   32ビットの正の整数のバイトオーダを、ホストバイトオーダからネットワ
   ークバイトオーダに変換します。ホストバイトオーダとネットワークバイ
   トオーダが一致するマシンでは、この関数は何もしません。それ以外の場
   合は4バイトのスワップを行います。

socket.htons(x)

   16ビットの正の整数のバイトオーダを、ホストバイトオーダからネットワ
   ークバイトオーダに変換します。ホストバイトオーダとネットワークバイ
   トオーダが一致するマシンでは、この関数は何もしません。それ以外の場
   合は2バイトのスワップを行います。

   バージョン 3.10 で変更: Raises "OverflowError" if *x* does not fit
   in a 16-bit unsigned integer.

socket.inet_aton(ip_string)

   ドット記法によるIPv4アドレス("'123.45.67.89'" など)を32ビットにパッ
   クしたバイナリ形式に変換し、長さ4のバイト列オブジェクトとして返しま
   す。この関数が返す値は、標準Cライブラリの "in_addr" 型を使用する関
   数に渡す事ができます。

   "inet_aton()" はドットが 3 個以下の文字列も受け取ります; 詳細につい
   ては Unix のマニュアル *inet(3)* を参照してください。

   IPv4アドレス文字列が不正であれば、 "OSError" が発生します。このチェ
   ックは、この関数で使用しているCの実装 "inet_aton()" で行われます。

   "inet_aton()" は、IPv6をサポートしません。IPv4/v6のデュアルスタック
   をサポートする場合は "inet_pton()" を使用します。

socket.inet_ntoa(packed_ip)

   32 ビットにパックされた IPv4 アドレス (長さ 4 バイトの *bytes-like
   object*) を、標準的なドット記法による 4 桁の文字列 ('123.45.67.89'
   など) に変換します。この関数は、"in_addr" 型、つまりこの関数が引数
   として受け取る 32 ビットにパックされたバイナリデータに対する C の型
   、を使用する標準 C ライブラリのプログラムとやりとりする場合に便利で
   す。

   この関数に渡すバイトシーケンスの長さが4バイト以外であれば、
   "OSError" が発生します。 "inet_ntoa()" は、IPv6をサポートしません。
   IPv4/v6のデュアルスタックをサポートする場合は "inet_ntop()" を使用
   します。

   バージョン 3.5 で変更: 書き込み可能な *bytes-like object* を使用で
   きるようになりました。

socket.inet_pton(address_family, ip_string)

   IPアドレスを、アドレスファミリ固有の文字列からパックしたバイナリ形
   式に変換します。 "inet_pton()" は、 "in_addr" 型 ("inet_aton()" と
   同様)や "in6_addr" を使用するライブラリやネットワークプロトコルを呼
   び出す際に使用することができます。

   現在サポートされている *address_family* は、 "AF_INET" と
   "AF_INET6" です。 *ip_string* に不正なIPアドレス文字列を指定すると
   、 "OSError" が発生します。有効な *ip_string* は、 *address_family*
   と "inet_pton()" の実装によって異なります。

   Availability: Unix, Windows.

   バージョン 3.4 で変更: Windowsで利用可能になりました

socket.inet_ntop(address_family, packed_ip)

   パックしたIPアドレス (数バイトからなる *bytes-like オブジェクト* )
   を、 "'7.10.0.5'" や "'5aef:2b::8'" などの標準的な、アドレスファミ
   リ固有の文字列形式に変換します。 "inet_ntop()" は ("inet_ntoa()" と
   同様に)、 "in_addr" 型や "in6_addr" 型のオブジェクトを返すライブラ
   リやネットワークプロトコル等で使用することができます。

   現在サポートされている *address_family* の値は、 "AF_INET" と
   "AF_INET6" です。バイトオブジェクトの *packed_ip* の長さが、指定し
   たアドレスファミリで適切な長さでない場合、 "ValueError" が発生しま
   す。 "inet_ntop()" の呼び出しでエラーが起こると、 "OSError" が発生
   します。

   Availability: Unix, Windows.

   バージョン 3.4 で変更: Windowsで利用可能になりました

   バージョン 3.5 で変更: 書き込み可能な *bytes-like object* を使用で
   きるようになりました。

socket.CMSG_LEN(length)

   指定された *length* にある制御メッセージ（CMSG）から、末尾のパディ
   ングを除いた全体の長さを返します。この値は多くの場合、 "recvmsg()"
   が制御メッセージの一連の要素を受信するためのバッファサイズとして使
   用できますが、バッファの末尾が要素である場合であってもパディングは
   含まれるので、バッファサイズを取得するには **RFC 3542** で求められ
   ているように、 "CMSG_SPACE()" を使用した移植可能なアプリケーション
   が必要です。通常 *length* は定数であり、許容範囲外の値が指定された
   場合は "OverflowError" 例外が送出されます。

   Availability: Unix, not WASI.

   Unix プラットフォーム。

   Added in version 3.3.

socket.CMSG_SPACE(length)

   指定された *length* の制御メッセージ（CMSG）の要素を "recvmsg()" が
   受信するために必要な、パディングを含めたバッファサイズを返します。
   複数の項目を受信するために必要なバッファスペースは、 "CMSG_SPACE()"
   が返すそれぞれの要素の長さの合計です。通常 *length* は定数であり、
   許容範囲外の値が指定された場合は "OverflowError" 例外が送出されます
   。

   一部のシステムではこの関数を提供せずに制御メッセージをサポートする
   可能性があることに注意してください。また、この関数の返り値を使用し
   て設定するバッファサイズは、受信する制御メッセージの量を正確に規定
   しないことがあり、その後に受信するデータがパディング領域に合う場合
   があることに注意してください。

   Availability: Unix, not WASI.

   most Unix platforms.

   Added in version 3.3.

socket.getdefaulttimeout()

   新規に生成されたソケットオブジェクトの、デフォルトのタイムアウト値
   を浮動小数点形式の秒数で返します。タイムアウトを使用しない場合には
   "None" を返します。最初に socket モジュールがインポートされた時の初
   期値は "None" です。

socket.setdefaulttimeout(timeout)

   Set the default timeout in seconds (float) for new socket objects.
   When the socket module is first imported, the default is "None".
   See "settimeout()" for possible values and their respective
   meanings.

socket.sethostname(name)

   マシンのホスト名を *name* に設定します。必要な権限がない場合は
   "OSError" を送出します。

   引数 "name" を指定して 監査イベント "socket.sethostname" を送出しま
   す。

   Availability: Unix, not Android.

   Added in version 3.3.

socket.if_nameindex()

   ネットワークインターフェース情報 (index int, name string)のタプルを
   返します。システムコールが失敗した場合、 "OSError" 例外を送出します
   。

   Availability: Unix, Windows, not WASI.

   Added in version 3.3.

   バージョン 3.8 で変更: Windows のサポートが追加されました。

   注釈:

     On Windows network interfaces have different names in different
     contexts (all names are examples):

     * UUID: "{FB605B73-AAC2-49A6-9A2F-25416AEA0573}"

     * name: "ethernet_32770"

     * friendly name: "vEthernet (nat)"

     * description: "Hyper-V Virtual Ethernet Adapter"

     This function returns names of the second form from the list,
     "ethernet_32770" in this example case.

socket.if_nametoindex(if_name)

   インターフェース名 *if_name* に対応するネットワークインターフェース
   のインデックス番号を返します。対応するインターフェースが存在しない
   場合は "OSError" 例外を送出します。

   Availability: Unix, Windows, not WASI.

   Added in version 3.3.

   バージョン 3.8 で変更: Windows のサポートが追加されました。

   参考: "Interface name" is a name as documented in "if_nameindex()".

socket.if_indextoname(if_index)

   インターフェースインデックス番号 *if_index* に対応するネットワーク
   インターフェース名を返します。対応するインターフェースが存在しない
   場合は "OSError" 例外を送出します。

   Availability: Unix, Windows, not WASI.

   Added in version 3.3.

   バージョン 3.8 で変更: Windows のサポートが追加されました。

   参考: "Interface name" is a name as documented in "if_nameindex()".

socket.send_fds(sock, buffers, fds[, flags[, address]])

   Send the list of file descriptors *fds* over an "AF_UNIX" socket
   *sock*. The *fds* parameter is a sequence of file descriptors.
   Consult "sendmsg()" for the documentation of these parameters.

   Availability: Unix, not WASI.

   Unix platforms supporting "sendmsg()" and "SCM_RIGHTS" mechanism.

   Added in version 3.9.

socket.recv_fds(sock, bufsize, maxfds[, flags])

   Receive up to *maxfds* file descriptors from an "AF_UNIX" socket
   *sock*. Return "(msg, list(fds), flags, addr)". Consult "recvmsg()"
   for the documentation of these parameters.

   Availability: Unix, not WASI.

   Unix platforms supporting "recvmsg()" and "SCM_RIGHTS" mechanism.

   Added in version 3.9.

   注釈:

     Any truncated integers at the end of the list of file
     descriptors.


socket オブジェクト
===================

class socket.socket(family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None)

   アドレスファミリー、ソケットタイプ、プロトコル番号を指定してソケッ
   トを作成します。アドレスファミリーには "AF_INET" (デフォルト値),
   "AF_INET6", "AF_UNIX", "AF_CAN", "AF_PACKET", "AF_RDS" を指定するこ
   とができます。ソケットタイプには "SOCK_STREAM" (デフォルト値),
   "SOCK_DGRAM", "SOCK_RAW" または他の "SOCK_" 定数の何れかを指定しま
   す。プロトコル番号は通常省略するか、または0を指定しますが、アドレス
   ファミリーに "AF_CAN" を指定した場合は、プロトコル番号には
   const:*CAN_RAW*, "CAN_BCM", "CAN_ISOTP", "CAN_J1939" のいずれかを指
   定すべきです。

   If *fileno* is specified, the values for *family*, *type*, and
   *proto* are auto-detected from the specified file descriptor.
   Auto-detection can be overruled by calling the function with
   explicit *family*, *type*, or *proto* arguments.  This only affects
   how Python represents e.g. the return value of
   "socket.getpeername()" but not the actual OS resource.  Unlike
   "socket.fromfd()", *fileno* will return the same socket and not a
   duplicate. This may help close a detached socket using
   "socket.close()".

   新たに作成されたソケットは 継承不可  です。

   引数 "self", "family", "type", "protocol" 付きで 監査イベント
   "socket.__new__" を送出します。

   バージョン 3.3 で変更: AF_CAN, AF_RDS ファミリーが追加されました。

   バージョン 3.4 で変更: CAN_BCMプロトコルが追加されました。

   バージョン 3.4 で変更: 返されるソケットは継承不可になりました。

   バージョン 3.7 で変更: CAN_ISOTP プロトコルが追加されました。

   バージョン 3.7 で変更: When "SOCK_NONBLOCK" or "SOCK_CLOEXEC" bit
   flags are applied to *type* they are cleared, and "socket.type"
   will not reflect them.  They are still passed to the underlying
   system "socket()" call.  Therefore,

      sock = socket.socket(
          socket.AF_INET,
          socket.SOCK_STREAM | socket.SOCK_NONBLOCK)

   will still create a non-blocking socket on OSes that support
   "SOCK_NONBLOCK", but "sock.type" will be set to
   "socket.SOCK_STREAM".

   バージョン 3.9 で変更: CAN_J1939 プロトコルが追加されました。

   バージョン 3.10 で変更: IPPROTO_MPTCP プロトコルが追加されました。

   ソケットオブジェクトは以下のメソッドを持ちます。 "makefile()" 以外
   のメソッドは、Unixのソケット用システムコールに対応しています。

   バージョン 3.2 で変更: *context manager* プロトコルのサポートが追加
   されました。コンテキストマネージャを終了することは、 "close()" を呼
   ぶことと同一です。

   accept()

      接続を受け付けます。ソケットはアドレスにbind済みで、listen中であ
      る必要があります。戻り値は "(conn, address)" のペアで、 *conn*
      は接続を通じてデータの送受信を行うための *新しい* ソケットオブジ
      ェクト、 *address* は接続先でソケットにbindしているアドレスを示
      します。

      新たに作成されたソケットは 継承不可  です。

      バージョン 3.4 で変更: ソケットが 継承不可 になりました。

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   bind(address)

      Bind the socket to *address*.  The socket must not already be
      bound. The format of *address* depends on the address family ---
      see ソケットファミリー.

      引数 "self", "address" を指定して 監査イベント "socket.bind" を
      送出します。

      Availability: not WASI.

   close()

      Mark the socket closed.  The underlying system resource (e.g. a
      file descriptor) is also closed when all file objects from
      "makefile()" are closed.  Once that happens, all future
      operations on the socket object will fail. The remote end will
      receive no more data (after queued data is flushed).

      ソケットはガベージコレクション時に自動的にクローズされます。しか
      し、明示的に "close()" するか、 "with" 文の中でソケットを使うこ
      とを推奨します。

      バージョン 3.6 で変更: "OSError" is now raised if an error
      occurs when the underlying "close()" call is made.

      注釈:

        "close()" releases the resource associated with a connection
        but does not necessarily close the connection immediately.  If
        you want to close the connection in a timely fashion, call
        "shutdown()" before "close()".

   connect(address)

      Connect to a remote socket at *address*. The format of *address*
      depends on the address family --- see ソケットファミリー.

      If the connection is interrupted by a signal, the method waits
      until the connection completes, or raises a "TimeoutError" on
      timeout, if the signal handler doesn't raise an exception and
      the socket is blocking or has a timeout. For non-blocking
      sockets, the method raises an "InterruptedError" exception if
      the connection is interrupted by a signal (or the exception
      raised by the signal handler).

      引数 "self", "address" を指定して 監査イベント "socket.connect"
      を送出します。

      バージョン 3.5 で変更: このメソッドは、接続が信号によって中断さ
      れ、信号ハンドラが例外を送出せず、ソケットがブロックであるかタイ
      ムアウトが設定されている場合、"InterruptedError" 例外を送出する
      代わりに、接続を完了するまで待機するようになりました (論拠につい
      ては **PEP 475**  を参照してください)。

      Availability: not WASI.

   connect_ex(address)

      Like "connect(address)", but return an error indicator instead
      of raising an exception for errors returned by the C-level
      "connect()" call (other problems, such as "host not found," can
      still raise exceptions).  The error indicator is "0" if the
      operation succeeded, otherwise the value of the "errno"
      variable.  This is useful to support, for example, asynchronous
      connects.

      引数 "self", "address" を指定して 監査イベント "socket.connect"
      を送出します。

      Availability: not WASI.

   detach()

      実際にファイル記述子を閉じることなく、ソケットオブジェクトを閉じ
      た状態にします。ファイル記述子は返却され、他の目的に再利用するこ
      とができます。

      Added in version 3.2.

   dup()

      ソケットを複製します。

      新たに作成されたソケットは 継承不可  です。

      バージョン 3.4 で変更: ソケットが 継承不可 になりました。

      Availability: not WASI.

   fileno()

      ソケットのファイル記述子を短い整数型で返します。失敗時には、-1
      を返します。ファイル記述子は、 "select.select()" などで使用しま
      す。

      Windowsではこのメソッドで返された小整数をファイル記述子を扱う箇
      所 ("os.fdopen()" など) で利用できません。 Unix にはこの制限はあ
      りません。

   get_inheritable()

      ソケットのファイル記述子またはソケットのハンドルの 継承可能フラ
      グ を取得します。ソケットが子プロセスへ継承可能なら "True" 、継
      承不可なら "False" を返します。

      Added in version 3.4.

   getpeername()

      Return the remote address to which the socket is connected.
      This is useful to find out the port number of a remote IPv4/v6
      socket, for instance. The format of the address returned depends
      on the address family --- see ソケットファミリー. On some
      systems this function is not supported.

   getsockname()

      Return the socket's own address.  This is useful to find out the
      port number of an IPv4/v6 socket, for instance. The format of
      the address returned depends on the address family --- see ソケ
      ットファミリー.

   getsockopt(level, optname[, buflen])

      Return the value of the given socket option (see the Unix man
      page *getsockopt(2)*).  The needed symbolic constants (SO_*
      etc.) are defined in this module.  If *buflen* is absent, an
      integer option is assumed and its integer value is returned by
      the function.  If *buflen* is present, it specifies the maximum
      length of the buffer used to receive the option in, and this
      buffer is returned as a bytes object.  It is up to the caller to
      decode the contents of the buffer (see the optional built-in
      module "struct" for a way to decode C structures encoded as byte
      strings).

      Availability: not WASI.

   getblocking()

      Return "True" if socket is in blocking mode, "False" if in non-
      blocking.

      This is equivalent to checking "socket.gettimeout() != 0".

      Added in version 3.7.

   gettimeout()

      ソケットに指定されたタイムアウト値を取得します。タイムアウト値が
      設定されている場合には浮動小数点型で秒数が、設定されていなければ
      "None" が返ります。この値は、最後に呼び出された "setblocking()"
      または "settimeout()" によって設定されます。

   ioctl(control, option)

      "ioctl()" メソッドは WSAIoctl システムインターフェースへの制限さ
      れたインターフェースです。詳しい情報については、 Win32
      documentation を参照してください。

      他のプラットフォームでは一般的な "fcntl.fcntl()" と
      "fcntl.ioctl()" が使われるでしょう; これらの関数は第 1 引数とし
      てソケットオブジェクトを取ります。

      現在、以下のコントロールコードのみがサポートされています。
      "SIO_RCVALL", "SIO_KEEPALIVE_VALS", "SIO_LOOPBACK_FAST_PATH"。

      Availability: Windows

      バージョン 3.6 で変更: "SIO_LOOPBACK_FAST_PATH" が追加されました
      。

   listen([backlog])

      サーバーを有効にして、接続を受け付けるようにします。*backlog* が
      指定されている場合、少なくとも 0 以上でなければなりません (それ
      より低い場合、0 に設定されます)。システムが新しい接続を拒否する
      までに許可する未受付の接続の数を指定します。指定しない場合、デフ
      ォルトの妥当な値が選択されます。

      Availability: not WASI.

      バージョン 3.5 で変更: *backlog* 引数が任意になりました。

   makefile(mode='r', buffering=None, *, encoding=None, errors=None, newline=None)

      Return a *file object* associated with the socket.  The exact
      returned type depends on the arguments given to "makefile()".
      These arguments are interpreted the same way as by the built-in
      "open()" function, except the only supported *mode* values are
      "'r'" (default), "'w'", "'b'", or a combination of those.

      ソケットはブロッキングモードでなければなりません。タイムアウトを
      設定することはできますが、タイムアウトが発生すると、ファイルオブ
      ジェクトの内部バッファが矛盾した状態になることがあります。

      "makefile()" でファイルオブジェクトにソケットを関連づけた場合、
      ソケットを閉じるには、関連づけられたすべてのファイルオブジェクト
      を閉じたあとで、元のソケットの "socket.close()" を呼び出さなけれ
      ばなりません。

      注釈:

        Windows では "subprocess.Popen()" の stream 引数などファイルデ
        ィスクリプタつき file オブジェクトが期待されている場所では、
        "makefile()" によって作成される file-like オブジェクトは使用で
        きません。

   recv(bufsize[, flags])

      Receive data from the socket.  The return value is a bytes
      object representing the data received.  The maximum amount of
      data to be received at once is specified by *bufsize*. A
      returned empty bytes object indicates that the client has
      disconnected. See the Unix manual page *recv(2)* for the meaning
      of the optional argument *flags*; it defaults to zero.

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   recvfrom(bufsize[, flags])

      Receive data from the socket.  The return value is a pair
      "(bytes, address)" where *bytes* is a bytes object representing
      the data received and *address* is the address of the socket
      sending the data.  See the Unix manual page *recv(2)* for the
      meaning of the optional argument *flags*; it defaults to zero.
      The format of *address* depends on the address family --- see ソ
      ケットファミリー.

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

      バージョン 3.7 で変更: For multicast IPv6 address, first item of
      *address* does not contain "%scope_id" part anymore. In order to
      get full IPv6 address use "getnameinfo()".

   recvmsg(bufsize[, ancbufsize[, flags]])

      ソケットから通常のデータ (最大 *bufsize* バイト) と補助的なデー
      タを受信します。*ancbufsize* 引数により、補助的なデータの受信に
      使用される内部バッファのバイト数として、サイズが設定されます。こ
      のデフォルトは 0 で、補助的なデータを受信しないことを意味します
      。"CMSG_SPACE()" または "CMSG_LEN()" を使用して、補助的なデータ
      の適切なサイズを計算することができ、バッファ内に収まらないアイテ
      ムは、短縮されるか破棄されます。*flags* 引数はデフォルトでは 0
      で、"recv()" での意味と同じ意味を持ちます。

      戻り値は 4 要素のタプル "(data, ancdata, msg_flags, address)" で
      す。*data* アイテムは、受信した非付属的データを保持する "bytes"
      オブジェクトです。*ancdata* アイテムは、ゼロ以上のタプル
      "(cmsg_level, cmsg_type, cmsg_data)" からなるリストで、受信する
      付属的なデータ (制御メッセージ) を表します。*cmsg_level* と
      *cmsg_type* はそれぞれ、プロトコルレベルとプロトコル固有のタイプ
      を指定する整数で、*cmsg_data* は関連するデータを保持する "bytes"
      オブジェクトです。*msg_flags* アイテムは、受信したメッセージの条
      件を示す様々なフラグのビット OR です。詳細は、システムのドキュメ
      ントを参照してください。受信ソケットが接続されていない場合、
      *address* は、送信ソケットが利用できる場合にはそのアドレスで、利
      用できない場合、その値は未指定になります。

      一部のシステムでは、"sendmsg()" と "recvmsg()" を使用して、プロ
      セス間で "AF_UNIX" ソケットを経由してファイル記述子を渡すことが
      できます。この機能を使用する場合 (しばしば "SOCK_STREAM" ソケッ
      トに限定されます)、"recvmsg()" は、付属的なデータ中に、
      "(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)" という形式のアイテ
      ムを返します。ここで、*fds* は、新しいファイル記述子をネイティブ
      C の int 型のバイナリ配列として表す "bytes" オブジェクトです。シ
      ステムコールが返った後 "recvmsg()" が例外を送出する場合、まずこ
      のメカニズムを経由して受信したファイル記述子を全て閉じようと試み
      ます。

      一部のシステムでは、部分的に受信した付属的なデータアイテムの短縮
      された長さが示されません。アイテムがバッファの末尾を超えているよ
      うである場合、"recvmsg()" は "RuntimeWarning" を送出し、関連する
      データの開始位置より前で途切れていない場合、バッファ内の付属的な
      データの一部を返します。

      On systems which support the "SCM_RIGHTS" mechanism, the
      following function will receive up to *maxfds* file descriptors,
      returning the message data and a list containing the descriptors
      (while ignoring unexpected conditions such as unrelated control
      messages being received).  See also "sendmsg()".

         import socket, array

         def recv_fds(sock, msglen, maxfds):
             fds = array.array("i")   # Array of ints
             msg, ancdata, flags, addr = sock.recvmsg(msglen, socket.CMSG_LEN(maxfds * fds.itemsize))
             for cmsg_level, cmsg_type, cmsg_data in ancdata:
                 if cmsg_level == socket.SOL_SOCKET and cmsg_type == socket.SCM_RIGHTS:
                     # Append data, ignoring any truncated integers at the end.
                     fds.frombytes(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % fds.itemsize)])
             return msg, list(fds)

      Availability: Unix.

      Unix プラットフォーム。

      Added in version 3.3.

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   recvmsg_into(buffers[, ancbufsize[, flags]])

      "recvmsg()" と同様に動作してソケットから通常のデータと付属的なデ
      ータを受信しますが、非付属的データは新しいバイトオブジェクトとし
      て返すのではなく、一連のバッファとして返します。*buffers* 引数は
      書き込み可能なバッファをエクスポートするオブジェクトのイテラブル
      でなければなりません (例: "bytearray" オブジェクト)。これらは、
      全てに書き込まれるか、残りバッファがなくなるまで、非付属的データ
      の連続チャンクで埋められます。オペレーティングシステムによって、
      使用できるバッファの数が制限 ("sysconf()" 値 "SC_IOV_MAX") され
      ている場合があります。*ancbufsize* 引数と *flags* 引数は、
      "recvmsg()" での意味と同じ意味を持ちます。

      戻り値は 4 要素のタプル "(nbytes, ancdata, msg_flags, address)"
      です。ここで、*nbytes* はバッファに書き込まれた非付属的データの
      総数で、*ancdata*、*msg_flags*、*address* は "recvmsg()" と同様
      です。

      以下はプログラム例です:

         >>> import socket
         >>> s1, s2 = socket.socketpair()
         >>> b1 = bytearray(b'----')
         >>> b2 = bytearray(b'0123456789')
         >>> b3 = bytearray(b'--------------')
         >>> s1.send(b'Mary had a little lamb')
         22
         >>> s2.recvmsg_into([b1, memoryview(b2)[2:9], b3])
         (22, [], 0, None)
         >>> [b1, b2, b3]
         [bytearray(b'Mary'), bytearray(b'01 had a 9'), bytearray(b'little lamb---')]

      Availability: Unix.

      Unix プラットフォーム。

      Added in version 3.3.

   recvfrom_into(buffer[, nbytes[, flags]])

      Receive data from the socket, writing it into *buffer* instead
      of creating a new bytestring.  The return value is a pair
      "(nbytes, address)" where *nbytes* is the number of bytes
      received and *address* is the address of the socket sending the
      data.  See the Unix manual page *recv(2)* for the meaning of the
      optional argument *flags*; it defaults to zero. The format of
      *address* depends on the address family --- see ソケットファミリ
      ー.

   recv_into(buffer[, nbytes[, flags]])

      *nbytes* バイトまでのデータをソケットから受信して、そのデータを
      新しいバイト文字列にするのではなく *buffer* に保存します。
      *nbytes* が指定されない(あるいは0が指定された)場合、 *buffer* の
      利用可能なサイズまで受信します。受信したバイト数を返り値として返
      します。オプション引数 *flags* (デフォルト:0) の意味については、
      Unix マニュアルページ *recv(2)* を参照してください。

   send(bytes[, flags])

      Send data to the socket.  The socket must be connected to a
      remote socket.  The optional *flags* argument has the same
      meaning as for "recv()". Returns the number of bytes sent.
      Applications are responsible for checking that all data has been
      sent; if only some of the data was transmitted, the application
      needs to attempt delivery of the remaining data. For further
      information on this topic, consult the ソケットプログラミング
      HOWTO.

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   sendall(bytes[, flags])

      Send data to the socket.  The socket must be connected to a
      remote socket.  The optional *flags* argument has the same
      meaning as for "recv()". Unlike "send()", this method continues
      to send data from *bytes* until either all data has been sent or
      an error occurs.  "None" is returned on success.  On error, an
      exception is raised, and there is no way to determine how much
      data, if any, was successfully sent.

      バージョン 3.5 で変更: ソケットのタイムアウトは、データが正常に
      送信される度にリセットされなくなりました。ソケットのタイムアウト
      は、すべてのデータを送る最大の合計時間となります。

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   sendto(bytes, address)
   sendto(bytes, flags, address)

      Send data to the socket.  The socket should not be connected to
      a remote socket, since the destination socket is specified by
      *address*.  The optional *flags* argument has the same meaning
      as for "recv()".  Return the number of bytes sent. The format of
      *address* depends on the address family --- see ソケットファミリ
      ー.

      引数 "self", "address" を指定して 監査イベント "socket.sendto"
      を送出します。

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   sendmsg(buffers[, ancdata[, flags[, address]]])

      非付属的なデータを一連のバッファから集め、単一のメッセージにまと
      めることで、通常のデータと付属的なデータをソケットに送信します。
      *buffers* 引数は、非付属的なデータを *bytes-like objects* (例:
      "bytes" オブジェクト) のイテラブルとして指定します。オペレーティ
      ングシステムによって、使用できるバッファの数が制限 ("sysconf()"
      値 "SC_IOV_MAX") されている場合があります。*ancdata* 引数は付属
      的なデータ (制御メッセージ) をゼロ以上のタプル "(cmsg_level,
      cmsg_type, cmsg_data)" のイテラブルとして指定します。ここで、
      *cmsg_level* と *cmsg_type* はそれぞれプロトコルレベルとプロトコ
      ル固有のタイプを指定する整数で、*cmsg_data* は関連データを保持す
      るバイトライクオブジェクトです。一部のシステム (特に
      "CMSG_SPACE()" を持たないシステム) では、一度の呼び出しで一つの
      制御メッセージの送信しかサポートされていない場合があります。
      *flags* 引数のデフォルトは 0 であり、"send()" での意味と同じ意味
      を持ちます。"None" 以外の *address* が渡された場合、メッセージの
      目的地のアドレスを設定します。戻り値は、送信された非付属的データ
      のバイト数です。

      The following function sends the list of file descriptors *fds*
      over an "AF_UNIX" socket, on systems which support the
      "SCM_RIGHTS" mechanism.  See also "recvmsg()".

         import socket, array

         def send_fds(sock, msg, fds):
             return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, array.array("i", fds))])

      Availability: Unix, not WASI.

      Unix プラットフォーム。

      引数 "self", "address" を指定して 監査イベント "socket.sendmsg"
      を送出します。

      Added in version 3.3.

      バージョン 3.5 で変更: システムコールが中断されシグナルハンドラ
      が例外を送出しなかった場合、このメソッドは "InterruptedError" 例
      外を送出する代わりにシステムコールを再試行するようになりました (
      論拠については **PEP 475** を参照してください)。

   sendmsg_afalg([msg, ]*, op[, iv[, assoclen[, flags]]])

      "sendmsg()" の "AF_ALG" ソケット用に特化したバージョンです。
      "AF_ALG" ソケットの、モード、IV、AEAD に関連づけられたデータ長、
      フラグを設定します。

      Availability: Linux >= 2.6.38.

      Added in version 3.6.

   sendfile(file, offset=0, count=None)

      高性能の "os.sendfile" を使用して、ファイルを EOF まで送信し、送
      信されたバイトの総数を返します。*file* は、バイナリモードで開か
      れた標準的なファイルオブジェクトです。"os.sendfile" が使用できな
      い場合 (例: Windows)、または *file* が標準的なファイルでない場合
      、代わりに "send()" が使用されます。*offset* は、ファイルの読み
      出し開始位置を指定します。*count* が指定されている場合、ファイル
      を EOF まで送信するのではなく、転送するバイトの総数を指定します
      。ファイルの位置は、返る時に更新されます。あるいは、エラー時には
      "file.tell()"  を使用して送信されたバイトの数を確認することがで
      きます。ソケットは "SOCK_STREAM" タイプでなければなりません。非
      ブロックソケットはサポートされていません。

      Added in version 3.5.

   set_inheritable(inheritable)

      ソケットのファイル記述子、またはソケットのハンドルの、 継承可能
      フラグ を立てます。

      Added in version 3.4.

   setblocking(flag)

      ソケットをブロッキングモード、または非ブロッキングモードに設定し
      ます。*flag* が False の場合にはソケットは非ブロッキングモードに
      なり、True の場合にはブロッキングモードになります。

      このメソッドは、次の "settimeout()" 呼び出しの省略表記です:

      * "sock.setblocking(True)" は "sock.settimeout(None)" と等価です

      * "sock.setblocking(False)" は "sock.settimeout(0.0)" と等価です

      バージョン 3.7 で変更: The method no longer applies
      "SOCK_NONBLOCK" flag on "socket.type".

   settimeout(value)

      Set a timeout on blocking socket operations.  The *value*
      argument can be a nonnegative real number expressing seconds, or
      "None". If a non-zero value is given, subsequent socket
      operations will raise a "timeout" exception if the timeout
      period *value* has elapsed before the operation has completed.
      If zero is given, the socket is put in non-blocking mode. If
      "None" is given, the socket is put in blocking mode.

      詳しくは ソケットタイムアウトの注意事項 を参照してください。

      バージョン 3.7 で変更: The method no longer toggles
      "SOCK_NONBLOCK" flag on "socket.type".

   setsockopt(level, optname, value: int | Buffer)
   setsockopt(level, optname, None, optlen: int)

      Set the value of the given socket option (see the Unix manual
      page *setsockopt(2)*).  The needed symbolic constants are
      defined in this module (*SO_* etc. <socket-unix-constants>*).
      The value can be an integer, "None" or a *bytes-like object*
      representing a buffer. In the latter case it is up to the caller
      to ensure that the bytestring contains the proper bits (see the
      optional built-in module "struct" for a way to encode C
      structures as bytestrings). When *value* is set to "None",
      *optlen* argument is required. It's equivalent to calling
      "setsockopt()" C function with "optval=NULL" and
      "optlen=optlen".

      バージョン 3.5 で変更: 書き込み可能な *bytes-like object* を使用
      できるようになりました。

      バージョン 3.6 で変更: setsockopt(level, optname, None, optlen:
      int) の形式が追加されました。

      Availability: not WASI.

   shutdown(how)

      接続の片方向、または両方向を切断します。 *how* が "SHUT_RD" の場
      合、以降は受信を行えません。 *how* が "SHUT_WR" の場合、以降は送
      信を行えません。 *how* が "SHUT_RDWR" の場合、以降は送受信を行え
      ません。

      Availability: not WASI.

   share(process_id)

      ソケットを複製し、対象のプロセスと共有するための bytes オブジェ
      クトを返します。対象のプロセスを *process_id* で指定しなければな
      りません。戻り値の bytes オブジェクトは、何らかのプロセス間通信
      を使って対象のプロセスに伝えます。対象のプロセス側では、
      "fromshare()" を使って複製されたソケットをとらえます。オペレーテ
      ィング・システムは対象のプロセスに対してソケットを複製するため、
      このメソッドを呼び出した後であれば、元のソケットをクローズしても
      、対象のプロセスに渡ったソケットには影響がありません。

      Availability: Windows.

      Added in version 3.3.

   Note that there are no methods "read()" or "write()"; use "recv()"
   and "send()" without *flags* argument instead.

   ソケットオブジェクトには以下の "socket" コンストラクタに渡された値
   に対応した (読み出し専用) 属性があります。

   family

      ソケットファミリー。

   type

      ソケットタイプ。

   proto

      ソケットプロトコル。

class socket.SocketType

   The base class of the "socket" type, re-exported from "_socket".
   An instance check such as "isinstance(socket(...), SocketType)" is
   true, but "SocketType" is not the same as "type(socket(...))",
   which is "socket" itself.


ソケットタイムアウトの注意事項
==============================

ソケットオブジェクトは、ブロッキングモード、非ブロッキングモード、タイ
ムアウトモードのうち、いずれか1つのモードをとります。デフォルトでは、
ソケットは常にブロッキングモードで作成されますが、
"setdefaulttimeout()" で標準のモードを変更することができます。

* *ブロッキングモード* での操作は、完了するか、または（接続がタイムア
  ウトするなどして）システムがエラーを返すまで、ブロックされます。

* *非ブロッキングモード* での操作は、ただちに完了できない場合、例外を
  送出して失敗します。この場合の例外の種類は、システムに依存するため、
  ここに記すことができません。 "select" モジュールの関数を使って、ソケ
  ットの読み書きが利用可能かどうか、可能な場合はいつ利用できるかを調べ
  ることができます。

* *タイムアウトモード* での操作は、指定されたタイムアウトの時間内に完
  了しなければ、 "timeout" 例外を送出します。タイムアウトの時間内にシ
  ステムがエラーを返した場合は、そのエラーを返します。

注釈:

  At the operating system level, sockets in *timeout mode* are
  internally set in non-blocking mode.  Also, the blocking and timeout
  modes are shared between file descriptors and socket objects that
  refer to the same network endpoint. This implementation detail can
  have visible consequences if e.g. you decide to use the "fileno()"
  of a socket.


タイムアウトと "connect" メソッド
---------------------------------

"connect()" もタイムアウト設定に従います。一般的に、 "settimeout()" を
"connect()" の前に呼ぶか、 "create_connection()" にタイムアウト引数を
渡すことが推奨されます。ただし、システムのネットワークスタックが
Python のソケットタイムアウトの設定を無視して、自身の接続タイムアウト
エラーを返すこともあります。


タイムアウトと "accept" メソッド
--------------------------------

"getdefaulttimeout()" が "None" でない場合、 "accept()" メソッドが返す
ソケットでは、そのタイムアウトが継承されます。 "None" である場合、待機
中のソケットの設定によって動作は異なります。

* 待機中のソケットが *ブロッキングモード* または *タイムアウトモード*
  である場合、"accept()" が返すソケットは、*ブロッキングモード* になり
  ます。

* 待機中のソケットが *非ブロッキングモード* である場合、"accept()" が
  返すソケットは、オペレーティングシステムによってブロッキングモードま
  たは非ブロッキングモードになります。クロスプラットフォームの動作を確
  保したい場合、この設定を手動でオーバーライドすることをお勧めします。


使用例
======

Here are four minimal example programs using the TCP/IP protocol: a
server that echoes all data that it receives back (servicing only one
client), and a client using it.  Note that a server must perform the
sequence "socket()", "bind()", "listen()", "accept()" (possibly
repeating the "accept()" to service more than one client), while a
client only needs the sequence "socket()", "connect()".  Also note
that the server does not "sendall()"/"recv()" on the socket it is
listening on but on the new socket returned by "accept()".

次のクライアントとサーバは、IPv4 のみをサポートしています。

   # Echo server program
   import socket

   HOST = ''                 # Symbolic name meaning all available interfaces
   PORT = 50007              # Arbitrary non-privileged port
   with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
       s.bind((HOST, PORT))
       s.listen(1)
       conn, addr = s.accept()
       with conn:
           print('Connected by', addr)
           while True:
               data = conn.recv(1024)
               if not data: break
               conn.sendall(data)

   # Echo client program
   import socket

   HOST = 'daring.cwi.nl'    # The remote host
   PORT = 50007              # The same port as used by the server
   with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
       s.connect((HOST, PORT))
       s.sendall(b'Hello, world')
       data = s.recv(1024)
   print('Received', repr(data))

The next two examples are identical to the above two, but support both
IPv4 and IPv6. The server side will listen to the first address family
available (it should listen to both instead). On most of IPv6-ready
systems, IPv6 will take precedence and the server may not accept IPv4
traffic. The client side will try to connect to all the addresses
returned as a result of the name resolution, and sends traffic to the
first one connected successfully.

   # 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 OSError as msg:
           s = None
           continue
       try:
           s.bind(sa)
           s.listen(1)
       except OSError as msg:
           s.close()
           s = None
           continue
       break
   if s is None:
       print('could not open socket')
       sys.exit(1)
   conn, addr = s.accept()
   with conn:
       print('Connected by', addr)
       while True:
           data = conn.recv(1024)
           if not data: break
           conn.send(data)

   # 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 OSError as msg:
           s = None
           continue
       try:
           s.connect(sa)
       except OSError as msg:
           s.close()
           s = None
           continue
       break
   if s is None:
       print('could not open socket')
       sys.exit(1)
   with s:
       s.sendall(b'Hello, world')
       data = s.recv(1024)
   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 packets
   s.ioctl(socket.SIO_RCVALL, socket.RCVALL_ON)

   # receive a packet
   print(s.recvfrom(65565))

   # disabled promiscuous mode
   s.ioctl(socket.SIO_RCVALL, socket.RCVALL_OFF)

次の例では、ソケットインターフェースを使用してローソケットプロトコルを
使用する CAN ネットワークと通信する方法を説明します。ブロードキャスト
マネージャプロトコロルで CAN を使用するには、以下でソケットを開きます
。

   socket.socket(socket.AF_CAN, socket.SOCK_DGRAM, socket.CAN_BCM)

ソケットの束縛 ("CAN_RAW") または ("CAN_BCM") 接続を行ったあと、ソケッ
トオブジェクトで "socket.send()" と "socket.recv()" 操作 (とそのカウン
ターパート) を通常通りに使用することができます。

最後の例では、特権が必要になるかもしれません:

   import socket
   import struct


   # CAN frame packing/unpacking (see 'struct can_frame' in <linux/can.h>)

   can_frame_fmt = "=IB3x8s"
   can_frame_size = struct.calcsize(can_frame_fmt)

   def build_can_frame(can_id, data):
       can_dlc = len(data)
       data = data.ljust(8, b'\x00')
       return struct.pack(can_frame_fmt, can_id, can_dlc, data)

   def dissect_can_frame(frame):
       can_id, can_dlc, data = struct.unpack(can_frame_fmt, frame)
       return (can_id, can_dlc, data[:can_dlc])


   # create a raw socket and bind it to the 'vcan0' interface
   s = socket.socket(socket.AF_CAN, socket.SOCK_RAW, socket.CAN_RAW)
   s.bind(('vcan0',))

   while True:
       cf, addr = s.recvfrom(can_frame_size)

       print('Received: can_id=%x, can_dlc=%x, data=%s' % dissect_can_frame(cf))

       try:
           s.send(cf)
       except OSError:
           print('Error sending CAN frame')

       try:
           s.send(build_can_frame(0x01, b'\x01\x02\x03'))
       except OSError:
           print('Error sending CAN frame')

この例を、ほとんど間を空けずに複数回実行すると、以下のエラーが発生する
場合があります:

   OSError: [Errno 98] Address already in use

これは以前の実行がソケットを "TIME_WAIT" 状態のままにし、すぐには再利
用できないことで起こります。

There is a "socket" flag to set, in order to prevent this,
"socket.SO_REUSEADDR":

   s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
   s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
   s.bind((HOST, PORT))

"SO_REUSEADDR" フラグは、 "TIME_WAIT" 状態にあるローカルソケットをその
タイムアウト期限が自然に切れるのを待つことなく再利用することをカーネル
に伝えます。

参考:

  C 言語によるソケットプログラミングの基礎については、以下の資料を参照
  してください。

  * *An Introductory 4.3BSD Interprocess Communication Tutorial*, by
    Stuart Sechrest

  * *An Advanced 4.3BSD Interprocess Communication Tutorial*, by
    Samuel J.  Leffler et al,

  両書とも 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" を参照してください。
