display isis spf-tree

Function

The display isis spf-tree command displays the topology of the SPF tree that is generated by IS-IS.

Format

display isis process-id spf-tree [ systemid systemid | dname dname ] [ [ level-1 | level-2 ] | ipv6 | verbose ] ^*

display isis process-id spf-tree statistics [ [ level-1 | level-2 ] | ipv6 ] ^*

display isis spf-tree statistics [ [ level-1 | level-2 ] | ipv6 ] ^* [ process-id | vpn-instance vpn-instance-name ]

Parameters

Parameter	Description	Value
systemid systemid	Displays the SPF tree of the switch with a specified system ID or pseudonode ID.	The value is in XXXX.XXXX.XXXX[.XX] format.
dname dname	Displays the SPF tree of the switch with a specified dynamic name.	The value is a string of 1 to 64 characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.
level-1	Displays Level-1 SPF tree.	-
level-2	Displays Level-2 SPF tree.	-
ipv6	Displays SPF tree in IPv6 topologies.	-
verbose	Displays detailed information about SPF tree.	-
process-id	Display SPF tree in a specified IS-IS process.	The value is an integer that ranges from 1 to 65535.
vpn-instance vpn-instance-name	Displays SPF tree of the IS-IS multi-instance process in a specified VPN instance.	The value must be an existing VPN instance name.
statistics	Displays SPF tree statistics, including information about links and nodes on the SPF tree.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify statistics to view the current status of the SPF tree. The generated SPF tree can be used to calculate routes only when the SPF calculation status is Completed, that is, incremental SPF (ISPF) calculation is complete.

Example

# Display information about the SPF tree.

<HUAWEI> display isis spf-tree

                         Shortest Path Tree for ISIS(1)
                         ------------------------------

         Flags:   T-System is on SPF TREE  R-System is directly reachable
                  O-System is Overload     D-System or Link is to be deleted
                  C-Neighbor is child      P-Neighbor is parent
                  G-Cost gets greater      L-Cost gets lower
                  H-Nexthop is changed     U-Protocol usage is changed
                  V-Link is involved       N-Link is a new path
                  S-Link is IGP Shortcut   *-Relative cost
                       ISIS(1) Level-1 Shortest Path Tree
                       ----------------------------------

 SpfNode           NodeFlags  NeighbourNode     LinkCost   LinkFlags
------------------------------------------------------------------------
------------------------------------------------------------------------
 0000.0000.0001.00 T/-/-/-   >0000.0000.0002.01       10   P/-/-/-/-/-/-
>0000.0000.0002.00 T/-/-/-    0000.0000.0003.01       10   C/-/-/-/-/-/-
                             >0000.0000.0002.01       10   C/-/-/-/-/-/-
                              0000.0000.0004.00      -10*  C/-/-/-/S/-/-
>0000.0000.0002.01 T/R/-/-    0000.0000.0001.00        0   C/-/-/-/-/-/-
                             >0000.0000.0002.00        0   P/-/-/-/-/-/-
 0000.0000.0003.00 T/-/-/-    0000.0000.0004.02       10   C/-/-/-/-/-/-
                              0000.0000.0003.01       10   P/-/-/-/-/-/-
 0000.0000.0003.01 T/R/-/-    0000.0000.0003.00        0   C/-/-/-/-/-/-
                             >0000.0000.0002.00        0   P/-/-/-/-/-/-
 0000.0000.0004.00 T/-/-/-    0000.0000.0004.02       10   P/-/-/-/-/-/-
                              0000.0000.0004.01       10   C/-/-/-/-/-/-
 0000.0000.0004.01 T/-/-/-    0000.0000.0004.00        0   P/-/-/-/-/-/-
                              0000.0000.0005.00        0   C/-/-/-/-/-/-
 0000.0000.0004.02 T/-/-/-    0000.0000.0004.00        0   C/-/-/-/-/-/-
                              0000.0000.0003.00        0   P/-/-/-/-/-/-
 0000.0000.0005.00 T/-/-/-    0000.0000.0004.01       10   P/-/-/-/-/-/-
                       ISIS(1) Level-2 Shortest Path Tree
                       ----------------------------------

 SpfNode           NodeFlags  NeighbourNode     LinkCost   LinkFlags
------------------------------------------------------------------------
------------------------------------------------------------------------
 0000.0000.0001.00 T/-/-/-   >0000.0000.0002.01       10   P/-/-/-/-/-/-
>0000.0000.0002.00 T/-/-/-    0000.0000.0003.01       10   C/-/-/-/-/-/-
                             >0000.0000.0002.01       10   C/-/-/-/-/-/-
                              0000.0000.0004.00      -10*  C/-/-/-/S/-/-
>0000.0000.0002.01 T/R/-/-    0000.0000.0001.00        0   C/-/-/-/-/-/-
                             >0000.0000.0002.00        0   P/-/-/-/-/-/-
 0000.0000.0003.00 T/-/-/-    0000.0000.0004.02       10   C/-/-/-/-/-/-
                              0000.0000.0003.01       10   P/-/-/-/-/-/-
 0000.0000.0003.01 T/R/-/-    0000.0000.0003.00        0   C/-/-/-/-/-/-
                             >0000.0000.0002.00        0   P/-/-/-/-/-/-
 0000.0000.0004.00 T/-/-/-    0000.0000.0004.02       10   P/-/-/-/-/-/-
                              0000.0000.0004.01       10   C/-/-/-/-/-/-
 0000.0000.0004.01 T/-/-/-    0000.0000.0004.00        0   P/-/-/-/-/-/-
                              0000.0000.0005.00        0   C/-/-/-/-/-/-
 0000.0000.0004.02 T/-/-/-    0000.0000.0004.00        0   C/-/-/-/-/-/-
                              0000.0000.0003.00        0   P/-/-/-/-/-/-
 0000.0000.0005.00 T/-/-/-    0000.0000.0004.01       10   P/-/-/-/-/-/-

**Table 1** Description of the display isis spf-tree command output
Item	Description
SpfNode	Node ID in the network topology.
NodeFlags	Node flag: T: The node is on the SPF tree. R: The node is directly reachable. O: The node is overloaded. D: The node is to be deleted.
NeighbourNode	ID of the neighboring node.
LinkCost	Link cost.
LinkFlags	Link flag: C: Neighbor is child P: Neighbor is parent G: Cost gets greater L: Cost gets lower H: Nexthop is changed U: Protocol usage is changed V: Link is involved N: Link is a new path S: Link is IGP Shortcut *: Relative cost
>	Mark of the local node.

# Display detailed information about SPF tree.

<HUAWEI> display isis spf-tree verbose

                         Shortest Path Tree for ISIS(1)                         
                         ------------------------------                         
                                                                                
                       ISIS(1) Level-1 Shortest Path Tree                       
                       ----------------------------------                       
>0000.0000.0001.00                                                              
   Distance            : 0                                                      
   Distance-URT        : 0                                                      
   Flags               : SPT                                                    
   IPv4 Nexthops-URT   : 0                                                      
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:2 Parents:0 Others:0)                                 
             (1)   0000.0000.0002.01                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
             (2)  >0000.0000.0001.01                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
>0000.0000.0001.01                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/Direct/Isolate/V6_Islt                             
   IPv4 Nexthops-URT   : 0                                                      
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0003.00                                            
                     Cost  : 0                                                  
                             C:0 I:vlanif 10                         
                     Flags : Adj/Child                                          
                                                                                
             (2)  >0000.0000.0001.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
 0000.0000.0002.00                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/V6_Islt                                            
   IPv4 Nexthops-URT   : 1                                                      
             (1) 10.1.0.2         IF:vlanif 10  NBR:0000.0000.0002.00            
             (B) 10.0.0.2         IF:vlanif 20  NBR:0000.0000.0003.00            
                                  TYPE:LOOP-FREE  PROTECT:LINK                  
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0002.02                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
             (2)   0000.0000.0002.01                                            
                     Cost  : 10                                                 
                     Flags : Parent                                             
                                                                                
 0000.0000.0002.01                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/Direct/Isolate/V6_Islt                             
   IPv4 Nexthops-URT   : 0                                                      
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0002.00                                            
                     Cost  : 0                                                  
                             C:0 I:vlanif 10                         
                     Flags : Adj/Child                                          
                                                                                
             (2)  >0000.0000.0001.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
 0000.0000.0002.02                                                              
   Distance            : 20                                                     
   Distance-URT        : 20                                                     
   Flags               : SPT/V6_Islt                                            
   IPv4 Nexthops-URT   : 2                                                      
             (1) 10.1.0.2         IF:vlanif 10  NBR:0000.0000.0002.00            
             (2) 10.0.0.2         IF:vlanif 20  NBR:0000.0000.0003.00            
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:0 Parents:2 Others:0)                                 
             (1)   0000.0000.0002.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
             (2)   0000.0000.0003.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
 0000.0000.0003.00                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/V6_Islt                                            
   IPv4 Nexthops-URT   : 1                                                      
             (1) 10.0.0.2         IF:vlanif 10  NBR:0000.0000.0003.00            
             (B) 10.1.0.2         IF:vlanif 20  NBR:0000.0000.0002.00            
                                  TYPE:LOOP-FREE  PROTECT:LINK                  
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0002.02                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
             (2)  >0000.0000.0001.01                                            
                     Cost  : 10                                                 
                     Flags : Parent                                             
                                                                                
                                                                                
                       ISIS(1) Level-2 Shortest Path Tree                       
                       ----------------------------------                       
>0000.0000.0001.00                                                              
   Distance            : 0                                                      
   Distance-URT        : 0                                                      
   Flags               : SPT                                                    
   IPv4 Nexthops-URT   : 0                                                      
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:2 Parents:0 Others:0)                                 
             (1)   0000.0000.0002.01                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
             (2)  >0000.0000.0001.01                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
>0000.0000.0001.01                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/Direct/Isolate/V6_Islt                             
   IPv4 Nexthops-URT   : 0                                                      
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0003.00                                            
                     Cost  : 0                                                  
                             C:0 I:vlanif 10                         
                     Flags : Adj/Child                                          
                                                                                
             (2)  >0000.0000.0001.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
 0000.0000.0002.00                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/V6_Islt                                            
   IPv4 Nexthops-URT   : 1                                                      
             (1) 10.1.0.2         IF:Meth0/0/1  NBR:0000.0000.0002.00            
             (B) 10.0.0.2         IF:vlanif 20  NBR:0000.0000.0003.00            
                                  TYPE:LOOP-FREE  PROTECT:LINK                  
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0002.02                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
             (2)   0000.0000.0002.01                                            
                     Cost  : 10                                                 
                     Flags : Parent                                             
                                                                                
 0000.0000.0002.01                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/Direct/Isolate/V6_Islt                             
   IPv4 Nexthops-URT   : 0                                                      
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0002.00                                            
                     Cost  : 0                                                  
                             C:0 I:vlanif 10                         
                     Flags : Adj/Child                                          
                                                                                
             (2)  >0000.0000.0001.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
 0000.0000.0002.02                                                              
   Distance            : 20                                                     
   Distance-URT        : 20                                                     
   Flags               : SPT/V6_Islt                                            
   IPv4 Nexthops-URT   : 2                                                      
             (1) 10.1.0.2         IF:vlanif 10  NBR:0000.0000.0002.00            
             (2) 10.0.0.2         IF:vlanif 20  NBR:0000.0000.0003.00            
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:0 Parents:2 Others:0)                                 
             (1)   0000.0000.0002.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
             (2)   0000.0000.0003.00                                            
                     Cost  : 0                                                  
                     Flags : Parent                                             
                                                                                
 0000.0000.0003.00                                                              
   Distance            : 10                                                     
   Distance-URT        : 10                                                     
   Flags               : SPT/V6_Islt                                            
   IPv4 Nexthops-URT   : 1                                                      
             (1) 10.0.0.2         IF:vlanif 10  NBR:0000.0000.0003.00            
             (B) 10.1.0.2         IF:vlanif 20  NBR:0000.0000.0002.00            
                                  TYPE:LOOP-FREE  PROTECT:LINK                  
   IPv4 Nexthops-MIGP  : 0                                                      
   IPv6 Nexthops       : 0                                                      
   Neighbors: 2 (Children:1 Parents:1 Others:0)                                 
             (1)   0000.0000.0002.02                                            
                     Cost  : 10                                                 
                     Flags : Child                                              
                                                                                
             (2)  >0000.0000.0001.01                                            
                     Cost  : 10                                                 
                     Flags : Parent

**Table 2** Description of the display isis spf-tree verbose command output
Item	Description
Distance	Cost of the shortest path from the root node to the destination node, excluding the TE tunnel link.
Distance-URT	Cost of the shortest path from the root node to the destination node, including the TE tunnel link.
Flags	Flag: SPT: The node is in the tree. Direct: The node is a direct node. Shortcut: The node is on a shortcut link. Oload: The node is in Overload state. Isolate: The node is not in the tree. MIGP_Islt: The node is not in the MIGP tree. V6_Islt: The node is not in the IPv6 tree. Del: The node will be deleted. Remote: The node is on a tunnel.
IPv4 Nexthops-URT	IPv4 next hop of the node in the unicast routing table.
IPv6 Nexthops	IPv6 next hop of the node in the unicast routing table.
Neighbors	Information about all the neighbors of this node.
Cost	Cost of the link from the root node to this node.
Flags	Relationship with the neighbor: Parent: The neighbor is a parent node. Child: The neighbor is a child node.
IF	Name of the outbound interface.
NBR	System ID of the next hop.
TYPE	Traffic protection type: LOOP-FREE: loop-free protection for the backup next hop
PROTECT	Traffic protection type of IS-IS Auto FRR: NONE: indicates no protection. LINK: indicates link protection. NODE: indicates node protection. LINK-NODE: indicates link and node protection.

# Display the current status statistics of the SPF tree.

<HUAWEI> display isis spf-tree statistics
                   Statistics information of SPT for ISIS(100)
                  -------------------------------------------

                               Level-1 Statistics
                               ------------------
Nodes information:
         Total:                               1
         Count of nodes in SPT:               1
         Count of isolate nodes in SPT:       0
         Count of IPv6 isolate nodes in SPT:  0
         Max Distance of nodes in SPT:        0
Links information:
         Total:                               0
         Count of links from Parent to Son:   0
         Count of links from Son to Parent:   0
         Count of links that just changed:    0
Status of SPF:                                Completed

**Table 3** Description of the display isis spf-tree statistics command output
Item	Description
Total (Nodes information)	Total number of nodes.
Count of nodes in SPT	Number of nodes in the SPT tree.
Count of isolate nodes in SPT	Number of isolated nodes in the network topology.
Count of IPv6 isolate nodes in SPT	Number of isolated IPv6 nodes in the network topology.
Max Distance of nodes in SPT	Maximum distance from the root node to the leaf node.
Total (Links information)	Total number of links.
Count of links from Parent to Son	Number of links from the parent node to the child node.
Count of links from Son to Parent	Number of links from the child node to the parent node.
Count of links that just changed	Number of links that just changed.
Status of SPF	Status of SPF calculation: Completed: indicates that SPF calculation is complete. Scheduled: indicates that SPF calculation is triggered but does not start. Running: indicates that SPF calculation is being performed.