ping
----

.. osdx:opcmd:: ping <ipv4|ipv6|txt>

    .. raw:: html

        <span class="badge" style="background-color: lightslategray">SDE</span>
        <span class="badge" style="background-color: steelblue">M10-Smart</span>
        <span class="badge" style="background-color: goldenrod">M2</span>
        <span class="badge" style="background-color: firebrick">RS420</span>

    Send Internet Control Message Protocol (ICMP) echo request


    :arg ipv4:
        IPv4 address
    :arg ipv6:
        IPv6 address
    :arg hostname:
        Hostname




    :options:

    .. osdx:opcmd::  no-loopback

        Supress loopback of multicast packets



    .. osdx:opcmd::  tos <u32>

        Set Quality of Service related bits in ICMP datagrams

        :arg u32:
            Mark packets with specified TOS



    .. osdx:opcmd::  vrf <id>

        Set source address to a specific VRF

        :ref Reference: system vrf *
        :arg id:
            VRF name



    .. osdx:opcmd::  deadline <float>

        Timeout before exit, regardless of sent/rcvd packet number

        :arg float:
            Time in seconds before ping exits



    .. osdx:opcmd::  numeric

        Numeric output only, without resolving DNS names



    .. osdx:opcmd::  count <int>

        Send a specific number of requests before stopping

        :arg int:
            Number of ping requests to be sent



    .. osdx:opcmd::  verbose

        Verbose output



    .. osdx:opcmd::  mark <int>

        Mark request for special processing

        :arg int:
            Mark tag for the outgoing packets



    .. osdx:opcmd::  timeout <float>

        Timeout for each individual ping response

        :arg float:
            Time in seconds to wait for a response



    .. osdx:opcmd::  local-address <value>

        Use local IP address as the source address of the connection

        :arg value:
            Local IP address



    .. osdx:opcmd::  quiet

        Quiet output (print summary lines only)



    .. osdx:opcmd::  interval <float>

        Waiting time between each packet sending

        :arg float:
            Interval in seconds between each packet transmission



    .. osdx:opcmd::  bypass-route

        Bypass normal routing tables and send ping directly



    .. osdx:opcmd::  adaptive

        Adaptively set interpacket interval



    .. osdx:opcmd::  allow-broadcast

        Allow pinging a broadcast address



    .. osdx:opcmd::  record-route

        Use Record-Route option



    .. osdx:opcmd::  audible

        Audible ping



    .. osdx:opcmd::  pattern <int>

        Pattern to fill out the packet

        :arg int:
            Pattern bytes



    .. osdx:opcmd::  size <int>

        Specify number of data bytes to be sent

        :arg int:
            Number of bytes to send



    .. osdx:opcmd::  timestamp

        Print timestamp before each output line



    .. osdx:opcmd::  flood

        Send 100 requests per second



    .. osdx:opcmd::  interface <ipv4|ipv6|ifc>

        Set source address to a specific interface address

        :arg ipv4:
            Address or interface name
        :arg ipv6:
            Address or interface name
        :arg ifc:
            Address or interface name



    .. osdx:opcmd::  ttl <u32>

        Set the IP Time to Live

        :arg u32:
            Maximum packet lifetime