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 spf-tree statistics [ [ level-1 | level-2 ] | ipv6 ] ^* [ process-id | vpn-instance vpn-instance-name ]

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

Parameters

Parameter	Description	Value
systemid systemid	Displays the SPF tree of a system ID or a pseudo node ID.	The format is XXXX.XXXX.XXXX[.XX].
dname dname	Displays the SPF tree of the router with the dynamic name.	The value is a string ranging from 1 to 64 without spaces. NOTE: When double quotation marks are used around the string, spaces are allowed in the string.
level-1	Displays the SPF tree of Level-1.	-
level-2	Displays the SPF tree of Level-2.	-
ipv6	Displays the SPF tree of IPv6.	-
verbose	Displays detailed information of the SPF tree.	-
process-id	Displays the SPF tree of the specified IS-IS process.	The value is an integer ranging from 1 to 65535.
vpn-instance vpn-instance-name	Displays SPF tree topology about the multi-instance IS-IS process in the specified VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
statistics	Displays the statistics of the SPF tree, including information about links and nodes in the SPF tree and the current status of the SPF calculation.	-

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, the incremental SPF (ISPF) calculation is complete.

Example

# Display information about the SPF tree.

<sysname> 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 flags T: System is on SPF TREE R: System is directly reachable O: System is Overload D: System or Link is to be deleted
NeighbourNode	Node ID of the neighbor
LinkCost	Cost of the link
LinkFlags	Link flags 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
>	The mark of local node

# Display detailed information about the SPF tree.

<sysname> 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:GigabitEthernet0/0/0                         
                     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) 20.0.0.2         IF:GigabitEthernet0/0/0  NBR:0000.0000.0002.00            
             (B) 10.0.0.2         IF:GigabitEthernet0/0/0  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:GigabitEthernet0/0/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) 20.0.0.2         IF:GigabitEthernet0/0/10  NBR:0000.0000.0002.00            
             (2) 10.0.0.2         IF:GigabitEthernet0/0/10  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:GigabitEthernet0/0/10  NBR:0000.0000.0003.00            
             (B) 20.0.0.2         IF:GigabitEthernet0/0/10  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:GigabitEthernet0/0/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) 20.0.0.2         IF:GigabitEthernet0/0/10  NBR:0000.0000.0002.00            
             (B) 10.0.0.2         IF:GigabitEthernet0/0/10  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:GigabitEthernet0/0/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) 20.0.0.2         IF:GigabitEthernet0/0/10  NBR:0000.0000.0002.00            
             (2) 10.0.0.2         IF:GigabitEthernet0/0/10  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:GigabitEthernet0/0/10  NBR:0000.0000.0003.00            
             (B) 20.0.0.2         IF:GigabitEthernet0/0/10  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	Indicates the cost of the shortest path from the root node to the destination node, not including the TE tunnel link.
Distance-URT	Indicates the cost of the shortest path from the root node to the destination node, including the TE tunnel link.
Flags	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 the 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	Indicates the IPv4 next hop of the node in the unicast routing table.
IPv4 Nexthops-MIGP	Indicates the IPv4 next hop of the node in the Multicast IGP (MIGP) table.
IPv6 Nexthops	Indicates the IPv6 next hop of the node in the unicast routing table.
Neighbors	Indicates information about all the neighbors of this node.
Cost	Indicates the cost of the link from the root node to this node.
Flags	Indicates the relationship with the neighbor: Parent: The neighbor is a parent node. Child: The neighbor is a child node.
IF	Indicates the name of the outbound interface.
NBR	Indicates the system ID of the next hop.
TYPE	Indicates the type of the traffic protection rule: LOOP-FREE: indicates the loop-free protection for the backup next hop.
PROTECT	Indicates the traffic protection type of IS-IS Auto FRR: NONE: indicates no protection. LINK: indicates the link protection. NODE: indicates the node protection. LINK-NODE: indicates the protection for both link and node.

# Display the current status statistics of the SPF tree.

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

                               Level-2 Statistics
                               ------------------
Nodes information:
         Total:                               3605
         Count of nodes in SPT:               3605
         Count of isolate nodes in SPT:       1
         Count of IPv6 isolate nodes in SPT:  3604
         Max Distance of nodes in SPT:        1220
Links information:
         Total:                               14172
         Count of links from Parent to Son:   7085
         Count of links from Son to Parent:   7085
         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 the SPF calculation: Completed: indicates that the SPF calculation is complete. Scheduled: indicates that the SPF calculation is triggered but does not start. Running: indicates that the SPF calculation is being performed.