o )nd|E@sddlZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZmZmZmZdZdZdZdadZdZd Zd Zd d Zd dZdedefddZdedefddZ dede!fddZ"dede!fddZ#edede$dededef d d!Z%edededed"ede&f d#d$Z'ed2de$d"ed(e$d)e$d*ededed+e$de&fd,d-Z(ed3de$d.ed/e&fd0d1Z)dS)4N)errors)ICMP_DEFAULT_CODEIcmpTypeIcmpTimeExceededCodeIcmpDestinationUnreachableCodez4.0.4Fz !BBHHHBBHIIz!BBHHHz!dcOs<dd}tsdStp |addd|D}t|dS)zPrint debug info to stdout if `ping3.DEBUG` is True. Args: *args: Any. Usually are strings or objects that can be converted to str. cSsltt}|tjtd}t}|tj||||| d t | d ||S)Nz[%(levelname)s] %(message)szPing3 Version: {}z LOGGER: {}) logging getLogger__name__setLevelDEBUG Formatter StreamHandler setFormatter addHandlerdebugformat __version__)logger formatter cout_handlerrL/var/www/html/api/v1/lib/venv/lib/python3.10/site-packages/ping3/__init__.py get_logger#s      z_debug..get_loggerN cs|]}t|VqdSNstr).0itemrrr 3z_debug..)r LOGGERjoinr)argskwargsrmessagerrr_debugs   r)cCs tr|dS)zRaise exception if `ping3.EXCEPTIONS` is True. Args: err: Exception. Raise: Exception: Exception passed in args will be raised if `ping3.EXCEPTIONS` is True. N) EXCEPTIONS)errrrr_raise7s r,funcreturncstfdd}|S)zDecorator that log function calls for debug Args: func: Function to be decorated. Returns: Decorated function. cs|ddd|D}|rt|nd}|r|rd||fn|p |}tddj|d|i|}tdd j|d |S) Nz, csrrr)r argrrrr"Or#z0_func_logger..wrapper..zFunction called:z{func.__name__}({})r-zFunction returned:z{func.__name__} -> {rtrn})r-rtrn)r%rr)r)r&r'pargskargsall_args func_returnr1rrwrapperMsz_func_logger..wrapper) functoolswraps)r-r7rr1r _func_loggerDs  r:sourcecCshd}d|>}t|dddt|ddd|d>}||kr+tt||}||ks |d|>d@S)zCalculates the checksum of the input bytes. RFC1071: https://tools.ietf.org/html/rfc1071 RFC792: https://tools.ietf.org/html/rfc792 Args: source: Bytes. The input to be calculated. Returns: int: Calculated checksum. rN)sumdivmod)r;BITScarryresultrrrchecksumZs ,rCrawcCsd}tt|tt|S)zGet information from raw ICMP header data. Args: raw: Bytes. Raw data of ICMP header. Returns: A map contains the infos from the raw header. )typecoderCidseq)dictzipstructunpackICMP_HEADER_FORMAT)rDicmp_header_keysrrrread_icmp_headerns rOcCsPdtdtfdd}d}tt|tt|}||d|d<||d|d<|S)zGet information from raw IP header data. Args: raw: Bytes. Raw data of IP header. Returns: A map contains the infos from the raw header. ipr.csdfdddDS)N.c3s |] }t|?d@VqdS)Nr)r offsetrPrrr"sz7read_ip_header..stringify_ip..)r<r)r%rTrrTr stringify_ipsz$read_ip_header..stringify_ip) versiontoslenrGflagsttlprotocolrCsrc_addr dest_addrr^r_)intrrIrJrKrLIP_HEADER_FORMAT)rDrWip_header_keys ip_headerrrrread_ip_header{s  rdsockr_icmp_idrHsizec Cstd|zt|}Wntjy"}ztj|d|d}~wwtd|d}tt t j t |||}|t td}ttt|} t|| } tt t j t t| ||}tdt|td| || } || |dfdS) aSends one ping to the given destination. ICMP Header (bits): type (8), code (8), checksum (16), id (16), sequence (16) ICMP Payload: time (double), data ICMP Wikipedia: https://en.wikipedia.org/wiki/Internet_Control_Message_Protocol Args: sock: Socket. dest_addr: The destination address, can be an IP address or a domain name. Ex. "192.168.1.1"/"example.com" icmp_id: ICMP packet id. Calculated from Process ID and Thread ID. seq: ICMP packet sequence, usually increases from 0 in the same process. size: The ICMP packet payload size in bytes. Note this is only for the payload part. Raises: HostUnkown: If destination address is a domain name and cannot resolved. zDestination address: '{}')r_NzDestination IP address:rQzSent ICMP header:zSent ICMP payload:)r)rsocket gethostbynamegaierrorr HostUnknownrKpackrMr ECHO_REQUESTrcalcsizeICMP_TIME_FORMATtimeencoderChtonsrOsendto) rer_rfrHrgr+pseudo_checksum icmp_headerpadding icmp_payload real_checksumpacketrrr send_one_pings$   r{timeoutcCstjdkptdkp|jtjk}|r(tdt t }t|j |j t t }n t dtdt t }t|}t dt|| |t}|dkrR|nd}t d|t|ggg|} | dgkrptj|dt} t d t| | |d \} } |r| |} t| }t d |nd }| || |j d }}t|}t d |t d||s|d}|dtjkr|dtjkrtj||dt|dtjkr|dtj krtj!||dtj"||d|dr?|dtj#krt dqE|d|kr t dqE|d|krt dqE|dtj$kr?t%t&|dt t&d}t dt||| |St d|qF)a}Receives the ping from the socket. IP Header (bits): version (8), type of service (8), length (16), id (16), flags (16), time to live (8), protocol (8), checksum (16), source ip (32), destination ip (32). ICMP Packet (bytes): IP Header (20), ICMP Header (8), ICMP Payload (*). Ping Wikipedia: https://en.wikipedia.org/wiki/Ping_(networking_utility) ToS (Type of Service) in IP header for ICMP is 0. Protocol in IP header for ICMP is 1. Args: sock: The same socket used for send the ping. icmp_id: ICMP packet id. Sent packet id should be identical with received packet id. seq: ICMP packet sequence. Sent packet sequence should be identical with received packet sequence. timeout: Timeout in seconds. Returns: The delay in seconds or None on timeout. Raises: TimeToLiveExpired: If the Time-To-Live in IP Header is not large enough for destination. TimeExceeded: If time exceeded but Time-To-Live does not expired. DestinationHostUnreachable: If the destination host is unreachable. DestinationUnreachable: If the destination is unreachable. posixDarwinrzUnprivileged on LinuxzTimeout time: {} ({})TzTimeout left: {:.2f}s)r|zReceived time: {} ({}))izReceived IP header:NzReceived ICMP header:zReceived ICMP payload:rrErF)rcrvrGz+ECHO_REQUEST received. Packet filtered out.z&ICMP ID dismatch. Packet filtered out.rHz'IMCP SEQ dismatch. Packet filtered out.zReceived sent time: {} ({})zUncatched ICMP packet:)'osnameplatformsystemrEriSOCK_RAWslicerKrorastoprMr)rqrctimeselectrTimeoutrecvfromrdrO getsocknamer TIME_EXCEEDEDr TTL_EXPIREDTimeToLiveExpired TimeExceededDESTINATION_UNREACHABLErDESTINATION_HOST_UNREACHABLEDestinationHostUnreachableDestinationUnreachablern ECHO_REPLYrLrp)rerfrHr| has_ip_headerip_header_sliceicmp_header_slice timeout_time timeout_leftselected time_recv recv_dataaddr ip_header_rawrcicmp_header_rawicmp_payload_rawrv time_sentrrrreceive_one_pingsj"          rs8unitr^r\ interfacec Csz ttjtjtj}Wn,ty8} z | jtjkr,td| ttjtj tj}n| WYd} ~ nd} ~ ww||rz| tj tj rQ| tj tj |Wntyk} z td| WYd} ~ nd} ~ wwz| tjtj r~| tjtj |Wnty} z td| WYd} ~ nd} ~ ww|r| tjt|td||r||dftd|ttdrtntj} t} td | | d @} zt||| ||d t|| ||d } WnEtj y } zt| t!| WYd} ~ WddSd} ~ wtj"y/} zt| t!| WYd} ~ Wdd Sd} ~ ww| dur> WddS|dkrG| d9} | WdS1sTwYdS)ag Send one ping to destination address with the given timeout. Args: dest_addr: The destination address, can be an IP address or a domain name. Ex. "192.168.1.1"/"example.com" timeout: Time to wait for a response, in seconds. Default is 4s, same as Windows CMD. (default 4) unit: The unit of returned value. "s" for seconds, "ms" for milliseconds. (default "s") src_addr: The IP address to ping from. This is for multiple network interfaces. Ex. "192.168.1.20". (default None) interface: LINUX ONLY. The gateway network interface to ping from. Ex. "wlan0". (default None) ttl: The Time-To-Live of the outgoing packet. Default is None, which means using OS default ttl -- 64 onLinux and macOS, and 128 on Windows. (default None) seq: ICMP packet sequence, usually increases from 0 in the same process. (default 0) size: The ICMP packet payload size in bytes. If the input of this is less than the bytes of a double format (usually 8), the size of ICMP packet payload is 8 bytes to hold a time. The max should be the router_MTU(Usually 1480) - IP_Header(20) - ICMP_Header(8). Default is 56, same as in macOS. (default 56) Returns: The delay in seconds/milliseconds, False on error and None on timeout. Raises: PingError: Any PingError will raise again if `ping3.EXCEPTIONS` is True. zB`{}` when create socket.SOCK_RAW, using socket.SOCK_DGRAM instead.Nz5Set Socket Option `IP_TTL` in `IPPROTO_IP` Failed: {}z1Set Socket Option `IP_TTL` in `SOL_IP` Failed: {}zSocket Interface Binded:rzSocket Source Address Binded: get_native_idz{}{}i)rer_rfrHrg)rerfrHr|Fmsi)#riAF_INETr IPPROTO_ICMPPermissionErrorerrnoEPERMr)r SOCK_DGRAM getsockopt IPPROTO_IPIP_TTL setsockoptOSErrorSOL_IP SOL_SOCKETSOCKET_SO_BINDTODEVICErrbindhasattr threadingr currentThreadidentrgetpidzlibcrc32r{rrrr, PingError)r_r|rr^r\rHrgrrer+ thread_id process_idrfdelayrrrpingsx        "&rcountintervalc Os|d}|d}|dd}d}||ks|dkr|dkr'|dkr't|d|} | |r4d|nd7} | d 7} t|g|Rd |i|} t| dd | d ur^t|rZd |ndn| durgtdn tdjt| |d|d7}||ks|dksd Sd S)ag Send pings to destination address with the given timeout and display the result. Args: dest_addr: The destination address. Ex. "192.168.1.1"/"example.com" count: How many pings should be sent. 0 means infinite loops until manually stopped. Default is 4, same as Windows CMD. (default 4) interval: How many seconds between two packets. Default is 0, which means send the next packet as soon as the previous one responsed. (default 0) *args and **kwargs: And all the other arguments available in ping() except `seq`. Returns: Formatted ping results printed. r|r^rrrz ping '{}'z from '{}'r0z ... rH)endNz Timeout > {}srFErrorz {value}{unit})valuerr)get setdefaultrqsleeprrprintr`) r_rrr&r'r|srcri output_textrrrr verbose_pingGs&       r)rrNNrrN)rr)*rrirKrrqrrrr r8rr0renumsrrrrrr r*r$rarMrprr)r,callabler:bytesr`rCrIrOrdrr{floatrrrrrrrsF    $ O2C