display dhcpv6-access user-table

Function

The display dhcpv6-access user-table command displays details about online DHCPv6 users.

This command is supported only on the NetEngine 8000 F1A.

Format

display dhcpv6-access user-table { mac-address mac-address [ interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ cevlan cevlan-id ] ] ] | index index | prefix prefix-address | interface { interface-name | interface-type interface-number } | vpn-instance vpn-instance | user-id user-id | all }

Parameters

Parameter	Description	Value
mac-address mac-address	Displays details about online DHCPv6 users with a specified MAC address.	The value is in the format of H-H-H. Each H contains one to four hexadecimal numbers, such as 00e0 and fc01. If an H contains less than four bits, 0s are padded ahead. For example, an H is e0. It is displayed as 00e0 in the MAC address.
interface interface-name	Specifies the name of an interface.	-
interface interface-type	Specifies the type of an interface.	-
interface interface-number	Specifies the number of an interface.	-
pevlan pevlan-id	Specifies the outer VLAN ID.	The value is an integer that ranges from 1 to 4094.
cevlan cevlan-id	Specifies the inner VLAN ID.	The value is an integer that ranges from 1 to 4094.
index index	Display details about online DHCPv6 users with a specified user table index.	The value is an integer ranging from 0 to 283647.
prefix prefix-address	Displays details about online DHCPv6 users with a specified IP prefix.	The address is a 32-digit hexadecimal number.
vpn-instance vpn-instance	Displays details about online DHCPv6 users in a specified VPN instance.	The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").
user-id user-id	Displays details about an online DHCPv6 user with a specified user ID.	The value is an integer ranging from 0 to 283647.
all	Displays detailed information about all the online DHCPv6 users.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
ipv6pool	read

Usage Guidelines

Usage Scenario

If a fault occurs during DHCPv6 entry monitoring or DHCPv6 monitoring, run the display dhcpv6-access user-table command to view details about online DHCPv6 users.

After one-to-many mapping between one MAC address and many sessions is enabled, if only a user MAC address is specified, the command displays information about all users of the specified MAC address. If a user MAC address, interface name, and VLAN IDs are specified, the command displays information about only the users with the specified MAC address, interface name, and VLAN IDs. For example, if a user goes online from a sub-interface, but only a MAC address and interface name are specified, the command does not display user information. The user VLAN IDs must also be specified for the user information to display. In this example, pevlan-id must be specified for single VLAN users that send single-tagged packets to go online, and both pevlan-id and cevlan-id must be specified for QinQ access users that send double-tagged packets to go online.

Precautions

In VS mode, this command is supported only by the admin VS.

Example

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

# Displays detailed information about the DHCPv6 user with user-id set to 2.

<HUAWEI> display dhcpv6-access user-table user-id 2
-------------------------------------------------------------------
  Interface                   :   GigabitEthernet0/1/0.3
  SVLAN/CVLAN                 :   3/0
  User Link-Local Address     :   2001:DB8:1::1
  User Address Type           :   IA_NA
  DNS search list             :   -
  AFTR name                   :   -
  Option15                    :   01 02 03 04 05 06 07 08 09
  User DUID                   :   00 03 00 01 00 02 01 01 01 0C
  User MAC Address            :   00e0-fc01-010C
  User-ID                     :   2
  Index                       :   1
  User State                  :   ONLINE
  VPN Instance                :   -
  Lease Timeout Offline Flag  :   0
  Roam Flag                   :   0
  Odd even Flag               :   0
  Session ID                    :   2147483649
  Client DUID to Remote Server  : 00 02 00 00 07 DB FF FF 80 00 00 01 01 01 01 01 01 01 00 00

  User IPV6 address           :   2001:DB8:2::1
         T1                   :   86400
         T2                   :   138240
         Prefer time          :   2 days 0 hours 0  minutes
         Valid time           :   3 days 0 hours 0  minutes
         IA_ID                :   38
         Prefix length        :   128
         Lease                :   2012/01/23 14:23:39 --- 2012/01/26 14:23:39
         Remain-Lease(Sec)    :   259029
         Address Pool Name    :   csj-local
  User IPV6 PD prefix         :   2001:DB8::
         T1                   :   86400
         T2                   :   138240
         Prefer time          :   2 days 0 hours 0  minutes
         Valid time           :   3 days 0 hours 0  minutes
         IA_ID                :   9
         Prefix length        :   64
         Lease                :   2012/01/23 14:23:39 --- 2012/01/26 14:23:39
         Remain-Lease(Sec)    :   258811
         Address Pool Name    :   csj-del
  PCP server name(option 80)  :   www.pcpserver.com
    -------------------------------------------------------------------

# Display brief information about all online DHCPv6 users.

<HUAWEI> display dhcpv6-access user-table all
  DHCPV6-ACCESS-USER-INFO-BRIEF:
  Index            User-ID          MAC               State
  IPV6-Address                                        Remain-Lease(Sec)
  PD-Address                                          Remain-Lease(Sec)
--------------------------------------------------------------------------------
    000000          000036      00e0-fc00-0003       ADDR_UP
    77::1                                            259140
    88::/64                                          259140
--------------------------------------------------------------------------------

Total users : 1

**Table 1** Description of the **display dhcpv6-access user-table** command output
Item	Description
Interface	Interface from which users get online.
SVLAN/CVLAN	svlan/cvlan.
User Link-Local Address	Link-local address of a user.
User Address Type	Type of the address that the user applies for. The values are as follows: IA_NA&IA_PD: The user applies for both IA_NA and IA_PD addresses. IA_NA: The user applies for the IA_NA address only. IA_PD: The user applies for the IA_PD address only.
User DUID	DUID of the user.
User MAC Address	MAC address of the user.
User State	User status: ONLINE: Users are already online. WAIT-SERVER-ADVERTISE: Users wait for advertise packets from the DHCP server. WAIT-SERVER-REPLY: Users wait for reply packets from the DHCP server. WAIT-CLIENT-REQUEST: The server waits for a request packet from a client. WAIT-AUTH: Users wait for authentication. WAIT-ACCOUNT: Users wait for accounting. DELETING: Users are going offline.
User IPV6 address	IPv6 address of the user.
User IPV6 PD prefix	IPv6 PD prefix of the user.
Address Pool Name	Name of the address pool to which the address belongs.
DNS search list	DNS name suffix.
AFTR name	Name of an AFTR.
Option15	Option15.
MAC	MAC address of a user.
User-ID	Index of a DHCPv6 user.
Index	Index of a DHCPv6 table.
State	User address status.
VPN Instance	VPN instance name.
Lease Timeout Offline Flag	Flag of the subscriber in arrears.
Lease	IP address lease.
Roam Flag	Roaming flag.
Odd even Flag	Flag of the users with odd and even MAC addresses load balancing.
Session ID	Session ID.
Client DUID to Remote Server	Substitute client DUID that replaced the original one and was sent to the server, displayed only after a substitute client DUID is configured.
T1	Extended IP address lease.
T2	Time elapsed since the user address was rebound to the user.
Prefer time	Preferred time.
Valid time	Validity period.
IA_ID	IA ID of the user.
Prefix length	Length of an address prefix.
Remain-Lease(Sec)	Remaining IP address lease ( in seconds).
PCP server name(option 80)	PCP server name delivered by a RADIUS server and code of the DHCPv6 option in which the PCP server name is encapsulated.
IPV6-Address	IPv6 address of the user.
PD-Address	IPv6 PD prefix of the user.
Total users	Total number of users.