Socket创建函数
-
socket.socket(socket_family, socket_type, protocol=0)创建一个socket对象。socket_family是选择地址族（所以都是AF_开头），是不同的域（domain）。域决定者通信的特征，包括地址格式。参数socket_type是确定套接字的类型，进一步确定通信特征。protocol通常是0，表示为给定的域和套接字类型选择默认协议。当对同一域和套接字类型支持多个协议时，可以使用protocol选择一个特定的协议。在AF_INET通信域中，套接字类型SOCK_STREAM的默认协议时传输控制协议（Transmission Control Protocol， TCP）。在AF_INET通信域中，套接字类型SOCK_DGRAM的默认协议是UDP.
| socket_family（address family，地址族） | 意义 |
|---|---|
| socket.AF_UNIX | UNIX域（只能够用于单一的Unix系统进程间通信），地址由单独一个string表示 |
| socket.AF_INET | IPv4因特网域 (服务器之间网络通信)，地址由(host, port)表示 |
| socket.AF_INET6 | IPv6因特网域，地址由(host, port, flowinfo, scopeid)表示 |
| socket.AF_UNSPEC | 未指定协议 |
| socket_type | 意义 |
|---|---|
| socket.SOCK_STREAM | 有序的，可靠的，双向的，面向连接的字节流（默认TCP协议） |
| socket.SOCK_DGRAM | 固定长度的，无连接的，不可开的报文传递 |
| socket.SOCK_RAW | IP协议的数据报接口 |
| socket.SOCK_SEQPACKET | 固定长度的，有序的，可靠的，面向连接的报文传递 |
| protocol | 意义 |
|---|---|
| IPPROTO_IP | IPv4协议 |
| IPPROTO_IPV6 | IPv6协议 |
| IPPROTO_ICMP | 因特网控制报文协议（Internet Control Message Protocol） |
| IPPROTO_RAW | 原始IP数据包协议 |
| IPPROTO_TCP | 传输控制协议 |
| IPPROTO_UDP | 用户数据报协议 |
- 对于SOCK_DGRAM（数据报）接口，两个对等进程之间同你不需要逻辑连接。只需要向对等进程所使用的套接字送出一个报文。因此SOCK_DGRAM提供了一个无连接的服务。
- 对于SOCK_STREAM（字节流）接口，要求在交换数据之前，在本地套接字和通信的对等进程的套接字之间建立一个逻辑连接。由于SOCK_TREAM套接字提供字节流服务，所以应用程序分辨不出报文的界限。这意味者从SOCK_STREAM套接字读取数据时，它也许不会返回所有由发送进程所写的字节数。最终可以获得发送过来的所有数据，但也需要通过若干次函数调用才能得到。
- SOCK_SEQPACKET套接字和SOCK_STREAM套接字很类似，只是从套接字得到的是基于报文的服务而不是字节流的服务。这意味着从SOCK_SEQPACKET套接字接受的数据量与对方发送的一致。流控制传输协议（Stream Control Transmission Protocol， SCTP）提供了因特网上的顺序数据包服务。
- SOCK_RAW套接字提供一个数据报接口，用于直接访问下面的网络层（IP层）。使用这个接口的时候，应用程序负责构造自己的协议头部。PS：需要有超级管理员权限，防止恶意应用程序绕过内建安全机制来创建报文。
其他创建socket函数
-
socket.socketpair([family[, type[, proto]]])创建一对已经连接的socket对象（返回(socket, socket)），family，type，proto和上述socket()一样。部分平台默认的family是AF_UNIX，否则，默认是AF_INET。例如：AF_UNIX -
socket.fromfd(fd, family, type[, proto])复制文件描述符fd（文件描述符fd是一个整数且有一个文件对象的fileno()方法返回）且用此返回一个socket对象。family，type和proto和上述socket()一样。文件描述符fd应该是制定一个socket的，但函数并没有检测，如果这个文件描述符fd是无效的，随后的操作将会失败。这个方法很少会用到，但是能够用来在一个被当作标准输入输出的程序的socket中设置或获取配置（如：一个由Unix inet daemon启动的服务）。socket被假设为阻塞模式。（在Unix上有效）
其他函数
-
socket.getdefaulttimeout()返回下一个新的socket对象的超时时间，单位是秒（float）。如果返回是None表示新的socket对象没有超时。第一次导入socket包时，默认是None。 -
socket.setdefaulttimeout(timeout)设置默认超时时间给新的socket对象，单位是秒(float)。None表示新的socket对象没有超时。第一次导入socket包时，默认是None。
地址
字节序
字节序是一个处理器架构特性，用于指示像整数这样的大数据类型内部的字节如何排序。
大端(bing-endian)字节序，最大字节地址出现在最低有效字节(Least Significant Byte, LSB)上。
小端(little-endian)字节序，最低有效字节包含最小字节地址。
不管字节如何排序，最高有效字节(Most Signification Byte, MSB)总是在左边，LSB总是在右边。
对于TCP/IP协议栈使用大端字节序。
有下面四个函数来转换字节序：
-
socket.ntohl(x)：将32位正整数从网络字节序转换到主机字节序。在一些机器上的主机字节序和网络字节序是一样的，这将是一个空操作;否则，它执行一个4字节交换操作。 -
socket.ntohs(x)：将16位正整数从网络字节序转换到主机字节序。在一些机器上的主机字节序和网络字节序是一样的，这将是一个空操作;否则，它执行一个2字节交换操作。 -
socket.htonl(x)：将32位正整数从主机字节序转换到网络字节序。在一些机器上的主机字节序和网络字节序是一样的，这将是一个空操作;否则，它执行一个4字节交换操作。 -
socket.htons(x)：将16位正整数从主机字节序转换到网络字节序。在一些机器上的主机字节序和网络字节序是一样的，这将是一个空操作;否则，它执行一个2字节交换操作。
地址格式
-
socket.inet_aton(ip_string)将一个字符串的IPv4地址（e.g:“192.168.1.1”）转换为32位二进制格式的字符串（在和一些采用C标准库和需要struct in_addr的程序交流上很有用）。如果ip_string是一个无效的ip，这将引起一个socket.error。 -
socket.inet_ntoa(packed_ip)将一个32位二进制格式的字符串IPv4地址转换成一个常用的IPv4字符串。如果这不是一个表示4byte长度的字符串，将引起一个socket.error。 -
socket.inet_pton(address_family, ip_string)将一个对应family（AF_INET 或 AF_INET6）的字符串地址，转换成对应的二进制格式。（在*nix上） -
socket.inet_ntop(address_family, packed_ip)将一个二进制格式的IP地址，转换成对应地址族的字符串格式。（AF_INET 或 AF_INET6）
地址查询
-
socket.getaddrinfo(host, port[, family[, socktype[, proto[, flags]]]])根据给定的参数host/port，相应的转换成一个包含用于创建socket对象的五元组的list。-
host可以是一个域名（e.g:"www.google.com"），可以是一个IPv4或者IPv6地址的字符串，或则是None。 -
port可以是一个协议名（e.g:"http"），可以是一个代表端口的数字，或者是None。 -
family，socketype，proto，flags都是一些可选的参数，来筛选结果的。默认情况下，它们的值都是0，表示所有。flags可以是 1 个或者多个AI_*常量，这会影响结果是如何计算和返回的。默认值是0。
返回list的5元组结构：
(family, socktype, proto, canonname, sockaddr),
family，socktpye，proto是一个整数。canonname是一个string，仅当AI_CANONNAME在参数flags中，否则返回 '' 。如果family是AF_INET，sockaddr是(address, port)；如果family是AF_INET6，sockaddr是(address, port, flow, info, scope id)； -
| flag标记 | 描述 |
|---|---|
| AI_ADDRCONFIG | 查询配置的地址类型(IPv4或IPv6) |
| AI_ALL | 查找 IPv4 和 IPv6 地址(仅用于AI_V4MAPPED) |
| AI_CANONAME | 需要一个规范的名字（与别名相对） |
| AI_NUMBERICHOST | 以数字格式指定主机地址，不翻译 |
| AI_NUMBERICSERV | 将服务指定为数字端口号，不翻译 |
| AI_PASSIVE | 套接字地址用于监听绑定 |
| AI_V4MAPPED | 如果没有找到IPv6地址，返回映射到IPv6格式的IPv4地址 |
-
socket.gethostname()返回当前正在执行Python解释器的主机名的字符串。（gethostname()返回的可能不是一个完全的qualified主机名，详见getfqdn()） -
socket.getfqdn([name])使用name来返回一个full qualified的主机名。如果name没有提供或者为空，则被解释为本地主机。为了找返回一个full qualified的主机名，由gethostbyaddr()返回的主机名将被选中，如果有的主机有别名的话，将会跟在后面。第一个返回的主机名是被选中的。如果没有full qualified主机名可用，将返回gethostbyaddr()的主机名。 -
socket.gethostbyname(hostname)将一个hostname转换为IPv4地址格式。如果hostname是一个IPv4地址，将会原封不动返回。gethostbyname()不接受IPv6。 -
socket.gethostbyname_ex(hostname)扩展接口。将一个hostname转换为IPv4地址格式。返回一个三元组(hostname, aliaslist, ipaddrlist)。hostname是反映着返回的ip_address。aliaslist是一组对应着同一个IP地址的主机别名（可能为空）。ipaddrlist是一组对应着同一个hostname的IPv4地址（一般情况是单一个地址）。gethostbyname_ex()只支持IPv4。 -
socket.gethostbyaddr(ip_address)``````hostname是反映着返回的ip_address。aliaslist是一组对应着同一个IP地址的主机别名（可能为空）。ipaddrlist是一组同一主机同一接口的IPv4/IPv6的地址列表。 -
socket.getnameinfo(sockaddr, flags)将给定的socketaddr(为一个host和port的二元组)翻译成一个二元组(host, port)。根据设置和flags，结果可以保存一个full qualified的主机名或者表现在主机上的数字地址。同样的，端口号可以为数字或者字符串。
| flags | 描述 |
|---|---|
| NI_DGRAM | 服务基于数据报而非基于流 |
| NI_NAMEREQD | 如果找不到主机名，将其作为一个错误对待 |
| NI_NOFQDN | 对于本地主机，仅返回全限定域名的字节点部分 |
| NI_NUMERICHOST | 返回主机地址的数字形式，而非主机名 |
| NI_NUMERICSCOPE | 对于IPv6，返回范围ID的数字形式，而非名字 |
| NI_NUMERICSERV | 返回服务地址的数字形式（即端口号），而非名字 |
-
socket.getprotobyname(protocolname)将一个网络协议名（例如“icmp”,"tcp"）转换成为一个固定的合适的值，给socket()的第三个参数（可选）。这个通常用在SOCK_RAW模式，对于其他普通的socket模型，将这个参数缺省或者设为0会自动的选择正确的协议。 -
socket.getservbyname(servicename[, protocolname])将一个网络服务名（e.g: "http"）和协议名转换成一个该服务的端口号。protocolname是可选项，应该是tcp或者udp，否则将匹配任何协议。 -
socket.getservbyport(port[, protocolname])将一个端口号和网络协议名转换成该端口号的服务名。protocolname是可选项，应该是tcp或者udp，否则将匹配任何协议。
Socket对象方法
socket.accept()接受一个连接。这个socket对象必须绑定了一个地址并正在监听着连接。返回的值是(conn, address)，conn是一个用来在接连上发送接收数据的新的socket对象，address是绑定在另外一个的socket连接的地址。socket.bind(address)将socket绑定到一个address。这个socket必须是未绑定地址的（address的格式如上文提到的，e.g:IPv4的格式(host, port)）。socket.close()关闭这个socket。接下来在这个socket对象的操作都将失败。另外一端将不在接收到数据（当队列中的数据都发送后）。当socket对象被垃圾回收机制回收时，将会自动关闭。socket.connect(address)用address连接到一个远程的socket（address的格式如上文提到的，e.g:IPv4的格式(host, port)）socket.connect_ex(address)类似于socket.connect(address)，但是返回一个错误提示来取代引起一个C语言层connect()的错误exception（其他问题，如果“host not found”，依然会引起exception）。如果返回的错误提示时0则操作成功，其他则是errno变量。这是一个有用的支持，比如，异步连接。socket.fileno()返回一个socket对象的文件描述符（一个整数）。在做多路复用socket（select,poll,epoll）下有用。在Window下，这个方法返回的整数不能当做文件描述符来使用（比如os.fdopen()）。Unix下没有这个限制。socket.getpeername()返回socket连接的远程address。这是有用的，例如找出远程的IPv4/v6 socket的端口号（返回的address格式依赖于地址族－如上述）。这个方法在某些平台上不支持。socket.getsockname()返回socket绑定的address。这是有用的，例如找IPv4/v6 socket的端口号（返回的address格式依赖于地址族－如上述）。socket.getsockopt(level, optname[, buflen])返回指定socket选项的值。optname所需要的 symbolic 常量（so_＊）都在本module中。如果buflen缺省，将会假定是一个整数的设置，并且这个函数是返回一个整数的。如果buflen设置了，它指定用于接收缓冲的最大长度。需要由调用者来对这个缓冲的内容进行解码。-
socket.setsockopt(level, optname, value)设置给定socket选项的值。optname所需要的 symbolic 常量（so_＊）都在本module中。value可以是一个整数（integer）或者表示缓冲（buffer）的字符串（string）。在后一种情况（指字符串的情况），它是由调用者来保证字符串包含着正确的位（bits）。参数
level标识了选项应用的协议。如果是通用的套接字层次选项，则level设置成SOL_SOCKET，否则level设置成控制这个选项的协议编号。对于TCP选项，level是IPPROTO_TCP。对于IP，level是IPPROTO_IP等等。
| 选项 | 参数value的类型 | 描述 |
|---|---|---|
| SO_ACCEPTCONN | integer | 返回信息指示该套接字是否能被监听（仅getsockopt()） |
| SO_BROADCAST | integer | 如果value非0，广播数据包 |
| SO_DEBUG | integer | 如果value非0，启动网络驱动调试功能 |
| SO_DONTROUTE | integer | 如果返回的value非0，绕过通常路由 |
| SO_ERROR | integer | 返回挂起的套接字错误并清除(仅getsockopt) |
| SO_KEEPALIVE | integer | 如果value非0，启动周期性keep－alive报文 |
| SO_LINGER | stirng | 当还有未发送报文二套接字已关闭时，延迟时间 |
| SO_OOBINLINE | integer | 当value非0，将带外数据放在普通数据中 |
| SO_RCVBUF | integer | 接受缓冲区的字节长度 |
| SO_RCVLOWAT | integer | 接收调用中返回的最小数据字节数 |
| SO_RCVTIMEO | string | 套接字接收调用的超时值 |
| SO_REUSEADDR | integer | 如果value非0，重用bind中的地址 |
| SO_SNDBUF | integer | 发送缓冲区的字节长度 |
| SO_SNDLOWAT | integer | 发送调用中传送的最小数据字节数 |
| SO_SNDTIMEO | string | 套接字发送调用的超时值 |
| SO_TYPE | integer | 表示套接字类型（仅getsockopt） |
socket.listen(backlog)监听Socket进行的连接。backlog指定连接队列的最大值，至少为0。最大值取决于系统（通常为5）。最小值被强制为0。socket.makefile([mode[, bufsize]])返回与socket相关联的文件对象。这个文件对象只有调用close()方法才会被关闭，但这个关闭只是删除与socket的关联，所以只有在这个socket没有在其他地方被引用时，socket才会关闭。
这个socket必须在阻塞模式（不能有超时）。可选参数mode和bufsize和大开文件的方法file()，open一样。socket.recv(bufsize[, flags])接收来自socket的数据。接收的数据以string类型表示。一次接收数据的最大数量由bufsize决定。flags的默认值为0，flags的标志如下表。
| 标志 | 描述（Linux下） |
|---|---|
| MSG_CMSG_CLOEXEC | 为UNIX域套接字上接收的文件描述符设置执行时关闭标志 |
| MSG_DONTWAIT | 启动非阻塞操作（相当于使用O_NONBLOCK） |
| MSG_ERRQUEUE | 接受错误信息作为辅助数据 |
| MSG_OOB | 如果协议支持，获取带外数据 |
| MSG_PEEK | 返回数据内容而不是真正取走数据 |
| MSG_TRUNC | 即使数据包被截断，也返回数据包的实际长度 |
| MSG_WAITALL | 等待直到所有数据可能（仅SOCK_STREAM） |
-
socket.recvfrom(bufsize[, flags])接收来自socket的数据。返回的值时一个二元组(string, address)，string表示的是接收的数据，address则是发送数据的socket的地址。参数的详解参见```socket.recv(bufsize[, flags])````。 -
socket.recvfrom_into(buffer[, nbytes[, flags]])接收来自socket的数据，将接收的数据写入到buffer中，而不是返回一个string。返回值的一个二元组(nbytes, address),nbytes是接收的的字节数，address则是发送数据的socket的地址。flags参数的详解参见```socket.recv(bufsize[, flags])````。 -
socket.send(string[, flags])发送数据到socket。这个socket对象必须已经与一个远程的socket对象连接。可选参数flags和函数recv()中的一样。这个函数会返回发送数据的字节数。应用程序需要自己负责检查是否所有数据已经被发送，如果只有一部分数据发送了，应用程序需要尝试将剩余的数据输送出去。 -
socket.sendall(string[, flags])发送数据到socket。这个socket对象必须已经与一个远程的socket对象连接。可选参数flags和函数recv()中的一样。和send()不同的是，这个方法将会一直发送数据直到所有数据都发送完或者有错误出现。如果成功则返回None。如果错误，将会引起一个异常(exception)，但这样将没有办法获知有多少数据是成功被发送的。 -
socket.sendto(string, address)和socket.sendto(string, flags, address)发送数据到socket，这个socket必须是没有与远程的socket连接的，目标socket由address来决定。可选参数falgs与recv()相同。函数返回的结果是发送数据的字节数。（address的格式由地址族决定，看上文） - ````socket.setblocking(flag)
将这个socket设置为**阻塞**或**非阻塞**：如果flag设为0，那个它是**非阻塞**，其他则为**阻塞**。所有的socket默认是**阻塞**的。在***非阻塞***模式下，如果调用recv()没有接收到数据，或者send()不能立刻的发送数据，一个error一个将会引起。在**阻塞**模式下，这些方法将会阻塞知道它们能够处理。socket.setblocking(0)的效果和socket.setblocking(0.0)一样。socket.setblocking(1)的效果和socket.setblocking(None)```一样。 -
socket.settimeout(value)为阻塞的socket设置一个超时时间。value可以是一个非负float表示的数字，单位是秒，也可以是None。如果给socket设定一个超时时间（float），一连串的阻塞方法的处理时间超过这个值，将会引起一个timeout异常。如果value是None，则会禁用超时。settimeout(0.0)效果和setblocking(0)一样。settimeout(None)的效果和setblocking(1)一样。 -
socket.gettimeout()返回设置的超时时间。返回的值和setblocking()，settimeout()相关。 -
socket.setsockopt(level, optname, value)用给定的参数设置socket的配置。所需的配置常量在socketmodule中（SO_*etc.）。value可以是一个整数或者一个字符串表示的buffer。如果是一个buffer，将有调用着来验证字符串是否包含正确的位（bits）。 -
socket.shutdown(how)完全关闭连接或者关闭一半。如果how是SHUT_RD，将不能接收数据。如果how是SHUT_WR，将不能发送数据。如果是SHUT_RDWD，发送和接收都不允许。
