插座系列

根据系统和构建选项，此模块支持各种套接字系列.

根据创建套接字对象时指定的地址系列，自动选择特定套接字对象所需的地址格式。套接字地址表示如下：

• 绑定到文件系统节点的AF_UNIX套接字的地址表示为字符串，使用文件系统编码和"surrogateescape"错误处理程序（见 PEP 383 ）。inLinux的抽象命名空间中的地址作为字节对象返回初始空字节;请注意，此命名空间中的套接字可以与普通文件系统套接字进行通信，因此在Linux上运行的程序可能需要处理这两种类型的地址。字符串类似orbytes的对象可以用作任何类型的地址，当它作为参数传递时.

  更改版本3.3：以前，AF_UNIX套接字路径被假定为使用UTF-8encoding.

  更改版本3.5：可写字节对象现在被接受了

• 一对(host, port)用于AF_INET地址族，其中host是一个字符串，表示互联网域名中的主机名，如"daring.cwi.nl"或IPv4地址，如"100.50.200.5"，port是一个整数.

  • 对于IPv4地址，接受两种特殊形式而不是主机地址：""表示INADDR_ANY，用于绑定到所有接口，字符串"<broadcast>"表示INADDR_BROADCAST。此行为与IPv6不兼容，因此，如果您打算使用yourPython程序支持IPv6，则可能需要避免这些.

• 对于AF_INET6地址家庭，一个四元组(host, port, flowinfo,scopeid)使用，flowinfo和scopeid代表sin6_flowinfo和sin6_scope_id成员在struct sockaddr_in6中C.对于socket模块方法，flowinfo和scopeid可以省略只是为了向后兼容性。但请注意，省略scopeid会导致操作范围内的IPv6地址时出现问题.

  更改版本3.7：对于组播地址（scopeid有意义）address可能不包含%scope（或zone id）部分。这些信息是多余的，可能安全省略（推荐）.

• AF_NETLINK套接字表示为对(pid, groups).

• 使用AF_TIPC地址家庭。TIPC是一种开放的，基于非IP的网络协议，设计用于集群计算机环境。地址由atuple表示，字段取决于地址类型。一般元组形式是(addr_type, v1, v2, v3 [, scope])，其中：

  • addr_type是其中之一 TIPC_ADDR_NAMESEQ, TIPC_ADDR_NAME，要么 TIPC_ADDR_ID.

  • scope是其中之一 TIPC_ZONE_SCOPE, TIPC_CLUSTER_SCOPE，和TIPC_NODE_SCOPE.

  • 如果addr_type是TIPC_ADDR_NAME， 然后 v1是服务器类型，v2是端口标识符，v3应该是0.

    如果addr_type是TIPC_ADDR_NAMESEQ，v1是服务器类型，v2是下端口号，v3是上端口号.

    如果addr_type是TIPC_ADDR_ID，然后v1是节点，v2是参考，v3应该设置为0.

• 元组(interface, )用于AF_CAN地址族，其中interface是一个表示网络接口名称的字符串，如"can0"。网络接口名称""可用于接收来自该系列所有网络接口的数据包.

  • CAN_ISOTP协议需要一个元组(interface, rx_addr, tx_addr)其中两个附加参数都是无符号长整数，代表aCAN标识符（标准的或扩展的）.

• 字符串或元组(id, unit)用于SYSPROTO_CONTROL家庭的PF_SYSTEM协议。该字符串是使用动态分配的ID的内核控件的名称。如果已知内核控件的ID和单元号，或者使用了已注册的ID，则可以使用元组.

  版本3.3.

• AF_BLUETOOTH中的新增支持以下协议和地址格式：

  • BTPROTO_L2CAP接受(bdaddr, psm)其中bdaddr是蓝牙地址作为字符串而psm是一个整数

  • BTPROTO_RFCOMM接受(bdaddr, channel)其中bdaddr是蓝牙地址作为字符串，channel是整数.

  • BTPROTO_HCI接受(device_id,)其中device_id是一个整数或带有接口蓝牙地址的字符串。（这取决于你的操作系统; NetBSD和DragonFlyBSD期望蓝牙地址，而其他一切都需要整数。）

    在版本3.2中更改：添加了NetBSD和DragonFlyBSD支持.

  • BTPROTO_SCO接受bdaddr其中bdaddr是一个bytes对象，包含astring格式的蓝牙地址。（例如b"12:23:34:45:56:67"）FreeBSD不支持此协议.

• AF_ALG是Kernelcryptography的基于Linux的套接字接口。算法套接字配置有两个到四元组的元组(type, name [, feat [, mask]])，其中：

  • type是算法类型为字符串，例如aead, hash,skcipher或rng.
  • name是算法名称和操作模式为字符串，例如sha256, hmac(sha256), cbc(aes)或drbg_nopr_ctr_aes256.
  • feat和mask是无符号的32位整数.

  可用性：Linux 2.6.38，某些算法类型需要更新的内核

  新版本3.6.

• AF_VSOCK允许虚拟机与其主机之间的通信。插座表示为(CID, port)tuplewhere上下文ID或CID和端口是整数.

  Availability：Linux＆gt; = 4.8 QEMU＆gt; = 2.8 ESX＆gt; = 4.0 ESX工作站＆gt; = 6.5.

  版本3.7.

• AF_PACKET中的新版本是一个直接连接到网络设备的低级接口。数据包由元组(ifname, proto[, pkttype[, hatype[, addr]]])表示：

  • ifname – 指定字符串的字符串设备名称.
  • proto – 指定以太网协议号的网络字节顺序整数.
  • pkttype – 指定数据包类型的可选整数：
    • PACKET_HOST（默认值） – 数据包寻址到本地主机.
    • PACKET_BROADCAST – 物理层广播包.
    • PACKET_MULTIHOST – 数据包发送到物理层组播地址.
    • PACKET_OTHERHOST – 包到其他主机已被在混杂模式下被设备驱动程序捕获.
    • PACKET_OUTGOING – 来自本地主机的数据包，它返回到数据包套接字.
  • hatype – 指定ARP硬件地址类型的可选整数.
  • addr – 指定硬件physicaladdress的可选字节对象，其解释取决于设备.

如果在host作为IPv4 / v6套接字地址的一部分，该程序可能显示不确定行为，因为Python使用从DNS解析返回的第一个地址。根据DNS分辨率和/或主机配置的结果，套接字地址将被分解为实际的IPv4 / v6地址。对于确定性行为，请在host一部分。

所有错误都会引发异常可以引发无效参数类型和内存不足情况的正常异常;从Python 3.3开始，与socket或地址语义相关的错误引发OSError或其中一个子类（他们用来提高socket.error).

通过setblocking()支持非阻塞模式。通过settimeout().

模块内容

模块socket出口以下元素.

套接字对象

套接字对象具有以下方法。除了makefile()之外，这些对应于适用于套接字的Unix系统调用.

socket.accept（）

接受连接。套接字必须绑定到一个地址并监听连接。返回值是一对(conn, address)其中conn是new套接字对象，可用于在连接上发送和接收数据，而address是地址绑定到连接另一端的socket .

新创建的socket是不可继承的.

在版本3.4中更改： socket现在是不可继续的

更改版本3.5：如果系统调用中断并且信号处理程序没有引发异常，则该方法现在重试系统调用而不是raisean InterruptedError异常（见 PEP 475 的理由）.

socket.bind（address）

将插座绑定到address。套接字必须尚未绑定。（address的格式取决于地址族 – 见上文。）

socket.close（）

标记插座已关闭。当makefile()已关闭。一旦发生这种情况，socketobject上的所有未来操作都将失败。远程端将不再接收数据（已刷新已排队的数据）.

套接字在被垃圾收集时自动关闭，但建议明确地close()它们，或者在它们周围使用with语句.

在版本3.6中更改：OSError如果在进行基础close()调用时发生错误，则会提高.

注意

close()释放与连接关联的资源但不一定立即关闭连接。如果要及时关闭连接，请在shutdown()（close().

socket.connect）address之前调用

在address连接到远程插座。（address取决于地址族 – 见上文。）

如果连接被信号中断，该方法等待连接完成，或者在超时时提高socket.timeout，如果信号处理程序没有提高一个例外，套接字阻塞或有超时。对于非阻塞套接字，如果连接被信号中断（或信号处理程序引发的异常），该方法会引发InterruptedError异常.

在版本3.5中更改：该方法现在等待直到连接完成而不是引发InterruptedError异常，如果连接被asignal中断，信号处理程序不会引发异常并且套接字正在阻塞或超时（请参阅 PEP 475 的理由）.

socket.connect_ex（address）

喜欢connect(address)，但是回复错误指示器而不是为C级connect()调用返回的错误引发异常（其他问题，例如“找不到主机”，仍然可以引发异常）。错误指示符是0如果操作成功，否则errno变量的值。这对于支持异步连接很有用.

socket.detach（)

将套接字对象置于关闭状态而不实际关闭下面的文件描述符。返回文件描述符，可以重复用于其他目的.

新版本3.2.

socket.dup ()

重复插座

新创建的套接字不可继承.

在版本3.4中更改：套接字现在是不可继承的.

socket.fileno（）

返回套接字的文件描述符（一个小整数），或者失败时返回-1。这对于select.select().

非常有用。在Windows下，此方法返回的小整数不能用于可以使用文件描述符的地方（例如os.fdopen()）。Unix没有这个限制.

socket.get_inheritable()

获取socket的文件描述符或套接字句柄的继承标志：True如果套接字可以继承英寸进程，False如果不能.

新版本3.4.

socket.getpeername（）

返回套接字所连接的远程地址。例如，这对于远程IPv4 / v6套接字的端口号很有用。（返回的地址格式取决于地址族 – 见上文。）在某些系统上不支持此功能.

socket.getsockname ()

返回套接字自己的地址。例如，这对于找出IPv4 / v6套接字的端口号很有用。（返回的地址格式取决于地址族 – 见上文。）

socket.getsockopt（level, optname [, buflen] ）

返回给定套接字选项的值（参见Unix手册页getsockopt(2)）。所需的符号常量（SO_*等）在此模块中定义。如果buflen不存在，则假定为整数选项，并且函数返回其整数值。如果buflen存在，它指定用于接收选项的缓冲区的最大长度，并且此缓冲区作为字节对象返回。由调用者来解码缓冲区的内容（参见可选的内置模块struct解码编码为字节串的C结构的方法）.

socket.getblocking（）

返回True如果socket处于阻塞模式，False如果在非阻塞中

这相当于检查socket.gettimeout() == 0.

版本3.7.

socket.gettimeout()

返回与套接字操作相关的超时秒数（浮点数），如果没有设置超时则返回None。这反映了对setblocking()或settimeout().

socket.ioctl（control, option）

平台：	Windows

ioctl()方法是WSAIoctl系统接口的有限接口。有关更多信息，请参阅Win32文档.

在其他平台上，可以使用通用的fcntl.fcntl()和fcntl.ioctl()函数;他们接受一个套接字对象作为他们的第一个参数.

目前只支持以下控制代码：SIO_RCVALL, SIO_KEEPALIVE_VALS和SIO_LOOPBACK_FAST_PATH.

更改版本3.6：SIO_LOOPBACK_FAST_PATH添加了

socket.listen ( [backlog])

启用a服务器接受连接。如果指定backlog，则必须至少为0（如果为低，则设置为0）;它指定在拒绝新连接之前系统将允许的未接受连接数。如果没有指定，则选择默认的合理值.

更改版本3.5： backlog参数现在是可选的.

socket.makefile（mode=”r”, buffering=None, *, encoding=None, errors=None, newline=None）

返回与socket关联的文件对象。确切的返回类型取决于给makefile()的参数。这些参数的解释方式与内置的open()函数相同，除了唯一支持的mode值是"r"（默认值），"w"和"b".

套接字必须处于阻塞模式;它可以有超时，但是如果timeoutoccurs.

关闭makefile()除非所有其他文件对象都已关闭并且socket.close()已被调用套接字对象.

注意

在Windows上，由makefile()不能在具有文件描述符的文件对象的位置使用，例如subprocess.Popen().

socket.recv（bufsize[, flags] ）

从套接字接收数据。返回值是表示接收到的数据的字节对象。一次接收的最大数据量由bufsize指定。参见Unix手册页面recv(2)对于可选参数的含义flags;它默认为零.

注意

为了最好地匹配硬件和网络现实，bufsize应该是一个相对较小的2的幂，例如4096.

在版本3.5：如果系统调用中断并且信号处理程序没有引发异常，则该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 理由）.

socket.recvfrom（bufsize[, flags] ）

从套接字接收数据。返回值是一对(bytes, address)其中bytes是表示接收数据的字节对象，address是发送数据的套接字的地址。有关可选参数recv(2)的含义，请参见Unix手册页面flags;它默认为零。（address的格式取决于地址族 – 见上文。）

在版本3.5中更改：如果系统调用中断且信号处理程序没有提升例外，该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 的理由）.

在版本3.7中更改：对于组播IPv6地址，address的第一项不再包含%scope part。为了获得完整的IPv6地址使用getnameinfo().

socket.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是一个bytes对象，表示新的文件描述符是一个二进制数组的句子C int类型。如果recvmsg()在系统调用返回后引发异常，它将首先尝试关闭通过此机制接收的任何文件描述符.

某些系统不指示仅部分接收的辅助数据项的截断长度。如果某个项目超出缓冲区的末尾，recvmsg()将发出RuntimeWarning，并且将返回它在缓冲区内的部分，前提是它在其相关数据的开始之前没有被截断.

在支持SCM_RIGHTS机制，以下函数将接收最多maxfds文件描述符，返回消息数据和包含描述符的列表（同时忽略意外情况，例如收到无关控制消息）。另请参见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.fromstring(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % fds.itemsize)])
    return msg, list(fds)

可用性：大多数Unix平台，可能是其他平台.

3.3版本中的新版本

改进版本3.5：如果系统调用中断并且信号处理程序没有引发异常，则该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 理由）.

socket.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---')]

可用性：大多数Unix平台，可能是其他人.

新版本3.3.

socket.recvfrom_into (buffer [, nbytes [, flags] ] ）

从套接字接收数据，将其写入buffer，而不是创建一个新的字节串。返回值是一对(nbytes, address)其中nbytes是接收的字节数，address是发送数据的套接字的地址。有关theoptional参数recv(2)的含义，请参见Unix手册页面flags;它默认为零。（address取决于地址族 – 见上文。）

socket.recv_into（buffer [, nbytes [, flags] ] ）

从套接字接收最多nbytes字节，将数据存储到缓冲区而不是创建新的字节串。如果未指定nbytes（或0），则接收到给定缓冲区中可用的大小。返回收到的字节数。有关可选参数recv(2)的含义，请参见Unix手册页面flags;它默认为零.

socket.send(bytes [, flags])

将数据发送到插座。套接字必须连接到远程套接字。可选的flags参数与上面recv()的含义相同。返回发送的字节数。应用程序负责检查是否已发送所有数据;如果仅传输了一些数据，则应用程序需要尝试传递剩余数据。有关此主题的更多信息，请参阅 Socket Programming HOWTO .

在版本3.5中更改：如果系统调用中断并且信号处理程序没有引发异常，则该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 理由）.

socket.sendall（bytes [, flags] ）

将数据发送到插座。套接字必须连接到远程套接字。可选的flags参数与上面的recv()具有相同的含义。与send()不同，此方法继续从bytes发送数据，所有数据都已发送或发生错误。None在成功时返回。出错时，会引发异常，并且无法确定多少数据（如果有的话）已成功发送.

在版本3.5中更改：套接字超时不再重置时间数据发送成功。套接字超时现在是发送所有数据的最大总持续时间.

更改版本3.5：如果系统调用中断并且信号处理程序没有引发异常，则该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 理由）.

socket.sendto（bytes, address）

socket.sendto（bytes, flags, address）

将数据发送到插座。套接字不应连接到远程套接字，因为目标套接字由address指定。可选的flags参数与上面recv()的含义相同。返回发送的字节数。（address的格式取决于地址族 – 见上文。）

在版本3.5中更改：如果系统调用中断且信号处理程序没有引发异常，该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 的理由）.

socket.sendmsg（buffers [, ancdata [, flags [, address] ] ] ）

将正常和辅助数据发送到套接字，从一系列缓冲区收集辅助数据并将其连接到单个消息中。buffers参数将thenon-ancillary数据指定为字节对象（例如bytes对象）的可迭代数据;操作系统可以设置可以使用的缓冲区数量的限制（sysconf()值SC_IOV_MAX）。ancdata参数指定ancillarydata（控制消息）为零或多个元组(cmsg_level, cmsg_type, cmsg_data)的可迭代，其中cmsg_level和cmsg_type是指定协议级别的整数和协议特定类型，和cmsg_data是类似于abytes的对象，保存相关数据。请注意，某些系统（特别是没有CMSG_SPACE()的系统）可能支持每次调用只发送一条控制消息。flags参数默认为0，其含义与send()相同。如果address被提供而不是None，它会为消息设置adestination地址。返回值是发送的非辅助数据的字节数.

以下函数在fds套接字上发送文件描述符列表AF_UNIX，在支持SCM_RIGHTS机制。也可以看看 recvmsg().

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

可用性：大多数Unix平台，可能是其他版本.

3.3版本中的新版本.

版本3.5：如果系统调用中断，信号处理程序不会引发异常，该方法现在重试系统调用而不是提升InterruptedError异常（参见 PEP 475 的理由）.

socket.sendmsg_afalg（ [msg, ] *, op [, iv [, assoclen [, flags] ] ] ）

专业版sendmsg() AF_ALG socket.Set模式，IV，AEAD相关数据长度和AF_ALG socket

//Availability：Linux＆gt; = 2.6.38.

新版本3.6 .

socket.sendfile（file, offset=0, count=None）

使用高性能os.sendfile发送文件直到达到EOF并返回发送的总字节数.file必须是以二进制模式打开的常规文件对象。如果os.sendfile不可用（例如Windows）或file不是常规文件send()将被使用。offset告诉从哪里读取文件。如果指定，count是发送字节的总数，而不是发送文件，直到达到EOF。文件位置在返回时更新，或者在出现错误的情况下更新file.tell()可以用来计算发送的字节数。套接字必须是SOCK_STREAM类型。不支持非阻塞套件.

3.5版本中的新版本

socket.set_inheritable// (inheritable)

设置可继承的旗帜套接字的文件描述符或套接字的句柄.

版本3.4.

socket.setblocking（flag）

设置套接字的阻塞或非阻塞模式：if flag是假的，thesocket设置为非阻塞，否则设置为阻塞模式.

这个方法是肯定的简写settimeout()来电：

• sock.setblocking(True)相当于sock.settimeout(None)
• sock.setblocking(False)相当于sock.settimeout(0.0)

更改版本3.7：方法不再适用SOCK_NONBLOCK标志socket.type.

socket.settimeout（value）

设置阻塞套接字超时操作。value参数可以是表示秒的anonnegative浮点数，或None。如果给出非零值，则如果在操作完成之前已经过了超时时间timeout，则后续的套接字操作将引发value异常。如果给出零，则套接字处于无阻塞模式。如果给出None，则套接字处于阻塞模式.

有关详细信息，请参阅关于套接字超时的说明.

更改版本3.7：该方法不再切换SOCK_NONBLOCK标志socket.type.

socket.setsockopt（level, optname, value: int）

socket.setsockopt（level, optname, value: buffer）

socket.setsockopt（level, optname, None, optlen: int）

设置给定套接字选项的值（参见Unix手册页面setsockopt(2)）。所需的符号常量在socket模块（SO_*等）中定义。该值可以是整数，None或字节对象表示缓冲区。在后一种情况下，由调用者来确保bytestring包含了适当的位（有关将C结构编码为字节串的方法，请参阅可选的内置模块struct）。当值设置为None，optlen参数是必需的。它相当于调用setsockopt Cfunction with optval = NULL和optlen = optlen .

在版本3.5中更改：可写字节对象是现在接受了

更改版本3.6： setsockopt（level，optname，None，optlen：int）表格已添加.

socket.shutdown (how)

关闭连接的一半或两半。如果how是SHUT_RD，则不允许进一步接收。如果how是SHUT_WR，则进一步发送不允许。如果how是SHUT_RDWR，则进一步发送和接收被拒绝.

socket.share (process_id)

复制一个插座并准备与之共享目标过程。目标进程必须提供process_id。然后可以使用某种形式的进程间通信将生成的字节对象传递给目标进程，并使用fromshare()在那里重新创建套接字。一旦调用了此方法，关闭套接字是安全的，因为操作系统已经复制它为目标进程.

Availability：Windows.

新版本3.3.

注意没有方法read()或write();使用recv()和send()没有flags相反的参数.

套接字对象也有这些（只读）属性，这些属性对应于赋予socket构造函数的值.

socket.family

套接字族.

socket.type

插座类型.

socket.proto

套接字协议

注意套接字超时

套接字对象可以是以下三种模式之一：阻塞，非阻塞，ortimeout。默认情况下套接字总是在阻塞模式下创建，但可以通过调用setdefaulttimeout().

• 在blocking mode，操作阻塞直到完成或系统返回错误（如连接超时）.
• 在non-blocking mode如果无法立即完成操作失败（错误与系统无关）：来自的功能select可用于了解套接字何时以及是否可用于读取或写入.
• 在timeout mode中，如果无法在为套接字指定的时间内完成操作，则操作失败（它们会引发timeout异常）或系统是否返回错误.

示例

以下是使用TCP / IP协议的四个最小示例程序：服务器验证它收到的所有数据（仅为一个客户端提供服务），以及使用它的客户端。请注意，服务器必须执行序列socket(),bind(), listen(), accept()（可能重复accept()为多个客户端服务），而aclient只需要序列socket(), connect()。还要注意服务器没有sendall()/recv()在它正在侦听的套接字上，但在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))

接下来的两个示例与上面两个示例相同，但同时支持IPv4和IPv6。服务器端将侦听可用的第一个地址系列（它应该监听两者）。在大多数支持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 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上使用rawsockets编写一个非常简单的网络嗅探器。该示例需要管理员权限才能修改界面：

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)

下一个示例显示如何使用套接字接口使用原始套接字协议与CANnetwork进行通信。要使用CAN和broadcastmanager协议，请打开一个套接字：

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状态，并且不能立即重复使用.

有一个socket标志设置，为了防止这种情况，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_REUSEADDRflag告诉内核重用TIME_WAIT状态，无需等待其自然超时到期.