display ipv6 prefix

Function

The display ipv6 prefix command displays IPv6 prefix pool configurations.

This command is supported only on the NetEngine 8000 F1A.

Format

display ipv6 prefix [ prefix-name [ all | used | reserved { mac | duid } | start-ipv6-prefix [ end-ipv6-prefix ] ] ]

Parameters

Parameter Description Value
prefix-name

Specifies the name of an IPv6 prefix pool. If this parameter is not specified, this command displays key configurations of all IPv6 prefix pools.

The value is a string of 1 to 32 case-insensitive characters.

all

Displays detailed information about a specified IPv6 prefix pool and the use of all IPv6 prefixes in that pool.

-

used

Displays detailed information about a specified IPv6 prefix pool and all IPv6 prefixes in use.

-

reserved

Displays information about address or prefix reservation in a prefix pool.

-

mac

Query based on MAC addresses.

-

duid

Query based on DUID.

-

start-ipv6-prefix

Specifies the start IPv6 prefix in a specific IPv6 prefix pool.

The value is in the format of X:X::X:X. Each X is a four-digit hexadecimal number.

end-ipv6-prefix

Specifies the end IPv6 prefix in a specific IPv6 prefix pool.

The value is in the format of X:X::X:X. Each X is a four-digit hexadecimal number.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name Operations
ipv6pool read

Usage Guidelines

Usage Scenario

To check configurations of all IPv6 prefix pools or a specific one, run the display ipv6 prefix command.

If the name of an IPv6 prefix pool is specified, but not 'all' or 'used', this command displays detailed information about the specified IPv6 prefix pool and statistics about IPv6 prefixes in the pool.

If both the start and end IPv6 prefixes are specified to define a range of prefixes in a pool, this command displays detailed information about the specified IPv6 prefix pool and statistics about the range of prefixes.If the start IPv6 prefix, not the end IPv6 prefix, is specified, this command displays statistics about IPv6 prefixes in all prefix ranges starting with the specified IPv6 prefix.

If this command is run during user login or logout, the displayed statistics and address usage information may be different from the actual access user statistics. You are advised to view the corresponding information after user access is stable.

Prerequisites

The prefix pools to be queried have been configured.

Precautions

In VS mode, this command applies only to the admin VS.

Example

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

# Display the configuration of all IPv6 prefix pools.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix
 -------------------------------------------------------------------------------
 Index Name                             Address/Length                Type
    Constant-index
 -------------------------------------------------------------------------------
 0     dg                               2001:db8::1/46                     DELEGATION
    0
 1     dl                               -                             REMOTE
    1
 2     dpc                              2001:db8::2/64                     LOCAL
    2
 3     god6                             2001:db8::3/64                     LOCAL
    3
 4     prefix1                          -                             LOCAL
    4
 5     tt                               2001:db8::4/64                     LOCAL
    5
 6     wm                               2001:db8::5/64                     LOCAL
    6
 7     ww                               2001:db8::6/46                     DELEGATION
    7
 -------------------------------------------------------------------------------
 Total created prefix pool(s): 8
# Display configurations about all IPv6 prefix pools or a specific one.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix hrb
 ----------------------------------------------------------------------------------
 Prefix Name        : hrb                 
 Prefix Index       : 5
 Prefix constant index: -
 Prefix Type        : LOCAL               
 Prefix Address     : -                   
 Prefix Length      : -                   
 Reserved Type      : NONE                
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked            
 Vpn instance       : -
 Free Prefix Count  : 0
 Used Prefix Count  : 0
 Reserved Prefix Count: 0
 Excluded Prefix Count: 0
 Conflict Prefix Count: 0
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0
 ----------------------------------------------------------------------------------
# Display detailed information about an IPv6 prefix pool named pre1 and all IPv6 prefixes in use in that pool.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix pre1 used
------------------------------------------------------------------------------
 Prefix Name        : pre1
 Prefix Index       : 1
 Prefix constant index: -
 Prefix Type        : DELEGATION
 Prefix Address     : 2011::
 Prefix Length      : 63
 Link-Address       : -
 Reserved Type      : NONE
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked
 Vpn instance       : -
 PD Prefix Len      : 64
 PD Prefix/C-DUID   : -
 slaac-unshare-only : FALSE
 pd-unshare-only    : FALSE
 dhcpv6-unshare-only : FALSE 
 Free Prefix Count  : 1
 Used Prefix Count  : 0
 Bound Prefix Count (Free): 0
 Bound Prefix Count (Used): 0
 Flexibly-Allocted Prefix Count: 1
 Reserved Prefix Count: 0
 Conflict Prefix Count: 0
 Excluded Prefix Count: 0 
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0
 ------------------------------------------------------------------------------
 Prefix-address                Binding-Index  Mac/Duid/Binding-Prefix  Status
 ------------------------------------------------------------------------------
 -                             : -                   -
 ------------------------------------------------------------------------------
# Display information about a IPv6 delegation prefix pool named pre2.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix pre2
 -------------------------------------------------------------------------------
---
 Prefix Name        : pre2
 Prefix Index       : 1
 Prefix constant index: -
 Prefix Type        : DELEGATION
 Prefix Address     : -
 Prefix Length      : -
 Link-Address       : -
 Reserved Type      : NONE
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked
 Vpn instance       : -
 PD Prefix Len      : 64
 PD Prefix/C-DUID   : -
 slaac-unshare-only : FALSE
 pd-unshare-only    : FALSE
 Free Prefix Count  : 0
 Used Prefix Count  : 0
 Bound Prefix Count (Free): 0
 Bound Prefix Count (Used): 0
 Flexibly-Allocted Prefix Count: 0
 Reserved Prefix Count: 0
 Conflict Prefix Count: 0
 Excluded Prefix Count: 0
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0

 -------------------------------------------------------------------------------
Prefix-address        Online-user
# Display detailed configurations of a specified IPv6 local prefix pool and all the reserved prefixes by MAC address.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix na reserved mac
 --------------------------------------------------------------------------------------------------
 Prefix Name        : na                  
 Prefix Index       : 0
 Prefix constant index: -
 Prefix Type        : LOCAL               
 Prefix Address     : 2021::                                            
 Prefix Length      : 64                  
 Reserved Type      : MAC                 
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked            
 Vpn instance       : -
 Free Prefix Count  : 1048573
 Used Prefix Count  : 2
 Reserved Prefix Count: 2
 Conflict Prefix Count: 0
 Excluded Prefix Count: 0
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0
 --------------------------------------------------------------------------------------------------
 Prefix-address                Online-user  
 --------------------------------------------------------------------------------------------------
 -                             : -
 --------------------------------------------------------------------------------------------------
 Prefix-address                Interface                              pevlan/cevlan  Mac
 --------------------------------------------------------------------------------------------------
 2021::1                       -                                           -/-       00e0-fc12-345A
 2021::2                       -                                           -/-       00e0-fc12-345B
 --------------------------------------------------------------------------------------------------
# Display detailed configurations of a specified IPv6 local prefix pool and all the reserved prefixes by DUID.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix na reserved duid
 --------------------------------------------------------------------------------------------------
 Prefix Name        : na                  
 Prefix Index       : 0
 Prefix constant index: -
 Prefix Type        : LOCAL               
 Prefix Address     : 2021::                                            
 Prefix Length      : 64                  
 Reserved Type      : DUID                
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked            
 Vpn instance       : -
 Free Prefix Count  : 1048573
 Used Prefix Count  : 2
 Reserved Prefix Count: 2
 Conflict Prefix Count: 0
 Excluded Prefix Count: 0
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0
 --------------------------------------------------------------------------------------------------
 Prefix-address                Online-user  
 --------------------------------------------------------------------------------------------------
 -                             : -
 --------------------------------------------------------------------------------------------------
 Prefix-address                Duid
 --------------------------------------------------------------------------------------------------
 2021::1                       00030001E0000567036E            
 2021::2                       0003000130000582E507            
 --------------------------------------------------------------------------------------------------
# Display detailed configurations of a specified IPv6 delegation prefix pool and all the reserved prefixes by MAC address.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix pd reserved mac
 --------------------------------------------------------------------------------------------------
 Prefix Name        : pd                  
 Prefix Index       : 1
 Prefix constant index: -
 Prefix Type        : DELEGATION          
 Prefix Address     : 2240::                                            
 Prefix Length      : 44                  
 Link-Address       : -                   
 Reserved Type      : MAC                 
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked            
 Vpn instance       : -
 PD Prefix Len      : 64
 PD Prefix/C-DUID   : -
 slaac-unshare-only : FALSE               
 pd-unshare-only    : FALSE               
 dhcpv6-unshare-only: FALSE               
 Free Prefix Count  : 1048574
 Used Prefix Count  : 2
 Bound Prefix Count (Free): 0
 Bound Prefix Count (Used): 0
 Flexibly-Allocted Prefix Count: 0
 Reserved Prefix Count: 2
 Conflict Prefix Count: 0
 Excluded Prefix Count: 0
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0
 --------------------------------------------------------------------------------------------------
 Prefix-address                Interface                              pevlan/cevlan  Mac
 --------------------------------------------------------------------------------------------------
 2240::                        -                                           -/-       00e0-fc12-345A
 2240:0:0:1::                  -                                           -/-       00e0-fc12-345B
 --------------------------------------------------------------------------------------------------
# Display detailed configurations of a specified IPv6 delegation prefix pool and all the reserved prefixes by DUID.
<HUAWEI> system-view
[~HUAWEI] display ipv6 prefix pd reserved duid
 --------------------------------------------------------------------------------------------------
 Prefix Name        : pd                  
 Prefix Index       : 1
 Prefix constant index: -
 Prefix Type        : DELEGATION          
 Prefix Address     : 2240::                                            
 Prefix Length      : 44                  
 Link-Address       : -                   
 Reserved Type      : DUID                
 Valid Lifetime     : 3 Days 0 Hours 0 Minutes
 Preferred Lifetime : 2 Days 0 Hours 0 Minutes
 IfLocked           : Unlocked            
 Vpn instance       : -
 PD Prefix Len      : 64
 PD Prefix/C-DUID   : -
 slaac-unshare-only : FALSE               
 pd-unshare-only    : FALSE               
 dhcpv6-unshare-only: FALSE               
 Free Prefix Count  : 1048574
 Used Prefix Count  : 2
 Bound Prefix Count (Free): 0
 Bound Prefix Count (Used): 0
 Flexibly-Allocted Prefix Count: 0
 Reserved Prefix Count: 2
 Conflict Prefix Count: 0
 Excluded Prefix Count: 0
 Radius Used Total  : 0
 Radius Used Online : 0
 Auto-Blocked Times : 0
 IP Allocation Failures : 0
 --------------------------------------------------------------------------------------------------
 Prefix-address                Duid
 --------------------------------------------------------------------------------------------------
2001:db8:                        0003000130000582E507            
2001:db8:0::                  00030001BC00055745A6            
 --------------------------------------------------------------------------------------------------
Table 1 Description of the display ipv6 prefix command output
Item Description
Index

Index of an IPv6 prefix pool.

Name

Name of an IPv6 prefix pool.

Address/Length

IPv6 prefix address and prefix length.

Type

Type of an IPv6 prefix pool:

  • LOCAL.
  • REMOTE.
  • DELEGATION.
Constant-index

Constant index of an IPv6 prefix pool:

A hyphen (-) is displayed if the constant index function is disabled.

A constant index value is displayed if the constant index function is enabled.

Total created prefix pool(s)

Total created prefix pool(s).

Prefix Name

Name of a prefix.

Prefix Index

Index of a prefix.

Prefix constant index

Constant index of a prefix.

Prefix Type

Types of prefixes:

  • local.
  • delegation.
  • remote.
Prefix Address

Prefix address.

Prefix Length

Length of a prefix.

Reserved Type

Reserved type.

Reserved Prefix Count

Number of reserved prefixes.

Valid Lifetime

Valid lifetime.

Preferred Lifetime

Preferred lifetime.

IfLocked

Whether a prefix pool is locked.

Vpn instance

VPN information.

Free Prefix Count

Number of idle prefixes.

Used Prefix Count

Number of used prefixes.

Excluded Prefix Count

Number of excluded prefixes.

Radius Used Total

Number of RADIUS users.

Radius Used Online

Number of online RADIUS users.

Auto-Blocked Times

Number of dynamic isolation times.

IP Allocation Failures

Number of IP Address Assignment Failures.

Link-Address

Configured link address.

PD Prefix Len

Length of a PD prefix.

PD Prefix/C-DUID

DUID of a PD prefix.

Bound Prefix Count (Free)

Number of bound and idle prefixes.

Bound Prefix Count (Used)

Number of bound and used prefixes.

Online-user

Number of online users sharing the IPv6 prefix address.

Conflict Prefix Count

Conflict prefix count.

Interface

interface.

Mac

MAC address.

Duid

duid.

pevlan

Outer VLAN.

cevlan

Inner VLAN.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >