HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

p
ping(1M) ping(1M)
NAME
ping - send ICMP Echo Request packets to network host
SYNOPSIS
ping [-oprv][-f address-family][
-i address ][
-I interval ][-t ttl] host
[
-n count [-m timeout ]]
ping [-oprv][-f address-family][
-i address ][
-I interval ][-t ttl] host packet-size
[[
-n] count [-m
timeout]]
DESCRIPTION
The
ping command sends ICMP Echo Request (ECHO_REQUEST) packets to the host once per second.
Each packet that is echoed back via an ICMP Echo Response packet is written to the standard output,
including round-trip time.
ICMP Echo Request datagrams ("pings") have an IP and ICMP header, followed by a
struct timeval
(see gettimeofday (2)) and an arbitrary number of "pad" bytes used to fill out the packet. The default
datagram length is 64 bytes, but this can be changed by using the packet-size option.
Options
The following options and parameters are recognized by
ping:
-i address If host is a multicast address, send multicast datagrams from the interface with the
local IP address specified by address in ‘‘dot’’ notation (see inet(3N)). If the
-i option
is not specified, multicast datagrams are sent from the default interface, which is
determined by the route configuration.
-o Insert an IP Record Route option in outgoing packets, summarizing routes taken when
the command terminates.
It may not be possible to get the round-trip path if some hosts on the route taken do not
implement the IP Record Route option. A maximum of 9 Internet addresses can be
recorded due to the maximum length of the IP option area.
-p The new Path MTU information is displayed when a ICMP Datagram Too Big
message is received from a gateway. The -p option must be used in conjunction with a
large packetsize and with the -v option.
-r Bypass the normal routing tables and send directly to a host on an attached network.
If the host is not on a directly-connected network, an error is returned. This option can
be used to ping the local system through an interface that has no route through it, such
as, after the interface was dropped by gated (see gated(1M)).
-t ttl If host is a multicast address, set the time-to-live field in the multicast datagram to ttl .
This controls the scope of the multicast datagrams by specifying the maximum number
of external systems through which the datagram can be forwarded.
If ttl is zero, the datagram is restricted to the local system. If ttl is one, the datagram
is restricted to systems that have an interface on the network directly connected to the
interface specified by the
-i option. If ttl is two, the datagram can be forwarded
through one multicast router at the most; and so forth. Range: zero to 255. The
default value is 1.
-I interval This option specifies the interval in seconds, between each packet to be transmitted.
The default interval is 1 second.
-v Verbose output. Show ICMP packets other than Echo Responses that are received.
-f address-family
The address-family determines whether the host is an IPv4 or IPv6 host. The address
families currently supported are inet for IPv4 addresses and inet6 for IPv6
addresses.
host Destination to which the ICMP Echo Requests are sent. host can be a hostname or an
IPv4 or IPv6 Internet address. All symbolic names specified for host are looked up by
using
gethostbyname() (see gethostent (3N)) for IPv4, and getaddrinfo() (see
getaddrinfo (3N)) for IPv6. If host is an Internet address, it must be in "dot" notation
(see inet(3N)) for IPv4, and in "colon" notation (see inet6(3N)) for IPv6.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−613