FD.io VPP  v17.07.01-10-g3be13f0
Vector Packet Processing
src/vnet/fib

clear fib walk

Summary/usage

clear fib walk.

Declaration and implementation

Declaration: fib_walk_clear_command (src/vnet/fib/fib_walk.c line 1157)

Implementation: fib_walk_clear.

set fib walk histogram elements size

Summary/usage

set fib walk histogram elements size.

Declaration and implementation

Declaration: fib_walk_set_histogram_elements_size_command (src/vnet/fib/fib_walk.c line 1137)

Implementation: fib_walk_set_histogram_elements_size.

set fib walk quota

Summary/usage

set fib walk quota.

Declaration and implementation

Declaration: fib_walk_set_quota_command (src/vnet/fib/fib_walk.c line 1111)

Implementation: fib_walk_set_quota.

show fib entry

Summary/usage

show fib entry.

Declaration and implementation

Declaration: show_fib_entry (src/vnet/fib/fib_entry.c line 1599)

Implementation: show_fib_entry_command.

show fib memory

Summary/usage

show fib memory.

Description

The 'sh fib memory ' command displays the memory usage for each FIB object type.

Example usage
vpp# show fib memory
FIB memory
            Name               Size  in-use /allocated   totals
            Entry              120     11   /    11      1320/1320
        Entry Source            32     11   /    11      352/352
    Entry Path-Extensions       44      0   /    0       0/0
          Path-list             40     11   /    11      440/440
            Path                88     11   /    11      968/968
     Node-list elements         20     11   /    11      220/220
       Node-list heads          8      13   /    13      104/104

Declaration and implementation

Declaration: show_fib_memory (src/vnet/fib/fib_node.c line 272)

Implementation: fib_memory_show.

show fib path-lists

Summary/usage

show fib path-lists.

Declaration and implementation

Declaration: show_fib_path_list (src/vnet/fib/fib_path_list.c line 1366)

Implementation: show_fib_path_list_command.

show fib paths

Summary/usage

show fib paths.

Declaration and implementation

Declaration: show_fib_path (src/vnet/fib/fib_path.c line 2203)

Implementation: show_fib_path_command.

show fib uRPF

Summary/usage

show fib uRPF.

Description

The 'sh fib uRPF [index] ' command displays the uRPF lists

Example usage
vpp# show fib uRPF
FIB uRPF Entries:
 0-list:0 len:0 itfs:[]
 1-list:1 len:2 itfs:[1, 2, ]
 2-list:2 len:1 itfs:[3, ]
 3-list:3 len:1 itfs:[9, ]

Declaration and implementation

Declaration: show_fib_urpf_list (src/vnet/fib/fib_urpf_list.c line 263)

Implementation: show_fib_urpf_list_command.

show fib walk

Summary/usage

show fib walk.

Declaration and implementation

Declaration: fib_walk_show_command (src/vnet/fib/fib_walk.c line 1085)

Implementation: fib_walk_show.

show ip fib

Summary/usage

show ip fib [summary] [table <table-id>] [index <fib-id>] [<ip4-addr>[/<mask>]] [mtrie] [detail].

Description

This command displays the IPv4 FIB Tables (VRF Tables) and the route entries for each table.

Note
This command will run for a long time when the FIB tables are comprised of millions of entries. For those senarios, consider displaying a single table or summary mode.
Example usage
Example of how to display all the IPv4 FIB tables: 
vpp# show ip fib
ipv4-VRF:0, fib_index 0, flow hash: src dst sport dport proto
0.0.0.0/0
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:0 buckets:1 uRPF:0 to:[0:0]]
    [0] [@0]: dpo-drop ip6
0.0.0.0/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:1 buckets:1 uRPF:1 to:[0:0]]
    [0] [@0]: dpo-drop ip6
6.0.1.2/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:30 buckets:1 uRPF:29 to:[0:0]]
    [0] [@3]: arp-ipv4: via 6.0.0.1 af_packet0
7.0.0.1/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:31 buckets:4 uRPF:30 to:[0:0]]
    [0] [@3]: arp-ipv4: via 6.0.0.2 af_packet0
    [1] [@3]: arp-ipv4: via 6.0.0.2 af_packet0
    [2] [@3]: arp-ipv4: via 6.0.0.2 af_packet0
    [3] [@3]: arp-ipv4: via 6.0.0.1 af_packet0
224.0.0.0/8
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:3 buckets:1 uRPF:3 to:[0:0]]
    [0] [@0]: dpo-drop ip6
240.0.0.0/8
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:2 buckets:1 uRPF:2 to:[0:0]]
    [0] [@0]: dpo-drop ip6
255.255.255.255/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:4 buckets:1 uRPF:4 to:[0:0]]
    [0] [@0]: dpo-drop ip6
ipv4-VRF:7, fib_index 1, flow hash: src dst sport dport proto
0.0.0.0/0
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:12 buckets:1 uRPF:11 to:[0:0]]
    [0] [@0]: dpo-drop ip6
0.0.0.0/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:13 buckets:1 uRPF:12 to:[0:0]]
    [0] [@0]: dpo-drop ip6
172.16.1.0/24
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:17 buckets:1 uRPF:16 to:[0:0]]
    [0] [@4]: ipv4-glean: af_packet0
172.16.1.1/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:18 buckets:1 uRPF:17 to:[1:84]]
    [0] [@2]: dpo-receive: 172.16.1.1 on af_packet0
172.16.1.2/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:21 buckets:1 uRPF:20 to:[0:0]]
    [0] [@5]: ipv4 via 172.16.1.2 af_packet0: IP4: 02:fe:9e:70:7a:2b -> 26:a5:f6:9c:3a:36
172.16.2.0/24
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:19 buckets:1 uRPF:18 to:[0:0]]
    [0] [@4]: ipv4-glean: af_packet1
172.16.2.1/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:20 buckets:1 uRPF:19 to:[0:0]]
    [0] [@2]: dpo-receive: 172.16.2.1 on af_packet1
224.0.0.0/8
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:15 buckets:1 uRPF:14 to:[0:0]]
    [0] [@0]: dpo-drop ip6
240.0.0.0/8
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:14 buckets:1 uRPF:13 to:[0:0]]
    [0] [@0]: dpo-drop ip6
255.255.255.255/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:16 buckets:1 uRPF:15 to:[0:0]]
    [0] [@0]: dpo-drop ip6
Example of how to display a single IPv4 FIB table: 
vpp# show ip fib table 7
ipv4-VRF:7, fib_index 1, flow hash: src dst sport dport proto
0.0.0.0/0
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:12 buckets:1 uRPF:11 to:[0:0]]
    [0] [@0]: dpo-drop ip6
0.0.0.0/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:13 buckets:1 uRPF:12 to:[0:0]]
    [0] [@0]: dpo-drop ip6
172.16.1.0/24
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:17 buckets:1 uRPF:16 to:[0:0]]
    [0] [@4]: ipv4-glean: af_packet0
172.16.1.1/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:18 buckets:1 uRPF:17 to:[1:84]]
    [0] [@2]: dpo-receive: 172.16.1.1 on af_packet0
172.16.1.2/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:21 buckets:1 uRPF:20 to:[0:0]]
    [0] [@5]: ipv4 via 172.16.1.2 af_packet0: IP4: 02:fe:9e:70:7a:2b -> 26:a5:f6:9c:3a:36
172.16.2.0/24
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:19 buckets:1 uRPF:18 to:[0:0]]
    [0] [@4]: ipv4-glean: af_packet1
172.16.2.1/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:20 buckets:1 uRPF:19 to:[0:0]]
    [0] [@2]: dpo-receive: 172.16.2.1 on af_packet1
224.0.0.0/8
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:15 buckets:1 uRPF:14 to:[0:0]]
    [0] [@0]: dpo-drop ip6
240.0.0.0/8
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:14 buckets:1 uRPF:13 to:[0:0]]
    [0] [@0]: dpo-drop ip6
255.255.255.255/32
  unicast-ip4-chain
  [@0]: dpo-load-balance: [index:16 buckets:1 uRPF:15 to:[0:0]]
    [0] [@0]: dpo-drop ip6
Example of how to display a summary of all IPv4 FIB tables: 
vpp# show ip fib summary
ipv4-VRF:0, fib_index 0, flow hash: src dst sport dport proto
    Prefix length         Count
                   0               1
                   8               2
                  32               4
ipv4-VRF:7, fib_index 1, flow hash: src dst sport dport proto
    Prefix length         Count
                   0               1
                   8               2
                  24               2
                  32               4

Declaration and implementation

Declaration: ip4_show_fib_command (src/vnet/fib/ip4_fib.c line 718)

Implementation: ip4_show_fib.

show ip6 fib

Summary/usage

show ip6 fib [summary] [table <table-id>] [index <fib-id>] [<ip6-addr>[/<width>]] [detail].

Description

This command displays the IPv6 FIB Tables (VRF Tables) and the route entries for each table.

Note
This command will run for a long time when the FIB tables are comprised of millions of entries. For those senarios, consider displaying in summary mode.
Example usage

Example of how to display all the IPv6 FIB tables: 

vpp# show ip6 fib

ipv6-VRF:0, fib_index 0, flow hash: src dst sport dport proto
::/0
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:5 buckets:1 uRPF:5 to:[0:0]]
    [0] [@0]: dpo-drop ip6
fe80::/10
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:10 buckets:1 uRPF:10 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::1/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:8 buckets:1 uRPF:8 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::2/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:7 buckets:1 uRPF:7 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::16/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:9 buckets:1 uRPF:9 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::1:ff00:0/104
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:6 buckets:1 uRPF:6 to:[0:0]]
    [0] [@2]: dpo-receive
ipv6-VRF:8, fib_index 1, flow hash: src dst sport dport proto
::/0
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:21 buckets:1 uRPF:20 to:[0:0]]
    [0] [@0]: dpo-drop ip6
::a:1:1:0:4/126
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:27 buckets:1 uRPF:26 to:[0:0]]
    [0] [@4]: ipv6-glean: af_packet0
::a:1:1:0:7/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:28 buckets:1 uRPF:27 to:[0:0]]
    [0] [@2]: dpo-receive: ::a:1:1:0:7 on af_packet0
fe80::/10
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:26 buckets:1 uRPF:25 to:[0:0]]
    [0] [@2]: dpo-receive
fe80::fe:3eff:fe3e:9222/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:29 buckets:1 uRPF:28 to:[0:0]]
    [0] [@2]: dpo-receive: fe80::fe:3eff:fe3e:9222 on af_packet0
ff02::1/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:24 buckets:1 uRPF:23 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::2/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:23 buckets:1 uRPF:22 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::16/128
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:25 buckets:1 uRPF:24 to:[0:0]]
    [0] [@2]: dpo-receive
ff02::1:ff00:0/104
  unicast-ip6-chain
  [@0]: dpo-load-balance: [index:22 buckets:1 uRPF:21 to:[0:0]]
    [0] [@2]: dpo-receive

Example of how to display a summary of all IPv6 FIB tables: 

vpp# show ip6 fib summary

ipv6-VRF:0, fib_index 0, flow hash: src dst sport dport proto
    Prefix length         Count
         128                3
         104                1
         10                 1
          0                 1
ipv6-VRF:8, fib_index 1, flow hash: src dst sport dport proto
    Prefix length         Count
         128                5
         126                1
         104                1
         10                 1
          0                 1

Declaration and implementation

Declaration: ip6_show_fib_command (src/vnet/fib/ip6_fib.c line 733)

Implementation: ip6_show_fib.

show mpls fib

Summary/usage

show mpls fib [summary] [table <n>].

Declaration and implementation

Declaration: mpls_fib_show_command (src/vnet/fib/mpls_fib.c line 450)

Implementation: mpls_fib_show.

test fib

Summary/usage

fib unit tests - DO NOT RUN ON A LIVE SYSTEM.

Declaration and implementation

Declaration: test_fib_command (src/vnet/fib/fib_test::c line 8241)

Implementation: fib_test.

test fib-walk-process

Summary/usage

test fib-walk-process [enable|disable].

Declaration and implementation

Declaration: fib_walk_process_command (src/vnet/fib/fib_walk.c line 1201)

Implementation: fib_walk_process_enable_disable.