display ipv6 interface

Use display ipv6 interface to display IPv6 interface information.

Syntax

display ipv6 interface [ interface-type [ interface-number ] ] [ brief ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type: Specifies an interface by its type.

interface-number: Specifies an interface by its number.

brief: Displays brief IPv6 interface information, including physical status, link-layer protocols, and IPv6 address. If you do not specify the keyword, this command displays detailed IPv6 interface information, including IPv6 configuration and operating information, and IPv6 packet statistics.

Usage guidelines

If you do not specify an interface, this command displays IPv6 information about all interfaces.

If you specify only the interface-type argument, this command displays IPv6 information about the interfaces of the specified type.

If you specify both the interface-type and the interface-number arguments, this command displays IPv6 information about the specified interface.

Examples

# Display IPv6 information about VLAN-interface 2.

<Sysname> display ipv6 interface vlan-interface 2
Vlan-interface2 current state: UP
Line protocol current state: UP
IPv6 is enabled, link-local address is FE80::1234:56FF:FE65:4322 [TENTATIVE]
  Global unicast address(es):
    10::1234:56FF:FE65:4322, subnet is 10::/64 [TENTATIVE] [AUTOCFG]
      [valid lifetime 4641s/preferred lifetime 4637s]
    20::1234:56ff:fe65:4322, subnet is 20::/64 [TENTATIVE] [EUI-64]
    30::1, subnet is 30::/64 [TENTATIVE] [ANYCAST]
    40::2, subnet is 40::/64 [TENTATIVE] [DHCP]
    50::3, subnet is 50::/64 [TENTATIVE]
  Joined group address(es):
    FF02::1
    FF02::2
    FF02::1:FF00:1
    FF02::1:FF65:4322
  MTU is 1500 bytes
  ND DAD is enabled, number of DAD attempts: 1
  ND reachable time is 30000 milliseconds
  ND retransmit interval is 1000 milliseconds
  Hosts use stateless autoconfig for addresses
IPv6 Packet statistics:
  InReceives:                     0
  InTooShorts:                    0
  InTruncatedPkts:               0
  InHopLimitExceeds:             0
  InBadHeaders:                   0
  InBadOptions:                   0
  ReasmReqds:                     0
  ReasmOKs:                       0
  InFragDrops:                    0
  InFragTimeouts:                0
  OutFragFails:                   0
  InUnknownProtos:               0
  InDelivers:                     0
  OutRequests:                    0
  OutForwDatagrams:              0
  InNoRoutes:                     0
  InTooBigErrors:                0
  OutFragOKs:                     0
  OutFragCreates:                0
  InMcastPkts:                   0
  InMcastNotMembers:            0
  OutMcastPkts:                  0
  InAddrErrors:                  0
  InDiscards:                    0
  OutDiscards:                   0

Table 44: Command output

Field	Description
Vlan-interface2 current state	Physical state of the interface: Administratively DOWN—The interface has been administratively shut down by using the shutdown command. DOWN—The interface is administratively up but its physical state is down, possibly because of a connection or link failure. UP—The administrative and physical states of the interface are both up.
Line protocol current state	Link layer state of the interface: DOWN—The link layer protocol state of the interface is down. UP—The link layer protocol state of the interface is up.
IPv6 is enabled	IPv6 is enabled on the interface. This feature is automatically enabled after an IPv6 address is configured for an interface.
link-local address	Link-local address of the interface.
Global unicast address(es)	Global unicast addresses of the interface. IPv6 address states: TENTATIVE—Initial state. DAD is being performed or is to be performed on the address. DUPLICATE—The address is not unique on the link. PREFERRED—The address is preferred and can be used as the source or destination address of a packet. If an address is in this state, the command does not display the address state. DEPRECATED—The address is beyond the preferred lifetime but in the valid lifetime. It is valid, but it cannot be used as the source address for a new connection. Packets destined for the address are processed correctly. If a global unicast address is not manually configured, the following notations indicate how the address is obtained: AUTOCFG—Stateless autoconfigured. DHCP—Assigned by a DHCPv6 server. EUI-64—Manually configured EUI-64 IPv6 address. RANDOM—Random address automatically generated. If the address is a manually configured anycast address, it is noted with ANYCAST.
valid lifetime	Specifies how long autoconfigured global unicast addresses using a prefix are valid.
preferred lifetime	Specifies how long autoconfigured global unicast addresses using a prefix are preferred.
Joined group address(es)	Addresses of the multicast groups that the interface has joined.
MTU	MTU of the interface.
ND DAD is enabled, number of DAD attempts	DAD is enabled. If DAD is enabled, this field displays the number of attempts to send an NS message for DAD (set by using the ipv6 nd dad attempts command). If DAD is disabled, this field displays ND DAD is disabled. To disable DAD, set the number of attempts to 0.
ND reachable time	Time during which a neighboring device is reachable.
ND retransmit interval	Interval for retransmitting an NS message.
Hosts use stateless autoconfig for addresses	Hosts obtained IPv6 addresses through stateless autoconfiguration.
InReceives	Received IPv6 packets, including error messages.
InTooShorts	Received IPv6 packets that are too short. For example, the received IPv6 packet is less than 40 bytes.
InTruncatedPkts	Received IPv6 packets with a length less than the payload length field specified in the packet header.
InHopLimitExceeds	Received IPv6 packets with a hop count exceeding the hop limit field specified in the packet header.
InBadHeaders	Received IPv6 packets with incorrect basic headers.
InBadOptions	Received IPv6 packets with incorrect extension headers.
ReasmReqds	Received IPv6 fragments.
ReasmOKs	Number of reassembled IPv6 packets.
InFragDrops	Received IPv6 fragments that are discarded because of certain errors.
InFragTimeouts	Received IPv6 fragments that are discarded because the amount of time they stay in the system buffer exceeds the specified interval.
OutFragFails	IPv6 packets that fail to be fragmented on the output interface.
InUnknownProtos	Received IPv6 packets with unknown or unsupported protocol type.
InDelivers	Received IPv6 packets that are delivered to user protocols (such as ICMPv6, TCP, and UDP).
OutRequests	Local IPv6 packets sent by IPv6 user protocols.
OutForwDatagrams	IPv6 packets forwarded by the interface.
InNoRoutes	Received IPv6 packets that are discarded because no matching route can be found.
InTooBigErrors	Received IPv6 packets that fail to be forwarded because they exceeded the Path MTU.
OutFragOKs	Fragmented IPv6 packets on the output interface.
OutFragCreates	Number of IPv6 fragments on the output interface.
InMcastPkts	Received IPv6 multicast packets.
InMcastNotMembers	Received IPv6 multicast packets that are discarded because the interface is not in the multicast group.
OutMcastPkts	IPv6 multicast packets sent by the interface.
InAddrErrors	Received IPv6 packets that are discarded due to invalid destination addresses.
InDiscards	Received IPv6 packets that are discarded due to resource problems rather than packet errors.
OutDiscards	IPv6 packets that fail to be sent due to resource problems rather than packet errors.

# Display brief IPv6 information about all interfaces.

<Sysname> display ipv6 interface brief
*down: administratively down
(s): spoofing
Interface                                 Physical Protocol IPv6 Address 
Vlan-interface1                          down    down      Unassigned
Vlan-interface2                          up         up     2001::1
Vlan-interface100                        up         up        Unassigned

Table 45: Command output

Field	Description
*down: administratively down	The interface has been administratively shut down by using the shutdown command.
(s): spoofing	Spoofing attribute of the interface. The link protocol state of the interface is up, but the link is temporarily established on demand or does not exist.
Interface	Name of the interface.
Physical	Physical state of the interface: down—The interface has been administratively shut down by using the shutdown* command. down—The interface is administratively up but its physical state is down, possibly because of a connection or link failure. up—The administrative and physical states of the interface are both up.
Protocol	Link layer protocol state of the interface: down—The network layer protocol state of the interface is down. up—The network layer protocol state of the interface is up.
IPv6 Address	IPv6 address of the interface. If multiple global unicast addresses are configured, this field displays the lowest address. If no global unicast address is configured, this field displays the link-local address. If no address is configured, this field displays Unassigned.

prev	up	next
display ipv6 icmp statistics	home	display ipv6 interface prefix