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

Parameters

interface-type: Interface type.

interface-number: Interface number.

brief: Displays brief information.

Usage guidelines

If you specify the brief keyword, this command displays brief information including physical status, link-layer protocols, and IPv6 address.

If you do not specify the brief keyword, this command displays detailed information including IPv6 configuration and operating information, and IPv6 packet statistics.

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 41: Command output

Field

Description

Vlan-interface2 current state

Physical state of the interface:

  • Administratively DOWN—The VLAN interface has been administratively shut down by using the shutdown command.

  • DOWN—The VLAN interface is administratively up but its physical state is down because all ports in the VLAN are down.

  • UP—The administrative and physical states of the VLAN interface are both up.

Line protocol current state

Link layer protocol state of the interface:

  • DOWN—The link layer protocol state of the VLAN interface is down.

  • UP—The link layer protocol state of the VLAN interface is up.

IPv6 is enabled

IPv6 is enabled on the interface. This function 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 to the address are processed correctly.

If a global unicast address is not manually configured, the following indicates 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, ANYCAST is marked.

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 multicast groups that the interface has joined.

MTU

Maximum transmission unit (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 a 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

All IPv6 packets received by the interface, including error packets.

InTooShorts

Received IPv6 packets that are too short, with a length less than 40 bytes, for example.

InTruncatedPkts

Received IPv6 packets with a length less than that specified in the packets.

InHopLimitExceeds

Received IPv6 packets with a hop count exceeding the limit.

InBadHeaders

Received IPv6 packets with incorrect basic headers.

InBadOptions

Received IPv6 packets with incorrect extension headers.

ReasmReqds

Received IPv6 fragments.

ReasmOKs

Number of reassembled packets rather than the number of fragments.

InFragDrops

IPv6 fragments that are discarded because of certain errors.

InFragTimeouts

IPv6 fragments that are discarded because the amount of time they stayed in the system buffer exceeded the specified interval.

OutFragFails

Packets that failed 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 application layer protocols (such as ICMPv6, TCP, and UDP).

OutRequests

Local IPv6 packets sent by IPv6 application protocols.

OutForwDatagrams

Packets forwarded by the output interface.

InNoRoutes

Received IPv6 packets that are discarded because no matched route can be found.

InTooBigErrors

Received IPv6 packets that are discarded because they exceeded the Path MTU.

OutFragOKs

Fragmented packets on the output interface.

OutFragCreates

Number of fragmented packets on the output interface.

InMcastPkts

Received IPv6 multicast packets on the interface.

InMcastNotMembers

IPv6 multicast packets that are discarded because the interface did not join in the corresponding multicast group.

OutMcastPkts

IPv6 multicast packets sent by the interface.

InAddrErrors

IPv6 packets that are discarded due to invalid destination addresses.

InDiscards

IPv6 packets that are discarded due to resource problems rather than packet content 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 42: 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 shut down by using the shutdown command.

  • down—The interface is up but its physical state is down because all ports in the VLAN are down.

  • 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 at least one global unicast address is 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.