ipoam

Documentation

Overview

Command ipoam verifies IP-layer connectivity and discovers an IP-layer path like ping and traceroute commands.

Usage: ipoam command [flags] [arguments]

The commands are:

cv|ping                 Verify IP-layer connectivity
rt|pathdisc|traceroute  Discover an IP-layer path
sh|show|list            Show network facility information

Verify IP-layer connectivity

CV (Connectivity Verification) uses both ICMP echo request and reply messages for verifying IP-layer connectivity. The destination can be unicast (including anycast), multicast or broadcast addresses. Also it can be a single or multiple addresses.

Usage: ipoam cv|ping [flags] destination

Destination:

A hostname, DNS reg-name, IP address, IP address prefix, or
comma-separated list of IP addresses and/or IP address prefixes.
A combination of unicast and multicast addresses is prohibited.

Flags:

-4	Run IPv4 test only
-6	Run IPv6 test only
-count int
	Iteration count, less than or equal to zero will run until interrupted
-hops int
	IPv4 TTL or IPv6 hop-limit on outgoing unicast packets (default 64)
-if string
	Outbound interface name
-mchops int
	IPv4 TTL or IPv6 hop-limit on outgoing multicast packets (default 5)
-n	Don't use DNS reverse lookup
-pldlen int
	ICMP echo payload length (default 56)
-q	Quiet output except summary
-src string
	Source IP address
-tc int
	IPv4 TOS or IPv6 traffic-class on outgoing packets
-v	Show verbose information
-wait int
	Seconds between transmitting each echo (default 1)
-x	Run transmission only

A sample output:

% sudo ipoam cv -v -count=3 golang.org
Connectivity verification for golang.org [216.58.220.177 2404:6800:4004:812::2011]: 56 bytes payload
error="write ip6 ::->2404:6800:4004:812::2011: sendmsg: no route to host"
56 bytes tc=0x0 hops=51 from=nrt13s35-in-f177.1e100.net. (216.58.220.177) to=blah.lan. (192.168.86.23) if=en0 echo.id=53048 echo.seq=1 rtt=8.997034ms
error="write ip6 ::->2404:6800:4004:812::2011: sendmsg: no route to host"
56 bytes tc=0x0 hops=51 from=nrt13s35-in-f177.1e100.net. (216.58.220.177) to=blah.lan. (192.168.86.23) if=en0 echo.id=53048 echo.seq=2 rtt=13.278403ms
error="write ip6 ::->2404:6800:4004:812::2011: sendmsg: no route to host"
56 bytes tc=0x0 hops=51 from=nrt13s35-in-f177.1e100.net. (216.58.220.177) to=blah.lan. (192.168.86.23) if=en0 echo.id=53048 echo.seq=3 rtt=18.912692ms

Statistical information for golang.org:
nrt13s35-in-f177.1e100.net. (216.58.220.177): loss=0.0% rcvd=3 sent=3 op.err=0 icmp.err=0 min=8.997034ms avg=13.729376ms max=18.912692ms stddev=4.060592ms
nrt13s35-in-x11.1e100.net. (2404:6800:4004:812::2011): loss=100.0% rcvd=0 sent=3 op.err=3 icmp.err=0 min=0 avg=0 max=0 stddev=0

Discover an IP-layer path

RT (Route Tracing) transmits probe packets and discovers a route to the destination by determining received ICMP error messages from nodes along the route. The probe packets can be carried by either UDP or ICMP.

Usage: ipoam rt|pathdisc|traceroute [flags] destination

Destination:

A hostname, DNS reg-name or IP address.

Flags:

-4	Run IPv4 test only
-6	Run IPv6 test only
-count int
	Per-hop probe count (default 3)
-hops int
	Maximum IPv4 TTL or IPv6 hop-limit (default 30)
-if string
	Outbound interface name
-m	Use ICMP for probe packets instead of UDP
-n	Don't use DNS reverse lookup
-pldlen int
	Probe packet payload length (default 56)
-port int
	Base destination port number, range will be [port, port+hops) (default 33434)
-src string
	Source IP address
-tc int
	IPv4 TOS or IPv6 traffic-class on probe packets
-v	Show verbose information
-wait int
	Seconds between transmitting each probe (default 1)

A sample output:

% sudo ipoam rt -v go.googlesource.com
Path discovery for go.googlesource.com: 30 hops max, 3 per-hop probes, 56 bytes payload
Warning: go.googlesource.com has multiple addresses, using 74.125.204.82
  1  onhub.here. (192.168.86.1) tc=0xc0 hops=64 to=192.168.86.21 if=en0  2.695846ms  1.688351ms  1.693493ms
(snip)
 10  64.233.175.216 tc=0x0 hops=244 to=192.168.86.21 if=en0 <label=313981 tc=0x4 s=true ttl=1>  16.56388ms
     209.85.243.141 tc=0x0 hops=242 to=192.168.86.21 if=en0 <label=333837 tc=0x4 s=true ttl=1>  12.942727ms
     216.239.58.125 tc=0x0 hops=244 to=192.168.86.21 if=en0 <label=28780 tc=0x4 s=true ttl=1>  13.788517ms
 11  72.14.233.137 tc=0x0 hops=243 to=192.168.86.21 if=en0 <label=453893 tc=0x4 s=true ttl=1>  59.242244ms
     72.14.235.147 tc=0x0 hops=243 to=192.168.86.21 if=en0 <label=506193 tc=0x4 s=true ttl=1>  54.463109ms
     209.85.249.53 tc=0x0 hops=243 to=192.168.86.21 if=en0 <label=28468 tc=0x4 s=true ttl=1>  53.522524ms
 12  209.85.247.57 tc=0x0 hops=242 to=192.168.86.21 if=en0  42.756837ms
     209.85.248.241 tc=0x0 hops=242 to=192.168.86.21 if=en0  46.520701ms
     209.85.249.95 tc=0x0 hops=244 to=192.168.86.21 if=en0  43.928487ms
 13  *  1.004972957s  1.003680805s  1.003223922s
 14  *  1.001087842s  1.004097867s  1.004458466s
 15  *  1.003139488s  1.002801011s  1.003656251s
 16  *  1.001378876s  1.002778971s  1.001974821s
 17  *  1.004971673s  1.004954549s  1.003209327s
 18  *  1.000706913s  1.001947528s  1.000282281s
 19  *  1.003725125s  1.000022246s  1.001842931s
 20  *  1.003906987s  1.001953641s  1.000027483s
 21  ti-in-f82.1e100.net. (74.125.204.82) tc=0x0 hops=42 to=192.168.86.21 if=en0  47.809163ms  66.017916ms  43.068939ms

Show network facility information

Show displays network facility information.

Usage: ipoam sh|show|list [flags] int|interfaces [interface name]

Flags:

-4	Show IPv4 information only
-6	Show IPv6 information only
-b	Show brief information

A sample output:

% ipoam sh -b int
Name              Index  Status  Routed      MTU    Hardware address
lo0               1      up      link-local  16384  <nil>
gif0              2      down                1280   <nil>
stf0              3      down                1280   <nil>
en0               4      up                  1500   00:01:02:ab:cd:01
en1               5      up      global      1500   00:01:02:ab:cd:02
fw0               6      up                  4078   00:01:02:03:ab:cd:ef:01
p2p0              7      up                  2304   00:01:02:ab:cd:03