Table of Contents

Check network connectivity

Synopsis

  ping [--size <size>] [--timeout <timeout>] [--count <count>] <host>

Examples

Check connectivity to www.ipxe.org

  iPXE> ping www.ipxe.org
  64 bytes from 212.13.204.60: seq=1
  64 bytes from 212.13.204.60: seq=2
  64 bytes from 212.13.204.60: seq=3

Check connectivity to default gateway

  ping --count 1 ${netX/gateway} && goto gateway_good || goto gateway_bad

Description

Check network connectivity to the specified host using the specified number of ICMP ECHO (“ping”) packets of the specified payload size, sent every specified timeout interval (in milliseconds).

If no payload size is explicitly specified, then the default size of 64 bytes will be used. If no timeout interval is explicitly specified, then the default timeout interval of one second will be used. If no count is explicitly specified, then an unlimited number of ICMP ECHO packets will be sent.

Command status

Success The host has responded with at least one ICMP ECHO reply packet
Failure Command was cancelled, or a network problem occurred

See also

Build options

This command is available only when the build option PING_CMD is enabled.

Note that if no --count option is specified then the ping command will terminate only when it is cancelled by the user (e.g. by pressing Ctrl-C).