Virtual Router and Routing Information Database


This command displays past changes to the RIB routing table. It was added to assist with troubleshooting and add time-machine-like capability for packet paths.

Syntax   vrouter-rib-history-show

time date/time: yyyy-mm-ddThh:mm:ss

Specifies the time for the statistics.

start-time start-time

Specifies the start time for the statistics display using the

notation yyyy-mm-ddThh:mm:ss.

end-time end-time

Specifies the end time for the statistics display using the

notation yyyy-mm-ddThh:mm:ss.

duration duration: #d#h#m#s

Specify the duration for the traffic statistics.

interval duration: #d#h#m#s

Specifies the time interval for the statistics display.


Specifies if the statistics are collected from the start of the VLAN.

older-than duration: #d#h#m#s

Specifies if the statistics are older than the stated duration.

within-last duration: #d#h#m#s

Specifies the statistics collected within the last duration.

caller init|control|logger|gre-tunnel|flush|user|static-route-init|   fabric-tunnel|router-if|

Specifies the feature that made the change for this entry.

last-caller init|control|logger|gre-tunnel|flush|user|   static-route-init|fabric-tunnel|router-if|vnet-service|l3-check

Specifies the most recent caller for this entry.

reason save|restart|add|modify|remove|
remove-all|inject|evict| router-delete

Specifies the reason for the history entry.

last-reason save|restart|add|modify|remove|
remove-all|inject|evict|    router-delete

Specifies the most recent reason for the entry.

changes vrid|ip|prelen|number-of-nexthops|nexthops-in-hw|ecmp-group| nexthop|egress-id|flags|vlan|intf_ip|intf_id|number-of-tunnels

Specifies the change in the entry.

count count-number

Specifies the count for RIB history.

vrid id

Specifies the virtual router ID.

ip ip-address

Specifies the IP address.

prelen number 

Specifies the prefix length as a value from 0 to 128.

number-of-nexthops number-of-nexthops-number 

Specifies the number of next hops in the route.

nexthops-in-hw nexthops-in-hw-number 

Specifies the number next hops in hardware.

ecmp-group ecmp-group-number 

Specifies the ECMP group number.

nexthop ip-address

Specifies the next hop IP address.

egress-id egress-id-number 

Specifies the egress ID.

flags ECMP|in-hw|in-cache|

Specifies the flags for the routes.

  • ECMP

  • in-hw - stored in hardware

  • cache - stored in the RIB.

  • local-subnet - stored in the local subnet

vlan vlan-id

Specifies the VLAN ID.

intf_ip ip-address

Specifies the interface IP address.

intf_id vrouter-hw-if hw-id

Specifies the router interface.

number-of-tunnels number-of-tunnels-number 

Specifies the number of tunnels dependent on the route.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   Network-admin

History   Command introduced in Version 2.4.1.

Usage   Use this command to display the RIB history.

Examples  To display RIB history, use the following syntax:

CLI network-admin@switch > vrouter-rib-history-show

time:                   15:29:41

caller:                 router-if

reason:                 add

ip:            24

prelen:                 24


flags:                  in-hw,local-subnet

vlan:                   111



time:                   15:29:43

caller:                 router-if

reason:                 add


prelen:                 24


flags:                  in-hw,local-subnet

vlan:                   100


intf_id:                1