display ip-link

Function

The display ip-link command displays the IP link status and configurations.

Format

display ip-link [ vpn-instance vpn-instance-name ] [ name ip-link-name ] [ verbose ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Indicates the name of a VPN instance.	The VPN instance must be manually created using the ip vpn-instance command. It cannot be the VPN instance automatically created when the virtual system is created.
name ip-link-name	Displays the information of a specified IP-Link.	The specified value must be the name of a created IP-Link.
verbose	Displays the verbose information of an IP-Link.	-

Views

All views

Default Level

2: Configuration level

Usage Guidelines

Configuration Impact

Running the display ip-link command in the root system displays only IP-Links configured in the root system. To view IP-Links in the virtual system, run the switch vsys command to access the virtual system configuration view and then the display ip-link command to view the IP-Links.

The virtual system does not support vpn-instance vpn-instance-name.

None

Example

# Display information about all IP-Links.

<sysname> display ip-link
Current Total Ip-link Number : 2                                                
Name                            Member   State   Up/Down/Init                   
test1                           1        up      1  0    0    
test2                           1        up      1  0    0

**Table 1** Description of the **display ip-link** command output
Item	Description
Name	Name of an IP-Link.
Member	Number of IP-Link detection links.
State	IP-Link status, which can be: up: The IP-Link is Up. down: The IP-Link is Down. init: The IP-Link is initialized. If this state persists, it is possible that you have not run the ip-link check enable command to enable the IP-Link.
Up/Down/Init	Number of initialized, Down, or Up IP-Link detection links.

# Display detailed information about all IP-Links.

<sysname> display ip-link verbose                                    
Current Total Ip-link Number : 1                                                
 -------------------------------------------------------------------------------
 Name                                         : test                            
 Index                                        : 2                               
 Enable Flag                                  : 1                               
 Vrf                                          : public/0 
 Member Number                                : 2                               
 Source Ip                                    : 10.1.1.1
 Tx-interval (default is 5)                   : 5                               
 Times (default is 3)                         : 3                               
 Least active-linknumber (default is 1)       : 1                               
 State                                        : up                            
 Init State Number                            : 0                               
 DOWN State Number                            : 0                               
 UP State Number                              : 2                               
 -------------------------------------------------------------------------------
  State                                      : up                             
  Destination Type/Destination Info          : IP/1.1.1.1                       
  Protocol/Port                              : icmp/0                           
  Healthcheck detect index                   : 8                                
  State                                      : up                             
  Destination Type/Destination Info          : IP/2.2.2.2                      
  Protocol/Port                              : icmp/0                           
  Out If Index                               : GigabitEthernet0/0/1  
  Healthcheck detect index                   : 9                                
 -------------------------------------------------------------------------------

**Table 2** Description of the **display ip-link verbose** command output
Item	Description
Name	Name of an IP-Link.
Index	Index of an IP-Link.
Enable Flag	Whether the IP-Link detection function is enabled, which can be: 0: The function is disabled and can be enabled using the ip-link check enable command. 1: The function is enabled.
Vrf	Information about IP-Link-bound VPN instance.
Member Number	Number of IP-Link detection links.
Source Ip	Source address for IP-link. You can view the information only by running the source-ip (IP-link view) command.
Tx-interval (default is 5)	Transmission interval of an IP-Link detection packet, which can be modified using the tx-interval command.
Times (default is 3)	Maximum number of times that the transmission of an IP-Link detection packet, which can be adjusted using the times command.
Least active-linknumber (default is 1)	Least active-link number, which can be modified using the least active-linknumber command.
Init State Number	Number of initialized links.
DOWN State Number	Number of links in Down state.
UP State Number	Number of links in Up state.
State	State of an IP-Link.
Destination Type/Destination Info	Destination type and information of a link, which can be: IP/x.x.x.x: Indicates that the destination of the detection is an IP address. DNS/domain-name(x.x.x.x): Indicates that the destination of the detection is a domain name.
Protocol/Port	Destination protocol and port of a link, which can be: icmp/0 icmp6/0 ns/0 arp/0 Port value 0 indicates that the detection packet has no port information.
Out If Index	Outbound interface index, which is displayed only when an outbound interface is specified in destination.
Healthcheck detect index	Healthcheck detect index.