*0hFddlZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZmZmZmZdZdZdZdadZdZd Zd Zd$d Zd ed dfdZdZded efdZ ded e!fdZ"ded e!fdZ#edejde$dededed df dZ%edejdededefdZ&ed%de$dede$de$dedede$fd Z'ed&de$d!ed"e(fd#Z)y)'N)errors)ICMP_DEFAULT_CODEIcmpTypeIcmpTimeExceededCodeIcmpDestinationUnreachableCodez4.0.8Fz !BBHHHBBHIIz!BBHHHz!dreturncd}tsytxs|adjd|D}tj|y)zPrint debug info to stdout if `ping3.DEBUG` is True. Args: *args (any): Usually are strings or objects that can be converted to str. ctjt}|jtjtj d}tj }|jtj|j||j||jdjt|jdj||S)Nz[%(levelname)s] %(message)szPing3 Version: {}z LOGGER: {}) logging getLogger__name__setLevelDEBUG Formatter StreamHandler setFormatter addHandlerdebugformat __version__)logger formatter cout_handlers L/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/ping3/__init__.py get_loggerz_debug..get_logger#s""8, &%%&CD ,,. gmm,!!),,' (// <= \((01 N c32K|]}t|ywNstr).0items r z_debug..3s2Ts4y2)rLOGGERjoinr)argsrmessages r_debugr,s;    #z|Fhh2T22G LLrerrctr|y)zRaise exception if `ping3.EXCEPTIONS` is True. Args: err (Exception): Exception to be raised. Raise: Exception: Exception passed in args will be raised if `ping3.EXCEPTIONS` is True. N) EXCEPTIONS)r-s r_raiser07s rcBtjfd}|S)zDecorator that log function calls for debug Args: func (callable): Function to be decorated. Returns: callable: Decorated function. cdjd|D}|r t|nd}|r|rdj||fn|xs|}tddj||i|}tddj| |S) Nz, c32K|]}t|ywr!r")r$args rr&z0_func_logger..wrapper..Os3s#c(3r'zFunction called:z{func.__name__}({}))funczFunction returned:z{func.__name__} -> {rtrn})r6rtrn)r)r#r,r)r*kwargspargskargsall_args func_returnr6s rwrapperz_func_logger..wrapperMs 3d33%F 2165499eU^,QV!#8#?#?t#?#TUD+F+ #%@%G%GTXc%G%der) functoolswraps)r6r=s` r _func_loggerr@Ds'__T Nrsourcecd}d|z}t|dddt|ddd|dzzz}||k\rtt||}||k\r|d|zdz zS)aCalculates 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)rABITScarryresults rchecksumrJZsw D IE ! VADqD\!2tqy!A BF E/VFE*+ E/ 7qDyAo &&rrawc `d}tt|tjt|S)zGet information from raw ICMP header data. Args: raw (Bytes): Raw data of ICMP header. Returns: dict: A map contains the infos from the raw header. )typecoderJidseq)dictzipstructunpackICMP_HEADER_FORMAT)rKicmp_header_keyss rread_icmp_headerrWns*A $fmm4F&LM NNrc dtdtfd}d}tt|t j t |}||d|d<||d|d<|S)zGet information from raw IP header data. Args: raw (Bytes): Raw data of IP header. Returns: dict: A map contains the infos from the raw header. ipr c8djfddDS)N.c3@K|]}t|z dzyw)Nr")r$offsetrYs rr&z7read_ip_header..stringify_ip..sNVB&L4/0Ns)rCr)r))rYs`r stringify_ipz$read_ip_header..stringify_ipsxxN~NNNr) versiontoslenrOflagsttlprotocolrJsrc_addr dest_addrrhri)intr#rQrRrSrTIP_HEADER_FORMAT)rKraip_header_keys ip_headers rread_ip_headerrn{skOOOvNS7G)MNOI(:)>?Ij))K*@AIk rsockriicmp_idrPsizectdj| tj|}td|d}tjttjt|||}|tjtz dz}tjttj|j!z} t#|| z} tjttjttj$| ||}tdt'|td| || z} |j)| |dfy#tj$r}t j ||d}~wwxYw) a Sends 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.socket): Socket. dest_addr (str): The destination address, can be an IP address or a domain name. Ex. "192.168.1.1"/"example.com" icmp_id (int): ICMP packet id. Calculated from Process ID and Thread ID. seq (int): ICMP packet sequence, usually increases from 0 in the same process. size (int): 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: '{}')riNzDestination IP address:rQzSent ICMP header:zSent ICMP payload:)r,rsocket gethostbynamegaierrorr HostUnknownrSpackrUr ECHO_REQUESTrcalcsizeICMP_TIME_FORMATtimeencoderJhtonsrWsendto) rorirprPrqr-pseudo_checksum icmp_headerpadding icmp_payload real_checksumpackets r send_one_pingrsH$ & - -i 89?((3  $i0O++0(2G2GIZ\kmtvyzKfoo&6773>G;;/=@PPL[<78M++0(2G2GIZ\b\h\hiv\wzACFGK  0 => . < 'FKKA' ???  953>?sEF*FFtimeoutctjdk7xs6tjdk(xs|jt j k(}|r^tdtjt}t|j|jtjtz}n.tdtdtjt}tj|z}tdjtj || |tjz }|dkDr|nd}tdj|t#j"|ggg|} | dgk(rt%j&|tj} tdjtj | | |j)d \} } |r| } t+| }td |nd }| || |jd }}t-|}td |td ||s|j/d}|dt0j2k(rA|dt4j6k(rt%j8||t%j:|dt0j<k(rD|dt>j@k(rt%jB||t%jD|||dr|dt0jFk(r td|d|k7r td#|d|k7r td8|dt0jHk(rjtjJtL|dtjtLd}tdjtj ||| |z Std|)aReceives 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 (socket.socket): The same socket used for send the ping. icmp_id (int): ICMP packet id. Sent packet id should be identical with received packet id. seq (int): ICMP packet sequence. Sent packet sequence should be identical with received packet sequence. timeout (int): Timeout in seconds. Returns: float | None: 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: {} ({})zTimeout left: {:.2f}s)rzReceived time: {} ({}))izReceived IP header:NzReceived ICMP header:zReceived ICMP payload:rrMrN)rmrrOz+ECHO_REQUEST received. Packet filtered out.z&ICMP ID dismatch. Packet filtered out.rPz'IMCP SEQ dismatch. Packet filtered out.zReceived sent time: {} ({})zUncatched ICMP packet:)'osnameplatformsystemrMrtSOCK_RAWslicerSrzrkstoprUr,r|rctimeselectrTimeoutrecvfromrnrW getsocknamer TIME_EXCEEDEDr TTL_EXPIREDTimeToLiveExpired TimeExceededDESTINATION_UNREACHABLErDESTINATION_HOST_UNREACHABLEDestinationHostUnreachableDestinationUnreachablery ECHO_REPLYrTr{)rorprPr has_ip_headerip_header_sliceicmp_header_slice timeout_time timeout_leftselected time_recv recv_dataaddr ip_header_rawrmicmp_header_rawicmp_payload_rawr time_sents rreceive_one_pingrsT0WW'mX__->(-JmPTPYPY]c]l]lPlM6??3C#DE!/"6"68L8Lv_qOr8rs&'!!V__5G%HI99;(L " ) )$**\*BL QR #diik1 '3a'7|Q &--l;<==$2r<@ A;" ..1 1IIK (// 90EyQR--- 4 %o6M&}5I () 4I,56G,H)TeTjTjTkJl)&7 & 4')9:&&(+G v ("8"8 86"&:&F&FF..P[\\%%' ' v ("B"B B6"&D&a&aa77)Ydee//)Q\] ] t 6"h&;&;;DE4 G+?@5!S(@A6"h&9&99"MM*:j@$r(} t| tC| Yd} ~ dddyd} ~ wt>jD$r(} t| tC| Yd} ~ dddy d} ~ wwxYw#1swYyxYw)a Send one ping to destination address with the given timeout. Args: dest_addr (str): The destination address, can be an IP address or a domain name. Ex. "192.168.1.1"/"example.com" timeout (int): Time to wait for a response, in seconds. Default is 4s, same as Windows CMD. (default 4) unit (str): The unit of returned value. "s" for seconds, "ms" for milliseconds. (default "s") src_addr (str): The IP address to ping from. This is for multiple network interfaces. Ex. "192.168.1.20". (default "") interface (str): LINUX ONLY. The gateway network interface to ping from. Ex. "wlan0". (default "") ttl (int | None): 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 (int): ICMP packet sequence, usually increases from 0 in the same process. (default 0) size (int): 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: float | None | False: 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)rorirprPrq)rorprPrFmsi)#rtAF_INETr IPPROTO_ICMPPermissionErrorerrnoEPERMr,r SOCK_DGRAM getsockopt IPPROTO_IPIP_TTL setsockoptOSErrorSOL_IP SOL_SOCKETSOCKET_SO_BINDTODEVICEr}bindhasattr threadingr currentThreadidentrgetpidzlibcrc32rrrrr0 PingError)rirrrhrfrPrqrror- thread_id process_idrpdelays rpingrs*}}V^^V__f>Q>QR $  \??6#4#4fmmDOOF$5$5v}}cJ X??6==&--@OOFMM6==#F  OOF--/EyGWGWGY Z -y 9  IIxm $ 2H =18O1TI++-ZcZqZqZsZyZy YY[ **V]]:yAHHJKfT  ty'sY] ^$$SRYZE =C$$D 4< TMEI$$  99 # W^^_bc d==1B1BFDWDWXDI  \NUUVYZ[[ \  XJQQRUVWW X~~  3K 3K7$$8  3K 3K?$$8 9$$sAH3N AK'AK6C.N3L'N N3 K {}srFErrorz {value}{unit})valuerr)get setdefaultr|sleeprrprintrj) rirrr*r8rsrcri output_textrs r verbose_pingrGsjj#G **Z C   VT *D A e)uz a w Y77A77 kr" = W/((1) L e^ 'N /((s5z(E F Q e)uzr)r N)sr5Nr8r5)rr)*rrtrSrr|rrrr r>rr5renumsrrrrrrr/r(rkrUr{rr, Exceptionr0r@bytesrjrJrQrWrnr#rrrfloatrrrrs   dd     4  d ,'U's'( O% OD O$&!( !(#!(!(#!(UX!(]a!(!(HL66==L63L6SL63L6L6^@C@#@@c@`c@or@EH@@FC5r