Skip to content

Commit

Permalink
doc: Update VRF documentation metric
Browse files Browse the repository at this point in the history
Two things:

1) Update examples to show usage of metric
2) Discuss reasoning for using such a high metric.

Signed-off-by: Donald Sharp <sharpd@cumulusnetworks.com>
Acked-by: David Ahern <dsa@cumulusnetworks.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
  • Loading branch information
Donald Sharp authored and David S. Miller committed Oct 20, 2017
1 parent 9854d75 commit 17c9188
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions Documentation/networking/vrf.txt
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,12 @@ Setup
ip ru add iif vrf-blue table 10

3. Set the default route for the table (and hence default route for the VRF).
ip route add table 10 unreachable default
ip route add table 10 unreachable default metric 4278198272

This high metric value ensures that the default unreachable route can
be overridden by a routing protocol suite. FRRouting interprets
kernel metrics as a combined admin distance (upper byte) and priority
(lower 3 bytes). Thus the above metric translates to [255/8192].

4. Enslave L3 interfaces to a VRF device.
ip link set dev eth1 master vrf-blue
Expand Down Expand Up @@ -256,7 +261,7 @@ older form without it.

For example:
$ ip route show vrf red
prohibit default
unreachable default metric 4278198272
broadcast 10.2.1.0 dev eth1 proto kernel scope link src 10.2.1.2
10.2.1.0/24 dev eth1 proto kernel scope link src 10.2.1.2
local 10.2.1.2 dev eth1 proto kernel scope host src 10.2.1.2
Expand All @@ -282,7 +287,7 @@ older form without it.
ff00::/8 dev red metric 256 pref medium
ff00::/8 dev eth1 metric 256 pref medium
ff00::/8 dev eth2 metric 256 pref medium

unreachable default dev lo metric 4278198272 error -101 pref medium

8. Route Lookup for a VRF

Expand Down Expand Up @@ -331,7 +336,7 @@ function vrf_create
ip link add ${VRF} type vrf table ${TBID}

if [ "${VRF}" != "mgmt" ]; then
ip route add table ${TBID} unreachable default
ip route add table ${TBID} unreachable default metric 4278198272
fi
ip link set dev ${VRF} up
}
Expand Down

0 comments on commit 17c9188

Please sign in to comment.