display ipv6 interface

Function

The display ipv6 interface command displays IPv6 information about an interface.

The display ipv6 interface description command displays brief information on and descriptions of IPv6-related interfaces.

Format

display ipv6 interface [ interface-name | interface-type interface-number ]

display ipv6 interface description [ interface-name | interface-type [ interface-number ] | slot slot-number [ card card-number ] ]

Parameters

Parameter	Description	Value
interface-name	Specifies the interface name. If no interface name is specified, the command displays brief information on and descriptions of all IPv6-related interfaces.	-
interface-type	Specifies the interface type. If no interface type is specified, the command displays brief information on and descriptions of all IPv6-related interfaces.	-
interface-number	Specifies the interface number, which is used with interface-type to identify an interface. If no interface number is specified, the command displays brief information on and descriptions of all IPv6-related interfaces of the specified interface type.	-
slot slot-number	Specifies the slot number. If this parameter is not specified, the command displays brief information and descriptions of all IPv6-related interfaces. In VS mode, this parameter is supported only by the admin VS.	-
card card-number	Specifies the interface subcard number. If no interface subcard number is specified, the command displays brief information on and descriptions of all IPv6-related interfaces on the specified slot. In VS mode, this parameter is supported only by the admin VS.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
interface-mgr	read

Usage Guidelines

Usage Scenario

If an interface is assigned an IPv6 address, run the display ipv6 interface command to view the IPv6 status and configuration on this interface.

To view brief information on and descriptions of IPv6-related interfaces, run the display ipv6 interface description command.

Follow-up Procedure

You can run the display interface description command to view the description of the interface.

You can run the display interface command to view detailed information about the operation and statistics of the interface.

Precautions

Ensure that the designated interfaces are assigned IPv6 addresses; otherwise, you cannot view information on the interfaces.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display brief information on and descriptions of IPv6-related interfaces.

<HUAWEI> display ipv6 interface description
Codes:
      d(dampened),            D(down),                *D(administratively down),
      !D(FIB overload down),  ^D(standby),            l(loopback),
      s(spoofing),            U(up),                  E(E-Trunk down)
------------------------------------------------------------------------------ 
Number of interfaces whose physical status is Up: 2
Number of interfaces whose physical status is Down: 0
Number of interfaces whose protocol status is Up: 2
Number of interfaces whose protocol status is Down: 0

Interface                    Physical  Protocol  Description
Eth0/1/16                     U         U         HUAWEI-LINK1
[IPv6 Address] 2001:DB8:1::1
Eth0/1/20                     U         U         HUAWEI-LINK2
[IPv6 Address] 2001:DB8:2::2

# Display IPv6 information on GigabitEthernet 0/1/0.

<HUAWEI> display ipv6 interface gigabitethernet 0/1/0
GigabitEthernet0/1/0 current state : UP 
IPv6 protocol current state : UP 
IPv6 is enabled, link-local address is FE80::3ABA:1800:324:8801 
  No global unicast address configured
  Joined group address(es):
    FF02::1
    FF02::2
    FF02::1:FF24:8801
  MTU is 1620 bytes 
  ND DAD is enabled, number of DAD attempts: 1
  ND NUD is enabled, number of NUD attempts: 3
  ND NUD interval is 1000 milliseconds
  ND reachable time is 1200000 milliseconds
  ND stale time is 1200 seconds
  ND retransmit interval is 1000 milliseconds
  ND RAs are halted 
  ND Proxy is disabled

**Table 1** Description of the **display ipv6 interface** command output
Item	Description
Number of interfaces whose physical status is Up	Number of interfaces with the physical status of Up.
Number of interfaces whose protocol status is Up	Number of interfaces with the link layer protocol of Up.
Number of interfaces whose physical status is Down	Number of interfaces with the physical status of Down.
Number of interfaces whose protocol status is Down	Number of interfaces with the link layer protocol of Down.
Interface	Name and number of an interface.
Physical	Physical status of an interface.
Protocol	Link layer protocol status of an interface.
Description	Description of an interface. A long interface description is displayed across several rows. For a default situation, no information is displayed in this field.
IPv6 protocol current state	Protocol status of the interface. UP. DOWN.
IPv6 is enabled	The IPv6 capability is configured on the interface.
IPv6 Address	IPv6 address of an interface.
current state	Physical status of the interface. UP. DOWN. Administratively DOWN.
link-local address	Link local address configured for that interface.
Global unicast address(es)	All unicast addresses configured on that interface. If the value is [DUPLICATE], the IPv6 address of the interface conflicts with that of a peer interface. For details about how to address the conflict, see Troubleshooting > IP Forwarding and Routing > IPv6 Forwarding. If the value is [TENTATIVE], IPv6 address detection has not completed. If the value is [BLOCK], an IPv6 address same as this interface address has existed on the device. If the involved ND entry does not exist, the ND entry fails to be created. For details about how to address the issue, see Troubleshooting > IPv6 Address Conflicts Occur on Interfaces > ND Entries Cannot Be Learned.
Joined group address(es)	All multicast addresses that have joined the interface.
MTU	Maximum transmission unit for that interface.
ND NUD interval	Neighbor unreachable detection interval.
ND reachable time	Time period for a neighbor to keep reachable.
ND stale time	Timeout period of the STALE state of ND entries.
ND retransmit interval	Retransmission interval.
ND RAs are halted	RA messages are suppressed.
ND Proxy is disabled	Proxy ND function is not enabled.
number of DAD attempts	Number of conflicting address detection times.
number of NUD attempts	Number of times neighbor unreachable detection.
Codes	Abbreviations of the physical status and link protocol status. Abbreviated physical status of the interface is as follows: U: The physical status of the interface is Up. U(l): The interface is enabled with the loopback function. D: The physical status of the interface is Down. *D: An administrator has run the shutdown command on the interface. !D: The FIB module is in the overload suspension state. The link layer protocol of the interface goes Down. ^D: The interface is in the standby state. E: The Eth-Trunk interface goes Down due to E-Trunk protocol negotiation. Abbreviated link layer protocol status is as follows: U: The status of the link layer protocol on the interface is Up. U(s): The link layer protocol of the interface is Up even though the interface is not assigned an IPv6 address. (s): An inherent attribute of the interface that will be displayed when the interface is assigned an IPv6 address. U(d): The protocol module of the interface is dampened. D: The link layer protocol of the interface is Down or no IPv6 address is assigned to the interface.