zoukankan      html  css  js  c++  java
  • Python网络编程(2)——socket模块(2)

    目录:

      1. 异常

      2. 地址族

      3. 套接字类型

      4. 模块方法

      5. Socket对象与实例方法

      socket模块提供了Python中的低层网络连接接口,用于操作套接字操作。

    异常

      socket模块共定义了4种异常:

     socket.error 

      套接字相关的错误将会抛出该异常,伴随的值是解释错误信息的字符串或 (errno, string) 形式的系统调用异常返回。socket.error 是 IOError 的一个子类。

     socket.herror 

      地址相关的错误、C API 调用等可能会抛出该异常,例如使用 h_errno 的C API,比如 gethostbyname_ex() 和 gethostbyaddr() 。伴随的值是一个 (h_errno, string) 二元组,代表一个由库函数调用返回的错误, string 描述 h_errno ,由C的 hstrerror() 函数返回。

     socket.gaierror 

      地址相关的错误将会抛出该异常,例如 getaddrinfo() 和 getnameinfo() 函数。伴随的值是一个 (error, string)二元组,代表一个由库函数调用返回的错误,其中string描述error,由C的 gai_strerror() 函数返回。

     socket.timeout 

      套接字超时时抛出该异常。套接字的超时由 实例方法settimeout() 函数设置,目前该异常的伴随值总是字符串“timed out”。

    其他常量

     socket.has_ipv6 

      布尔型的常量,显示当前平台是否支持IPV6协议。

     例如:

    >>> sys.platform
    'win32'
    >>> socket.has_ipv6
    True

      

    模块方法

     socket.create_connection(addr[, timeout[, source_addr]]) 

      作用:连接到一个监听地址addr的TCP服务上,并返回一个新的套接字对象。这个函数比socket.connetc()更高级,如果addr(host, port)中的host是一个非数值的值,那么该函数会同时尝试AF_INET和AF_INET6来解析它,然后尝试所有获得的可能地址,该方法可以用来编写同时支持IPv4和IPv6的客户端。

      参数:

        addr —— 服务器套接字地址

        timeout —— 套接字的超时限制,如果没有提供,那么使用getdefaulttimeout()的设置

        source_address —— 如果提供的话,该参数必须是(host, port)形式的二元组,套接字会在连接前绑定到这个指定的地址。

      返回:

        返回一个连接到目标地址的新的套接字对象。

     socket.getaddrinfo(host, port[, family[, socktype[, proto[, flags]]]]) 

      至少需要两个参数,将一个host/port信息转化为一个五元组,该五元组包含了一切连到目标host/port上需要的套接字信息。返回的五元组具有如下的形式: (family, socktype, proto, canonname, sockaddr) 。

      将 host/port 参数转化为一个包含用于创建套接字的所有参数的5元组。host 代表域名,可以是 IPv4/v6 地址或者 None。port 可以是一个服务的字符串名称如'http',也可以是一个数字端口号或 None。传递 None 作为 host 和 port 的值等价于传递 NULL 给底层的 C API。

      参数 familysocktype 和 proto 是可选的,默认为0,意味着选取所有的结果。参数 flags 可以是 ‘AI_*’常量中的一个或几个,可以影响结果是如何被计算和返回的,默认值也是0。例如, AI_NUMERICHOST 会关闭域名查询,如果 host 是一个域名,那么这里将会抛出一个异常。

      该函数返回一个5元组,5元组的结构如下:

       (family, socktype, proto, canonname, sockaddr) 

      其中 family,socktype,proto 全是整数,用于传递给 socket() 函数。

      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 是一个描述套接字地址的元组,其格式依赖于返回结果中的 family (比如 family 是 AF_INET 时 sockaddr 是一个 (address, port) 二元组;而当 family 是  AF_INET6 时 sockaddr 是一个 (address, port, flow info, scope id) 四元组),该部分的结果可以传递给 socket.connect() 方法。

      下面的例子给出了一个获取HTTP连接到www.python.org的80端口的连接信息:

    >>> socket.getaddrinfo("www.python.org", 80, 0, 0, socket.IPPROTO_TCP)
    [(2, 1, 6, '', ('82.94.164.162', 80)),
     (10, 1, 6, '', ('2001:888:2000:d::a2', 80, 0, 0))]

     socket.getfqdn(name='') 

      作用:返回参数的全称域名(fully qualified domain name string),如果参数name='',那么将会返回本地主机的全称域名

      参数:字符串name,是要查询的目标主机名;

      返回值:返回目标主机的全称域名。

     socket.gethostbyname(hostname) 

      作用:将主机名翻译成IPv4地址,不支持IPv6的域名解析

      参数:

        hostname——目标主机的域名

      返回:目标主机的IPv4地址

     socket.gethostname() 

      作用:获取当前主机的主机名;

      参数:无

      返回:当前主机的主机名。

      

     socket.gethostbyaddr(ip_address) 

      作用:返回目标IP地址的一些信息;

      参数:ip_address——目标IP地址;

      返回值:三元组 (hostname, aliaslist, ipaddrlist) ,其中:

        hostname: 给定ip_address的主要主机名(primary host name);

        aliaslist: 给定ip_address的备用主机名(alternative host names)构成的列表,可能为空;

        ipaddrlist: 给定ip_address主机的IP地址列表,很可能只有一个IP地址。

     socket.gethostbyname_ex(hostname) 

      作用:效果等用于 gethostbyaddr() ,但是参数hostname既可以是IP地址,也可以是目标主机名;

      参数:hostname——点分式的IP地址或DNS主机名;

      返回值:返回值的形式等同于 gethostbyaddr() 。

     socket.getnameinfo(sockaddr, flags) 

      作用:将sockaddr转成(host, port)形式的二元组形式。

      参数:

        sockaddr —— 二元组,首元可以是IP地址,也可以是域名;次元是端口;

        flags —— 通常是0。

      返回:(host, port)形式的二元组,目标地址的IP地址和端口。

     socket.getprotobyname(protocolname) 

      作用:获得网络协议名(如:'icmp')对应的值,可以用来传递给 socket() 函数作为可选的第三个参数,通常只用于以“raw”(SOCK_RAW)方式打开的套接字。对于正常的套接字,一般协议值会自动选取。

      参数:

        protocolname —— 网络协议名,如“icmp”、“tcp”等

      返回:网络协议名对应的值。

     socket.getservbyname(servicename[, protocolname]) 

      作用:返回一个服务注册绑定的端口号,如FTP是21,SSH是22等。

      参数:

        servicename —— 要查询的服务的名称;

        protocolname —— 可选,取值'tcp' 或 'udp'。

      返回:

        目标服务注册监听的端口号。

     socket.getservbyport(port[, protocolname]) 

      作用:与 getservbyname() 刚好相反,可以通过指定端口号查询一般情况下是哪些服务注册监听这些端口。

      参数:

        port —— 目标端口号,

        protocolname —— 可选,取值'tcp' 或 'udp'。

      返回:

        通常监听目标端口的服务名称。

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

      作用:(只在Unix平台上可用)创建一对连接的套接字对象。

      参数:参数family, type, proto同 socket.socket() 方法。不过,如果平台定义了的话,默认的地址族是AF_UNIX,否则是AF_INET。

      返回:一个二元组,包含两个已经连接的套接字对象。

     socket.fromfd(fd, family, type[, proto]) 

      作用:(只在Unix平台上可用)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 above. 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.

     socket.ntohl(x) 

      作用:将32位网络字节序的正整型转换成主机字节序;

      参数:x——4字节网络字节序的正整型;

      返回:适合主机字节序的相同整数。

     socket.ntohs(x) 

      作用:将16位网络字节序的正整型转换成主机字节序;

      参数:x——2字节网络字节序的正整型;

      返回:适合主机字节序的相同整数。

     socket.htonl(x) 

      作用:将32位主机字节序的正整型转换成32位网络字节序的整型;

      参数:x——4字节正整数;

      返回:4字节网络字节序的相同整型变量。

     socket.htons(x) 

      作用:将16位的主机字节序的正整数转换成16位网络字节序整型;

      参数:x——2字节正整数;

      返回:2字节网络字节序的相同整型变量。

     socket.inet_aton(ip_string) 

      作用:将IPv4点分地址转换成32位二进制数(4字节长的字符串)的格式,不支持IPv6。

      参数:点分格式的IPv4地址

      返回:4字节打包后的字符串

     socket.inet_ntoa(packed_ip) 

      作用:将32位打包的IPv4地址转换成点分形式,不支持IPv6。

      参数:4字节打包后的IPv4地址

      返回:对应IP地址的点分形式

     socket.inet_pton(address_family, ip_string) 

      作用:将一个IP地址由它的地址族对应的字符串形式转换成打包后的二进制格式,支持IPv4和IPv6.

      参数:

        address_family——AF_INET 或 AF_INET6;

        ip_string——IP地址串

      返回:对应IP地址打包后的二进制形式。

     socket.inet_ntop(address_family, packed_ip) 

      作用:将一个IP地址由它的地址族对应的字符串形式转换成打包后的二进制格式,支持IPv4和IPv6。

      参数:

        address_family——AF_INET 或 AF_INET6;

        packed_ip——网络格式的,打包后的二进制形式的IP地址

      返回:IPv4或IPv6的普通字符串形式的IP地址。

     socket.getdefaulttimeout() 

      作用:返回默认的套接字超时时限(单位:秒)。

      参数:不用参数;

      返回值:

        浮点数——默认的套接字超时秒数;

        None——套接字没有默认的超时限制。

     socket.setdefaulttimeout(timeout) 

      作用:设置默认的套接字超时。

      参数:

      返回:

  • 相关阅读:
    jquery绑定点击事件动画BUG
    初步了解XSS攻击
    构造函数、原型对象、原型链之间的关系
    SQA计划和系统测试规程
    第四次scrum冲刺
    第二次Scrum冲刺
    前端面试题整理
    vue 2 简化版数据响应原理
    Vue3.0 简化版数据响应式原理
    git commit规范
  • 原文地址:https://www.cnblogs.com/Security-Darren/p/4751391.html
Copyright © 2011-2022 走看看