Python Socket 编程

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，发送和接收都不容许。