display fib

Function

The display fib command displays information about the forwarding information base (FIB).

Format

display fib [ slot-number ] [ vpn-instance vpn-instance-name ] [ ip-address [ mask | mask-length ] ] [ longer ] [ verbose ]

Parameters

Parameter	Description	Value
slot-number	Specifies a slot ID. The value range varies with different device hardware.	-
vpn-instance vpn-instance-name	Specifies the VPN instance name.	The value is a case-sensitive string of 1 to 31 characters.
ip-address	Specifies the IP address.	The value is in dotted decimal notation.
mask	Specifies the subnet mask.	The value is in dotted decimal notation.
mask-length	Specifies the mask length.	The value is an integer ranging from 0 to 32.
longer	Displays the FIB table matching the specified condition only.	-
verbose	Displays detailed FIB information.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

display fib [ slot-number ] | begin regular-expression: displays all lines from the line that contains the regular-expression to the end line of the cache.

display fib [ slot-number ] | exclude regular-expression: displays all lines that do not contain the regular-expression.

display fib [ slot-number ] | include regular-expression: displays all lines that contain the regular-expression.

display fib: displays the forwarding information in a list, in which each line represents one route.

display fib verbose: displays detailed information on the FIB.

Example

# Display the summary of the forwarding information base.

<sysname> display fib
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
             L - Vlink Route  
------------------------------------------------------------------------------  
 FIB Table:                                                                     
 Total number of Routes : 3  

Destination/Mask   Nexthop         Flag  TimeStamp     Interface      TunnelID
10.1.0.0/16        10.1.1.1        U     t[0]          GE0/0/1        0x0
10.2.0.0/16        10.1.1.1        U     t[0]          GE0/0/1        0x0
10.11.0.0/8        10.11.0.1       U     t[0]          InLoop0        0x0

# Display all lines beginning from the line contains 10.1.0.0.

<sysname> display fib | begin 10.1.0.0
Destination/Mask  Nexthop   Flag  TimeStamp  Interface   TunnelID
10.1.0.0/16    10.1.1.1   U     t[0]       GE0/0/1     0x0
10.2.0.0/16        10.1.1.1   U     t[0]       GE0/0/1     0x0
10.11.0.0/8       10.11.0.1 U     t[0]       InLoop0     0x0

# Display all lines that include GE0/0/1.

<sysname> display fib | include GE0/0/1
Destination/Mask  Nexthop   Flag  TimeStamp  Interface  TunnelID
10.1.0.0/16    10.1.1.1   U     t[0]       GE0/0/1    0x0
10.2.0.0/16        10.1.1.1   U     t[0]       GE0/0/1    0x0

# Display all lines that do not include 10.1.0.0.

<sysname> display fib | exclude 10.1.0.0
Destination/Mask  Nexthop   Flag  TimeStamp  Interface  TunnelID
10.2.0.0/16        10.1.1.1   U     t[0]       GE0/0/1     0x0
10.11.0.0/8       10.11.0.1 U     t[0]       InLoop0     0x0

**Table 1** Description of the **display fib** command output
Item	Description
Destination/Mask	Destination address or mask length.
Nexthop	Next hop address.
Flag	Current flag: G: the next hop is a gateway. H: the next hop is a host. U: the route status is Up. S: static routes. D: dynamic routes. B: black hole routes, which means that the next hop is a null interface.
TimeStamp	Time (in seconds) elapsed since the entry was generated.
Interface	Name of an outbound interface to the destination address.
TunnelID	Index of a tunnel that forwards packets. It is used to forward packets between an upstream link and a downstream link. If the value is not 0, packets matching the entry are forwarded along a tunnel. If the value is 0, packets are not forwarded through the tunnel.

# Display detailed FIB information.

<sysname> display fib verbose
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
             L - Vlink Route 
------------------------------------------------------------------------------  
 FIB Table: 
 Total number of Routes : 3                   
            
 Destination: 10.11.0.1           Mask     : 255.255.255.255 
 Nexthop    : 10.11.0.1           OutIf    : InLoopBack0     
 LocalAddr  : 10.11.0.1           LocalMask: 0.0.0.0    
 Flags      : HU                  Age      : 2260sec   
 ATIndex    : 0                   Slot     : 0
 LspFwdFlag : 0                   LspToken : 0x0
 InLabel    : NULL                OriginAs : 0
 BGPNextHop : 0.0.0.0             PeerAs   : 0
 QosInfo    : 0x0                 OriginQos: 0x0
 VlanId     : 0x0                 RefCount : 1
 NexthopBak : 0.0.0.0             OutIfBak : [No Intf]  
 LspTokenBak: 0x0                 InLabBak : NULL        
 LspInLabBak: 0x0                 VlinkBak : NULL    
 PortIndex  : 0xFF000000                      
            
 Destination: 10.11.0.0           Mask     : 255.0.0.0    
 Nexthop    : 10.11.0.1           OutIf    : InLoopBack0    
 LocalAddr  : 10.11.0.1           LocalMask: 0.0.0.0     
 Flags      : U                   Age      : 2260sec    
 ATIndex    : 0                   Slot     : 0
 LspFwdFlag : 0                   LspToken : 0x0
 InLabel    : NULL                OriginAs : 0
 BGPNextHop : 0.0.0.0             PeerAs   : 0
 QosInfo    : 0x0                 OriginQos: 0x0
 VlanId     : 0x0                 RefCount : 1
 NexthopBak : 0.0.0.0             OutIfBak : [No Intf]   
 LspTokenBak: 0x0                 InLabBak : NULL       
 LspInLabBak: 0x0                 VlinkBak : NULL   
 PortIndex  : 0xFF000000                      
            
 Destination: 10.3.0.0            Mask     : 255.255.255.255 
 Nexthop    : 10.11.0.1           OutIf    : InLoopBack0  
 LocalAddr  : 10.11.0.1           LocalMask: 0.0.0.0        
 Flags      : HU                  Age      : 2237sec  
 ATIndex    : 0                   Slot     : 0
 LspFwdFlag : 0                   LspToken : 0x0
 InLabel    : NULL                OriginAs : 0
 BGPNextHop : 0.0.0.0             PeerAs   : 0
 QosInfo    : 0x0                 OriginQos: 0x0
 VlanId     : 0x0                 RefCount : 1
 NexthopBak : 0.0.0.0             OutIfBak : [No Intf]  
 LspTokenBak: 0x0                 InLabBak : NULL   
 LspInLabBak: 0x0                 VlinkBak : NULL  
 PortIndex  : 0xFF000000

**Table 2** Description of the **display fib verbose** command output
Item	Description
Destination	Destination IP address
Mask	Subnet mask
Nexthop	Next hop address
OutIf	Outbound interface name
LocalAddr	Local IP address
LocalMask	Mask of the local IP address
Flags	Current flag: G: the next hop is a gateway. H: the next hop is a host. U: the route status is Up. S: a static route. D: a dynamic route. B: a black hole route, which means that the next hop is a null interface.
Age	Lifetime (in seconds) of a route
ATIndex	Index of a virtual link connecting the local device to the gateway
Slot	Slot number of an outbound interface
LspFwdFlag	Forwarding flag of an LSP
LspToken	Forwarding ID of an LSP
InLabel	Inner label of a VPN LSP
OriginAs	Original AS number
BGPNextHop	Address of the BGP next hop
PeerAs	Neighbor AS number
QosInfo	Quality of service (QoS)
OriginQos	Information on original QoS.
VlanId	VLAN ID.
RefCount	Number of timers an entry is referred.
NexthopBak	Backup next hop address
OutIfBak	Indicates the backup outbound interface
LspTokenBak	Indicates the forwarding ID of the backup LSP
InLabelBak	Backup inner label of a VPN LSP
LspInLabBak	Forwarding ID of the backup LSP carried in the backup inner label of a VPN LSP
VlinkBak	Backup Vlink
PortIndex	Port index