41-IPv6 Management Command

Download


Chapter 1  IPv6 Configuration Commands

1.1  Basic IPv6 Configuration Commands

1.1.1  display dns ipv6 dynamic-host

Syntax

display dns ipv6 dynamic-host

View

Any view

Parameters

None

Description

Use the display dns ipv6 dynamic-host command to display IPv6 dynamic domain name information in the cache, including the domain name, IPv6 address, and TTL of the DNS entries.

You can use the reset dns ipv6 dynamic-host command to clear all IPv6 dynamic domain name information from the cache.

Examples

# Display IPv6 dynamic domain name information in the cache.

<Sysname> display dns ipv6 dynamic-host

No. Domain-name           IPv6 Address                             TTL

1   aaa                   2001::2                                   6

Table 1-1 Description on the fields of the display dns ipv6 dynamic-host command

Field

Description

No.

Sequence number

Domain-name

Domain name

IPv6 Address

IPv6 address of the corresponding domain name

TTL

Time-to-live of the domain name in the cache in seconds

 

&  Note:

When you use the display dns ipv6 dynamic-host command to check the IPv6 dynamic domain names in the cache, the system will display the first 21 characters of the domain names if they contain more than 21 characters. This is because the domain name displayed in the Domain-name field can be up to 21 characters in length.

 

1.1.2  display ipv6 fib

Syntax

display ipv6 fib

View

Any view

Parameters

None

Description

Use the display ipv6 fib command to display all the IPv6 FIB entries.

The switch looks up a matching IPv6 FIB entry for forwarding an IPv6 packet.

Examples

# Display all the IPv6 FIB entries.

<Sysname> display ipv6 fib

FIB Table:

 Total number of Routes : 5

 Flag:

  U:Useable   G:Gateway   H:Host   B:Blackhole   D:Dynamic   S:Static

Destination:    ::1                                     PrefixLength : 128

NextHop    :    ::1                                     Flag         : HU

TimeStamp  :    Date- 5/7/2006, Time- 14:35:32

Interface  :    InLoopBack0

Destination:    FE80::                                  PrefixLength : 10

NextHop    :    ::                                      Flag         : BU

TimeStamp  :    Date- 5/7/2006, Time- 14:35:32

Interface  :    NULL0

Destination:    2008::                                  PrefixLength : 64

NextHop    :    2008::5600                              Flag         : U

TimeStamp  :    Date- 5/7/2006, Time- 14:35:32

Interface  :    Vlan-interface1

Destination:    2008::5600                              PrefixLength : 128

NextHop    :    ::1                                     Flag         : HU

TimeStamp  :    Date- 5/7/2006, Time- 14:35:32

Interface  :    InLoopBack0

Destination:    2001::                                  PrefixLength : 64

NextHop    :    2008::3610                              Flag         : GSU

TimeStamp  :    Date- 5/7/2006, Time- 14:35:32

Interface  :    Vlan-interface1

Table 1-2 Description on the fields of the display ipv6 fib command

Field

Description

Total number of Routes

Total number of routes in the FIB

Destination

Destination address to which a packet is forwarded

PrefixLength

Prefix length of the destination address

NextHop

Next hop address when a packet is forwarded to the destination

Flag

Route flag:

“U” Usable route

“G” Gateway route

“H” — Host route

“B” — Blackhole route

“D” — Dynamic route

“S” — Static route

TimeStamp

Generation time of an FIB entry

Interface

Interface from which a packet is forwarded

 

1.1.3  display ipv6 host

Syntax

display ipv6 host

View

Any view

Parameters

None

Description

Use the display ipv6 host command to display the mapping between host name and IPv6 address.

Related commands: ipv6 host.

Examples

# Display the mapping between host name and IPv6 address.

<Sysname> display ipv6 host

Host                 Age           Flags  IPv6Address (es)

SWB                  0             static  2002::1

Table 1-3 Description on the fields of the display ipv6 host command

Field

Description

Host

Host name

Age

Time for the entry to live, displayed as 0 in the case of static configuration.

Flags

Flag indicating whether the entry is configured statically or acquired dynamically

IPv6Address (es)

IPv6 address corresponding to a host name

 

1.1.4  display ipv6 interface

Syntax

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

View

Any view

Parameters

interface-type: Interface type.

interface-number: Interface number.

brief: Displays the brief IPv6 information of an interface.

Description

Use the display ipv6 interface command to display the IPv6 information of a specified interface.

If no interface is specified, the IPv6 information of all interfaces for which IPv6 addresses can be configured is displayed; if only interface-type is specified, the IPv6 information of the interfaces of the specified type for which IPv6 addresses can be configured is displayed; if interface-type interface-number is specified, the IPv6 information of the specified interface is displayed.

If the brief keyword is specified, the brief IPv6 information of the interface is displayed.

Examples

# Display the IPv6 information of a VLAN interface.

<Sysname> display ipv6 interface Vlan-interface 1

Vlan-interface1 current state :UP

Line protocol current state :UP

IPv6 is enabled, link-local address is FE80::2E0:FCFF:FE00:C

  Global unicast address(es):

    2008::5600, subnet is 2008::/64

  Joined group address(es):

    FF02::1:FF00:5600

    FF02::1:FF00:C

    FF02::1

  MTU is 1500 bytes

  ND DAD is enabled, number of DAD attempts: 5

  ND reachable time is 30000 milliseconds

  ND retransmit interval is 1000 milliseconds

  Hosts use stateless autoconfig for addresses

Table 1-4 Description on the fields of the display ipv6 interface command

Field

Description

Vlan-interface1 current state

VLAN interface link state:

l      Administratively DOWN: Indicates the VLAN interface is administratively down; that is, the interface is shut down using the shutdown command.

l      DOWN: Indicates the VLAN interface is administratively up but its physical state is down; that is, no ports in the VLAN are up, which may be caused by a link failure.

l      UP: Indicates the administrative and physical states of the VLAN interface are both up.

Line protocol current state

Link layer protocol state of an interface:

l      DOWN: Indicates the link layer protocol state of the VLAN interface is down, generally because no IP address is configured.

l      UP: Indicates the link layer protocol state of the VLAN interface is up.

IPv6 is enabled

IPv6 forwarding state of an interface (after an IPv6 address is configured for an interface, IPv6 is automatically enabled on it; IPv6 is enabled in the example)

link-local address

Link-local address configured on an interface

Global unicast address(es)

Aggregatable global unicast address configured on an interface

Joined group address(es)

Address of the multicast group that an interface joins

MTU

Maximum transmission unit of an interface

ND DAD is enabled, number of DAD attempts

Number of duplicate address detection (DAD) attempts, with DAD enabled

l      If DAD is enabled, the number of neighbor request messages is also displayed (configured by using the ipv6 nd dad attempts command)

l      If DAD is disabled, “ND DAD is disabled” is displayed. (You can set the number of neighbor request messages for DAD to 0 to disable this function.)

ND reachable time

Neighbor reachable time (which can be configured by using the ipv6 nd nud reachable-time command)

ND retransmit interval

Interval for retransmitting a neighbor solicitation (NS) message (which can be configured by using the ipv6 nd ns retrans-timer command)

Hosts use stateless autoconfig for addresses

Hosts use stateless auto-configuration mode to acquire IPv6 addresses

 

#: View the brief IPv6 information of all interfaces.

<Sysname> display ipv6 interface brief

*down: administratively down

(s): spoofing

Interface                                Physical   Protocol   IPv6 Address

Vlan-interface1                            up         up       2008::5600

Table 1-5 Description on the fields of the display ipv6 interface brief command

Field

Description

*down: administratively down

The interface is down, that is, the interface is disabled by using the shutdown command.

(s) : spoofing

Spoofing attribute of the interface, that is, the link protocol state of the interface is up, but the link does not exist, or the link is established on demand, instead of being permanent.

Interface

Name of the interface

Physical

Interface link state:

l      *down: Indicates the VLAN interface is administratively down; that is, the interface is shut down using the shutdown command.

l      down: Indicates the VLAN interface is administratively up but its physical state is down; that is, no port in the VLAN is up, which may be caused by a link failure.

l      up: Indicates the administrative and physical states of the VLAN interface are both up.

Protocol

Link protocol state of an interface

l      down: Indicates the link layer protocol state of the VLAN interface is down, generally because no IP address is configured.

l      up: Indicates the link layer protocol state of the VLAN interface is up.

IPv6 Address

IPv6 address of the interface (If no address is configured for the interface, “Unassigned” will be displayed.)

 

1.1.5  display ipv6 neighbors

Syntax

display ipv6 neighbors { ipv6-address | all | dynamic | static | interface interface-type interface-number | vlan vlan-id } [ | { begin | exclude | include } regular-expression ]

View

Any view

Parameters

ipv6-address: IPv6 address whose neighbor information is to be displayed.

all: Displays information of all neighbors, including neighbors acquired dynamically and configured statically.

dynamic: Displays information of all neighbors acquired dynamically.

static: Displays information of all neighbors configured statically.

interface interface-type interface-number: Displays information of the neighbors of a specified interface.

vlan vlan-id: Displays information of the neighbors of a specified VLAN, in the range of 1 to 4094.

|: Uses a regular expression to match neighbor entries.

regular-expression: A case-sensitive string for matching.

l           begin: Displays the first matching neighbor entry and all the neighbor entries following it.

l           exclude: Displays the neighbor entries not matching the specified regular expression.

l           include: Displays the neighbor entries matching the specified regular expression.

The regular expression supports various special characters. For details, refer to the display current-configuration command in Configuration File Management Command.

Description

Use the display ipv6 neighbors command to display neighbor information.

You can use the reset ipv6 neighbors command to clear specific IPv6 neighbor information.

Related commands: ipv6 neighbor, reset ipv6 neighbors.

Examples

# View all neighbor information.

<Sysname> display ipv6 neighbors all

                Type: S-Static    D-Dynamic

IPv6 Address                 Link-layer     VID  Interface    State T Age

2008::110                    0015-e9ac-69b6 1    GE1/0/2      REACH S -

FE80::215:E9FF:FEAC:69B6     0015-e9ac-69b6 1    GE1/0/2      STALE D 22

FE80::20F:E2FF:FE00:2201     000f-e200-2201 1    GE1/0/2      STALE D 28

2008::3610                   000f-e200-2201 1    GE1/0/2      STALE D 28

Table 1-6 Description on the fields of the display ipv6 neighbors command

Field

Description

IPv6 Address

IPv6 address of a neighbor

Link-layer

Link layer address (MAC address of a neighbor)

VID

ID of the VLAN to which the interface connected to a neighbor belongs

Interface

Interface connected to a neighbor

State

State of a neighbor, which can be:

l      INCMP: Address resolution is in progress, so the link layer address of the neighbor is unknown yet.

l      REACH: The neighbor is reachable.

l      STALE: The reachability to the neighbor is unknown. The device does not verify the reachability to the neighbor unless it sends a packet to the neighbor.

l      DELAY: The reachability to the neighbor is unknown. The device will send a neighbor request message after a delay time.

l      PROBE: The reachability to the neighbor is unknown. The device sent a neighbor request message to verify the reachability.

T

Type of neighbor information, including S (static configuration) and D (dynamic acquisition).

Age

l      For a static entry, “-“ is displayed.

l      For a dynamic entry, the time (in seconds) since it is reachable last time is displayed, and if it is never reachable, “#” is displayed (for a dynamic neighbor only).

 

1.1.6  display ipv6 neighbors count

Syntax

display ipv6 neighbors { all | dynamic | static | interface interface-type interface-number | vlan vlan-id } count

View

Any view

Parameters

all: Displays the total number of all neighbor entries, including neighbor entries acquired dynamically and configured statically.

dynamic: Displays the total number of all neighbor entries acquired dynamically.

static: Displays the total number of all neighbor entries configured statically.

interface interface-type interface-number: Displays the total number of neighbor entries of a specified interface.

vlan vlan-id: Displays the total number of neighbor entries of a specified VLAN, in the range of 1 to 4,094.

count: Number of neighbor entries.

Description

Use the display ipv6 neighbors count command to display the total number of neighbor entries satisfying the specified condition.

Examples

# Display the total number of neighbor entries acquired dynamically.

<Sysname> display ipv6 neighbors dynamic count

Total dynamic entry(ies):  3

1.1.7  display ipv6 route-table

Syntax

display ipv6 route-table [ verbose ]

View

Any view

Parameters

verbose: Displays detailed information about the IPv6 routing table.

Description

Use the display ipv6 route-table command to display brief information about the routing table, including the destination IP address, prefix length, type of protocol, next hop, egress interface, and so on. In this case, only the valid route entries are displayed,

Use the display ipv6 route-table verbose command to display detailed information about the routing table. In this case, both valid routes and invalid routes are displayed.

Examples

# Display summary information about the routing table.

<Sysname> display ipv6 route-table

 

Routing Table:

Destinations : 4      Routes : 4

 

Destination: ::1/128                                      Protocol: Direct

NextHop    : ::1

Interface  : InLoopBack0

 

Destination: 2008::/64                                    Protocol: Direct

NextHop    : 2008::32

Interface  : Vlan-interface1

 

Destination: 2008::32/128                                 Protocol: Direct

NextHop    : ::1

Interface  : InLoopBack0

 

Destination: FE80::/10                                    Protocol: Direct

NextHop    : ::

Interface  : NULL0              

Table 1-7 Description on the fields of the display ipv6 route-table command

Field

Description

Destinations

Number of reachable destination networks/hosts

Routes

Number of routing entries

Destination

Destination network/host IPv6 address. The part following “/” indicates the prefix length.

Protocol

Routing protocol discovering the route

NextHop

Next hop address

Interface

Egress interface, through which a packet is sent.

 

# Display detailed information about the routing table.

<Sysname> display ipv6 route-table verbose

 

Routing Table:

Destinations : 2      Routes : 2

 

Destination: ::                                       PrefixLength: 0

NextHop    : 1:1:4::1                                 Protocol    : Static

Interface  : Vlan-interface1                             State        : Active

 

Destination: ::1                                      PrefixLength: 128

NextHop    : ::1                                      Protocol    : Direct

Interface  : InLoopBack0                              State       : Active

Table 1-8 Description on the fields of the display ipv6 route-table verbose command

Field

Description

Destinations

Number of reachable destination networks/hosts

Routes

Number of routing entries

Destination

Destination network/host IPv6 address.

PrefixLength

Prefix length of the destination IPv6 address

NextHop

Next hop address

Protocol

Routing protocol discovering the route

Interface

Egress interface

State

Routing entry state: Active (valid route) or Inactive (invalid route).

 

1.1.8  display ipv6 socket

Syntax

display ipv6 socket [ socktype socket-type ] [ task-id socket-id ]

View

Any view

Parameters

socket-type: Type of a socket, in the range of 1 to 3. The value “1” represents a TCP socket, “2” a UDP socket, and “3” a raw IP socket.

task-id: ID of a task, in the range of 1 to 100.

socket-id: ID of a socket, in the range of 0 to 3072.

Description

Use the display ipv6 socket command to display information related to a specified socket.

With no argument specified, this command displays the information about all the sockets; with only the socket type specified, the command displays the information about sockets of the specified type; with the socket type, task ID and socket ID specified, the command displays the information about the specified socket.

Examples

# Display information related to a specified socket.

<Sysname> display ipv6 socket

SOCK_STREAM:

Task = VTYD(43), socketid = 1, Proto = 6,

LA = ::->23, FA = ::->0,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_ACCEPTCONN SO_REUSEADDR SO_KEEPALIVE SO_REUSEPORT SO_SETKEEPALIVE,

socket state = SS_PRIV SS_ASYNC

SOCK_DGRAM:

SOCK_RAW:

Table 1-9 Description on the fields of the display ipv6 socket command

Field

Description

SOCK_STREAM

Socket type, which can be:

l      SOCK_STREAM: Refers to TCP.

l      SOCK_DGRAM: Refers to UDP.

l      SOCK_RAW: Refers to raw IP.

Task

Task name and ID of the created socket

socketid

ID assigned by the kernel to the created socket

Proto

Protocol ID

LA

Local address and local port number

FA

Remote address and remote port number

sndbuf

Size of the sending buffer

rcvbuf

Size of the receiving buffer

sb_cc

Number of bytes sent by the sending buffer

rb_cc

Number of bytes received by the receiving buffer

socket option

Socket option set by the application

socket state

State of the socket

SOCK_DGRAM

UDP socket

SOCK_RAW

Raw IP socket