&ihSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK J r SSKJrJrJrJrJrJr SrSrSrSqSrSrS rS rS rS rS(SjrS\ S S4Sjr!Sr"S\RS \#4Sjr$S\%S \&4Sjr'S\%S \(4Sjr)S\%S \(4Sjr*S\%S \(4Sjr+\"S\RS\,S\&S\&S\&S S4 Sj5r-\"S\RS\&S\&S\&4S j5r.\"S)S\,S\&S!\,S"\,S\&S\&S#\,4S$jj5r/\"S*S\,S%\&S&\04S'jj5r1g)+N)errors)ICMP_DEFAULT_CODE IcmpV4Type IcmpV4DestinationUnreachableCodeIcmpTimeExceededCode IcmpV6Type IcmpV6DestinationUnreachableCodez5.1.5Fz !BBHHHBBHIIz !IHBB16s16sz!BBHHHz!dz !16s16sIBBBBreturncSn[(dg[=(d U"5qSRSU55n[RU5 g)zPrint debug info to stdout if `ping3.DEBUG` is True. Args: *args (any): Usually are strings or objects that can be converted to str. c[R"[5nUR[R5 [R "S5n[R "5nUR[R5 URU5 URU5 URSR[55 URSRU55 U$)Nz[%(levelname)s] %(message)szPing3 Version: {}z LOGGER: {}) logging getLogger__name__setLevelDEBUG Formatter StreamHandler setFormatter addHandlerdebugformat __version__)logger formatter cout_handlers 8C:\MON_AGENTE\python\Lib\site-packages\ping3/__init__.py get_logger_debug..get_logger(s""8, &%%&CD ,,. gmm,!!),,' (// <= \((01 N c38# UHn[U5v M g7fNstr).0items r _debug..8s2TTs4yyT)rLOGGERjoinr)argsrmessages r_debugr0!s=  5  #z|Fhh2T22G LLr!errc[(aUeg)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)r1s r_raiser4<sz r!cF^[R"T5U4Sj5nU$)zDecorator that log function calls for debug Args: func (callable): Function to be decorated. Returns: callable: Decorated function. c.>SRSU55nU(a [U5OSnU(aU(aSRX#45O U=(d Un[SSRUTS95 T"U0UD6n[SSRTUS 95 U$) Nz, c38# UHn[U5v M g7fr$r%)r'args rr)0_func_logger..wrapper..Us3ds#c((dr+zFunction called:z{func.__name__}({}))funczFunction returned:z{func.__name__} -> {rtrn})r;rtrn)r-r&r0r)r.kwargspargskargsall_args func_returnr;s rwrapper_func_logger..wrapperSs 3d33%F 2165499e^,QV!#8#?#?t#?#TUD+F+ #%@%G%GTXc%G%der!) functoolswraps)r;rBs` r _func_loggerrFIs'__T Nr!sockc<UR[R:H$)zCheck if the socket is IPv4. Args: sock (socket.socket): The socket to be checked. Returns: bool: True if the socket is IPv4, False otherwise. )familysocketAF_INET)rGs ris_ipv4rL`s ;;&.. ((r!sourcecSnSU-n[USSS25[USSS25US---nX2:a[[X255nX2:aMU)SU-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)rMBITScarryresults rchecksumrVlsq D IE ! VADqD\!2tqy!A BF /VF*+ / 7qDyAo &&r!rawc bSn[[U[R"[U555$)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. )typecoderVidseq)dictzipstructunpackICMP_HEADER_FORMAT)rWicmp_header_keyss rread_icmp_headerrcs*A $fmm4F&LM NNr!c S[S[4SjnSn[[U[R "[ U555nU"US5US'U"US5US'U$)zGet information from raw IPv4 header data. Args: raw (Bytes): Raw data of IPv4 header. Returns: dict: A map contains the infos from the raw header. ipr c:^SRU4SjS55$)N.c3F># UHn[TU- S-5v M g7f)Nr%)r'offsetres rr)9read_ipv4_header..stringify_ip..s"N~VB&L4/00~s!)rOr)r-)res`r stringify_ip&read_ipv4_header..stringify_ipsxxN~NNNr!) versiontoslenr[flagsttlprotocolrVsrc_addr dest_addrrvrw)intr&r]r^r_r`IPV4_HEADER_FORMAT)rWrnipv4_header_keys ipv4_headers rread_ipv4_headerr|smOOOxs+V]];Ms-STUK*;z+BCK +K ,DEK  r!c Sn[[U[R"[USS555nUSUSUSS.nUSS - S -US 'USS - S -US'USS-US'[ R "[ RUS5US'[ R "[ RUS5US'U$)zGet information from raw IPv6 header data. Args: raw (Bytes): Raw data of IPv6 header. Returns: dict: A map contains the infos from the raw header. )initialrr next_header hop_limitrvrwN(rrrr)rrrrr~rpri traffic_classi flow_labelrvrw)r]r^r_r`IPV6_HEADER_FORMATrJ inet_ntopAF_INET6)rWipv6_header_keysipv6_header_unpacked ipv6_headers rread_ipv6_headerrs_$4fmmDVX[\_]_X`6a bc#E*+M:)+6K 39=CtKK $8$Cr$IT#QK 4Y ?' IK $..v@TU_@`aK %//AUVaAbcK  r!rwicmp_idr\sizec [SU5 [U5(a[R"U5nUS4nOK[R"US[R [R [R5SSn[SUS5 Sn[R"[[U5(a[RO[ R["UUU5nU[R$"[&5- S-n [R"[&[(R("55U R+5-n [U5(a[-X-5n GO[R"[R UR.UR05n U R3U5 U R55Sn SSS5 [SR7W 55 [R"[8[R:"[R U 5[R:"[R US5[=U5[=U 5-SSS[ R5n[-X-U -5n [R"[[U5(a[RO[ R["[R>"U 5UU5n[S [AU55 [S U 5 X-nURCX5 g![Ran[R"US9UeSnAff=f!,(df  GN=f) 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 ICMPv6 Wikipedia: https://en.wikipedia.org/wiki/ICMPv6 IPv4 Wikipedia: https://en.wikipedia.org/wiki/IPv4 IPv6 Wikipedia: https://en.wikipedia.org/wiki/IPv6_packet Args: sock (socket.socket): Socket. dest_addr: The destination address, can be an IPv4 address or an IPv6 address or a domain name. Ex. "192.168.1.1"/"example.com"/"2001:db8::1" Socket address is (dest_addr, port) with IPv4 and (dest_addr, port, flowinfo, scopeid) with IPv6. Port is 0 respectively the OS default behavior will be used. With IPv6, Flowinfo is 0, Scope ID is the interface index if dest_addr is a link-local address. 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:rN)rwzResolved destination address:QzSource Address: {}zSent ICMP header:zSent ICMP payload:)"r0rLrJ gethostbyname getaddrinforSOCK_RAWIPPROTO_ICMPV6gaierrorr HostUnknownr_packrar ECHO_REQUESTr rcalcsizeICMP_TIME_FORMATtimeencoderVrYprotoconnect getsocknamerICMPV6_PSEUDO_HEADER_FORMAT inet_ptonrrhtonsrcsendto)rGrwrr\r sock_addrr1pseudo_checksum icmp_headerpadding icmp_payload real_checksum dummy_sockrv pseudo_headerpackets r send_one_pingrs|, !9-? 4==,,Y7I"AI**9dFOOV__^d^s^stuvwxyzI *IaL9O++#*4== j6M6M Kfoo&6773>G;;/=@PPLt}} !;< ]]6??DIItzz Bj   y )!--/2HC #**845 '   V__h 7   V__il ;  s<0 0 q!  # #  !!<|!KL ++#*4== j6M6M ]# K  0 => .  'FKK"W ???  953>?&C Bs)*LA L%MM 2MM  MtimeoutcB Sn[U5(a[O[n[R"5U-n[ SR [R "U5U55 U[R"5- nUS:aUOSn[ SR U55 [R"U///U5nUS/:Xa[R"US9e[R"5n [ SR [R "U 5U 55 URS5up[U5(aW[RS:g=(d< [R"5S :H=(d UR[ R":Hn OU"X 5n U (a[ S 5 [%S[&R("[U5(a[*O[,55n [%U R.U R.[&R("[05-5nXn[U5(a [3U5O [5U5n[ S U5 O1[ S 5 S n[%S[&R("[055nXXR.S nn[7U5n[ SU5 [ SU5 USUR8:XaAUS[:R<:Xa[R>"UUS9e[R@"5eUSURB:Xa[U5(a-US[DRF:Xa[RH"UUS9eOXUS[JRL:Xa[RN"UUS9eUS[JRP:Xa[RR"UUS9e[RT"UUS9eUS(Ga1USURV:Xa[ S5 GM[ SUSSSU5 USU:HnU(dCU (d<URY5SnUSU:HnU(a[ SR U55 U(d[ S5 GMUSU:wa[ S5 GM+USURZ:Xam[&R\"[^US[&R("[^55Sn[ SR [R "U5U55 U U- $[ SU5 GM)aiReceives 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. cxUSS- n[SRU55 U[U5(aS:H$S:H$)a'Detect if the received data has an IP header. IPv4 header first 4 bits is 4 (0b0100). ICMPv4 Type starts with 4 (64~79) is unassigned. See https://en.wikipedia.org/wiki/Internet_Control_Message_Protocol#Control_messages IPv6 header first 4 bits is 6 (0b0110). ICMPv6 Type starts with 6 (96~111) is unassigned. See https://en.wikipedia.org/wiki/ICMPv6#Types Args: sock (socket.socket): The socket used to receive the data. recv_data (bytes): The received data. Returns: bool: True if the received data has an IP header, False otherwise. rrz:Detecting if received data has IP header. First 4 bits: {})r0rrL)rG recv_data first_fields rdetect_ip_header*receive_one_ping..detect_ip_headersB la' KRRS^_`GDMMq99q99r!zTimeout time: {} ({})rzTimeout left: {:.2f}s)rzReceived time: {} ({}))iposixDarwinzHas IP header: TruezReceived IP header:zHas IP header: FalseNzReceived ICMP header:zReceived ICMP payload:rYrZ) ip_headerrr[z+ECHO_REQUEST received. Packet filtered out.zICMP ID:,z Expected:rzICMP ID rewrited by kernel: {}z&ICMP ID dismatch. Packet filtered out.r\z'IMCP SEQ dismatch. Packet filtered out.zReceived sent time: {} ({})zUncatched ICMP packet:)0rLrr rr0rctimeselectrTimeoutrecvfromosnameplatformsystemrYrJrslicer_rryrstoprar|rrc TIME_EXCEEDEDr TTL_EXPIREDTimeToLiveExpired TimeExceededDESTINATION_UNREACHABLErDESTINATION_HOST_UNREACHABLEDestinationHostUnreachabler ADDRESS_UNREACHABLEAddressUnreachablePORT_UNREACHABLEPortUnreachableDestinationUnreachablerr ECHO_REPLYr`r)rGrr\rr icmp_type timeout_time timeout_leftselected time_recvraddr has_ip_headerip_header_sliceicmp_header_slice ip_header_rawricmp_header_rawicmp_payload_rawris_icmp_id_matched time_sents rreceive_one_pingrsI0:"&dmm I99;(L " ) )$**\*BL QR #diik1 '3a'7|Q &--l;<==$R> A;" ..1 1IIK (// 90EyQR--- 4==WW/uX__5F(5RuX\XaXaeketetXtM,T=M  ( )#AvWUY]]7I`r'stO %o&:&:O"5O[<R@"5RBn[DRF"5n[HRJ"SR X5R755S-n[MXUXVS9 [OU UXQS9nUc SSS5 gUS:XaUS-nUsSSS5 $![a SnGNHf=f![akn U R[R:XaF[ SR U 55 [ R "U [ RU 5n Sn A GNU eSn A ff=f![*a%n [ SR U 55 Sn A GNSn A ff=f![*a%n [ SR U 55 Sn A GN1Sn A ff=f![*a%n [ S R U 55 Sn A GNcSn A ff=f![PRRa(n [ U 5 [UU 5 Sn A SSS5 gSn A f[PRVa(n [ U 5 [UU 5 Sn A SSS5 gSn A ff=f!,(df  g=f)u$ 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"/“fd00::1“ 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 "") 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) interface (str): LINUX ONLY. The gateway network interface to ping from. Ex. "wlan0". (default "") ip_v (int | None): The IP version to use. 4 for IPv4, 6 for IPv6. If None, the function will try to determine the IP version from `dest_addr`. (default None) 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. Nrz Ping IPv{}:rzUnsupported IP version: {}zB`{}` when create socket.SOCK_RAW, using socket.SOCK_DGRAM instead.z5Set Socket Option `IP_TTL` in `IPPROTO_IP` Failed: {}z1Set Socket Option `IP_TTL` in `SOL_IP` Failed: {}zBSet Socket Option `IPV6_UNICAST_HOPS` in `IPPROTO_IPV6` Failed: {}zSocket Interface Binded:rzSocket Source Address Binded: get_native_idz{}{}i)rGrwrr\r)rGrr\rFmsi), ipaddress ip_addressrp ValueErrorr0rrJrK IPPROTO_ICMPrrrPermissionErrorerrnoEPERM SOCK_DGRAMrL getsockopt IPPROTO_IPIP_TTL setsockoptOSErrorSOL_IP IPPROTO_IPV6IPV6_UNICAST_HOPS SOL_SOCKETSOCKET_SO_BINDTODEVICErbindhasattr threadingrcurrent_threadidentrgetpidzlibcrc32rrrrr4 PingError)rwrrrvrtr\rrrpre socket_familysocket_protocolrGr1 thread_id process_idrdelays rpingrws, %%i0BjjG =   ()4!|  -- A  //5<Q93S:9Q>>S:S7R8+S:8S7S2%S:2S77S:: TcountintervalcBURS5nURS5nURSS5nSnX:dUS:XaUS:aUS:a[R"U5 SR U5n X(aSR U5OS- n U S - n [ U/UQ7S U0UD6n [ U SS 9 U c$[ U(aS R U5OS5 O3U SLa [ S5 O"[ SR [U 5US95 US- nX:aMUS:XaMg g )a\ Send pings to destination address with the given timeout and display the result. Args: dest_addr (str): The destination address. Ex. "192.168.1.1"/"example.com" count (int): How many pings should be sent. 0 means infinite loops until manually stopped. Default is 4, same as Windows CMD. (default 4) interval (float): 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 (any): And all the other arguments available in ping() except `seq`. Output: Formatted ping results printed. rrvrrrz ping '{}'z from '{}'r:z ... r\)endNz Timeout > {}srFErrorz {value}{unit})valuerr)get setdefaultrsleeprrprintrx) rwrr r.r=rsrcri output_textrs r verbose_pingrs jj#G **Z C   VT *D A )uz a w Y77A77 kr" = W/((1) L e^ 'N /((s5z(E F Q )uzr!)r N)rsr:Nr8r:N)rr)2rrJr_rrrrrrrDrrr:renumsrrrrr r rrr3r,ryrrarrrr0 Exceptionr4rFboolrLbytesrxrVr]rcr|rr&rrrfloatrr!rrs   WW    #",6  d . )&-- )D )'U's'( O% OD O%D(%D0G# G##G#G##G#UXG#]aG#G#To66==o63o6So63o6o6dYCY#YYcY_bYnqYDGYYxC5r!