5 .. note:: For a complete list of CLI Debug commands refer to the Debug CLI section of the `Source Code Documents <https://docs.fd.io/vpp/18.07/clicmd.html>`_ .
\r
13 `ip route [add|del] [count <*n*>] <*dst-ip-addr*>/<*width*> [table <*table-id*>] via [next-hop-address[next-hop-interface] [next-hop-table <*value*>] [weight <*value*>] [preference <*value*>] [udp-encap-id <*value*>] [ip4-lookup-in-table <*value*>] [ip6-lookup-in-table <*value*>] [mpls-lookup-in-table <*value*>] [resolve-via-host] [resolve-via-connected] [rx-ip4 <*interface*>] [out-labels <*value value value*>]`
\r
18 This command is used to add or delete IPv4 or IPv6 routes. All IP Addresses
\r
19 ('<*dst-ip-addr*>/<*width*>', '<*next-hop-ip-addr*>' and '<*adj-hop-ip-addr*>') can be IPv4 or IPv6,
\r
20 but all must be of the same form in a single command. To display the current set of routes,
\r
21 use the commands 'show ip fib' and 'show ip6 fib'.
\r
26 Example of how to add a straight forward static route:
\r
28 .. code-block:: console
\r
30 vpp# ip route add 6.0.1.2/32 via 6.0.0.1 GigabitEthernet2/0/0
\r
32 Example of how to delete a straight forward static route:
\r
34 .. code-block:: console
\r
36 vpp# ip route del 6.0.1.2/32 via 6.0.0.1 GigabitEthernet2/0/0
\r
38 Mainly for route add/del performance testing, one can add or delete multiple routes by adding
\r
39 'count N' to the previous item:
\r
41 .. code-block:: console
\r
43 vpp# ip route add count 10 7.0.0.0/24 via 6.0.0.1 GigabitEthernet2/0/0
\r
45 Add multiple routes for the same destination to create equal-cost multipath:
\r
47 .. code-block:: console
\r
49 vpp# ip route add 7.0.0.1/32 via 6.0.0.1 GigabitEthernet2/0/0
\r
51 vpp# ip route add 7.0.0.1/32 via 6.0.0.2 GigabitEthernet2/0/0
\r
53 For unequal-cost multipath, specify the desired weights. This combination of weights
\r
54 results in 3/4 of the traffic following the second path, 1/4 following the first path:
\r
56 .. code-block:: console
\r
58 vpp# ip route add 7.0.0.1/32 via 6.0.0.1 GigabitEthernet2/0/0 weight 1
\r
60 vpp# ip route add 7.0.0.1/32 via 6.0.0.2 GigabitEthernet2/0/0 weight 3
\r
62 To add a route to a particular FIB table (VRF), use:
\r
64 .. code-block:: console
\r
66 vpp# ip route add 172.16.24.0/24 table 7 via GigabitEthernet2/0/0
\r
68 Declaration and Implementation
\r
69 ---------------------------------
\r
71 **Declaration:** ip_route_command (src/vnet/ip/lookup.c line 641)
\r
73 **Implementation:** vnet_ip_route_cmd
\r
81 ping {<*ip-addr*> | ipv4 <*ip4-addr*> | ipv6 <*ip6-addr*>} [ipv4 <*ip4-addr*> | ipv6 <*ip6-addr*>] [source <*interface*>] [size <*pktsize*>] [interval <*sec*>] [repeat <*cnt*>] [table-id <*id*>] [verbose]
\r
86 This command sends an ICMP ECHO_REQUEST to network hosts. The address can be an IPv4 or IPv6
\r
87 address (or both at the same time).
\r
92 Example of how ping an IPv4 address:
\r
94 .. code-block:: console
\r
96 vpp# ping 172.16.1.2 source GigabitEthernet2/0/0 repeat 2
\r
98 64 bytes from 172.16.1.2: icmp_seq=1 ttl=64 time=.1090 ms
\r
99 64 bytes from 172.16.1.2: icmp_seq=2 ttl=64 time=.0914 ms
\r
101 Statistics: 2 sent, 2 received, 0% packet loss
\r
103 Example of how ping both an IPv4 address and IPv6 address at the same time:
\r
105 vpp# ping 172.16.1.2 ipv6 fe80::24a5:f6ff:fe9c:3a36 source GigabitEthernet2/0/0 repeat 2 verbose
\r
107 Adjacency index: 10, sw_if_index: 1
\r
108 Adj: ip6-discover-neighbor
\r
110 Forced set interface: 1
\r
111 Adjacency index: 0, sw_if_index: 4294967295
\r
114 Forced set interface: 1
\r
115 Source address: 172.16.1.1
\r
116 64 bytes from 172.16.1.2: icmp_seq=1 ttl=64 time=.1899 ms
\r
117 Adjacency index: 10, sw_if_index: 1
\r
118 Adj: ip6-discover-neighbor
\r
120 Forced set interface: 1
\r
121 Adjacency index: 0, sw_if_index: 4294967295
\r
124 Forced set interface: 1
\r
125 Source address: 172.16.1.1
\r
126 64 bytes from 172.16.1.2: icmp_seq=2 ttl=64 time=.0910 ms
\r
128 Statistics: 4 sent, 2 received, 50% packet loss
\r
130 Declaration and Implementation
\r
131 -------------------------------
\r
133 Declaration: ping_command (src/vnet/ip/ping.c line 899)
\r
135 Implementation: ping_ip_address
\r
137 Set Interface IP Address
\r
138 =========================
\r
140 `Set Interface IP Address <../interface/setinterface.html#set-interface-ip-address>`_
\r
145 `Show IP-Arp <../show/show.html#show-ip-arp>`_
\r
151 `Show IP-Fib <../show/show.html#show-ip-fib>`_
\r