Net::Ping

Provides methods to create ping objects and test the reachability of remote hosts on the network. After the object has been created, a variable number of hosts can be pinged multiple times before closing the connection. The methods are the following.

new 
$p = Net::Ping->new([proto[, def_timeout[, bytes]]])

Creates a new ping object. All arguments are optional. Takes the following arguments:

  • proto
  • The protocol to use when doing a ping. Default is udp. The possible protocols are:
    • icmp
    • Sends an icmp echo message to the remote host. If the echoed message is received back correctly from the remote host, that host is considered reachable. Requires the program to be run as root or setuid to root.
    • tcp
    • Attempts to establish connection to remote host's echo port. If successful, remote host is considered reachable. No data is actually echoed. No special privileges are required, but overhead is higher than for the others.
    • udp
    • Sends a udp packet to remote host's echo port. If the echoed packet is received back from the remote host and contains the same data that was sent, the remote host is considered reachable. Requires no special privileges.
  • def_timeout
  • Default timeout in seconds to be used if timeout not passed to the ping method. Must be greater than zero; defaults to five seconds.
  • bytes
  • Number of bytes included in the ping packet sent to the remote host. Ignored if protocol is tcp. Default is if protocol is udp, otherwise . These are also the minimum number of bytes; the maximum is 1,024.
close 
$p->close( )

Closes network connection for this ping object. The connection can also be closed by undef $p and is automatically closed if the ping object goes out of scope.

ping 
$p->ping(host[, timeout])

Pings remote host and waits for a response. Takes the following arguments:

  • host
  • Specified as either the hostname or the IP number of the remote host.
  • timeout
  • Optional, must be greater than seconds if specified. Defaults to whatever was specified when the ping object was created.

If host cannot be found, or if there is a problem with the IP number, returns undef. Otherwise, returns if the host is reachable and if it is not.

pingecho 
pingecho (host[, timeout])

Provides backward compatibility with the previous version of Net::Ping. Uses the tcp protocol, with return values and parameters the same as described for ping.