display dhcpv6 relay userinfo table

Function

The display dhcpv6 relay userinfo table command displays DHCPv6 client information on a DHCPv6 relay agent.

Format

display dhcpv6 relay userinfo table interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] ] [ statistics | verbose ]

display dhcpv6 relay userinfo table mac-address mac-address-data { [ statistics ] | [ verbose ] }

display dhcpv6 relay userinfo table client-duid client-duid-data { [ statistics ] | [ verbose ] }

display dhcpv6 relay userinfo table server-duid server-duid-data { [ statistics ] | [ verbose ] }

display dhcpv6 relay userinfo table client-address client-address-data [ vpn-instance vpn-instance-name ] { [ statistics ] | [ verbose ] }

display dhcpv6 relay userinfo table server-address server-address-data [ vpn-instance vpn-instance-name ] { [ statistics ] | [ verbose ] }

display dhcpv6 relay userinfo table { [ statistics ] | [ verbose ] }

display dhcpv6 relay userinfo table index index-data

Parameters

Parameter	Description	Value
pevlan pevlan-id end-pevlan-id	Displays login failure and logout records of DHCPv6 clients that send packets with a specified outer VLAN ID. pevlan-id specifies the start outer VLAN ID. end-pevlan-id specifies the end outer VLAN ID. end-pevlan-id must be greater than or equal to pevlan-id. pevlan-id and pevlan-id specify a VLAN range. If end-pevlan-id is not specified, only login failure and logout records of DHCPv6 clients that send packets with the outer VLAN ID specified by pevlan-id are displayed.	The value is an integer ranging from 1 to 4094.
cevlan cevlan-id end-cevlan-id	Displays login failure and logout records of DHCPv6 clients that send packets with a specified inner VLAN ID. cevlan-id specifies the start inner VLAN ID. end-cevlan-id specifies the end inner VLAN ID. end-cevlan-id must be greater than or equal to cevlan-id. end-cevlan-id and cevlan-id specify a VLAN range. If end-cevlan-id is not specified, only login failure and logout records of DHCPv6 clients that send packets with the inner VLAN ID specified by cevlan-id are displayed.	The value is an integer ranging from 1 to 4094.
statistics	Displays the number of DHCPv6 client entries.	-
verbose	Displays detailed information about DHCPv6 client entries.	-
mac-address mac-address-data	Displays information about the DHCPv6 client with a specified MAC address.	The value is a 12-digit hexadecimal number, in the format of H-H-H. Each H is 4 digits. If an H contains fewer than 4 digits, the left-most digits are padded with zeros. For example, e0 is displayed as 00e0. The MAC address cannot be set to FFFF-FFFF-FFFF.
client-duid client-duid-data	Displays information about the DHCPv6 client with a specified DUID.	The value is a hexadecimal number that ranges from 1 to 260, excluding 0x.
server-duid server-duid-data	Displays DHCPv6 client information of the DHCPv6 server with a specified DUID.	The value is a hexadecimal number that ranges from 1 to 260, excluding 0x.
client-address client-address-data	Displays information about the DHCPv6 client with a specified IPv6 address.	The address is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
vpn-instance vpn-instance-name	Displays information about DHCPv6 clients with a specified VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
server-address server-address-data	Displays DHCPv6 client information of the DHCPv6 server with a specified IPv6 address.	The address is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
index index-data	Displays information about DHCPv6 clients with a specified index.	The value is an integer ranging from 0 to 4294967295.
interface interface-type interface-number	Displays DHCPv6 client information on a specified relay interface.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
dhcp	read

Usage Guidelines

Usage Scenario

When a device functions as a DHCPv6 relay agent, it forwards DHCPv6 messages between clients and the server and also stores client information if the clients' addresses or prefixes are available.

To check DHCPv6 client entries on a DHCPv6 relay agent, run the display dhcpv6 relay userinfo table command.

Example

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

# Display detailed information about the DHCPv6 client with MAC address 00e0-fc12-3456.

<HUAWEI> display dhcpv6 relay userinfo table mac-address 00e0-fc12-3456 verbose
- -------------------------------------------------------
Index                         : 0
Client DUID                   : eee5e2b70a5e52a14b341b23
IA type                       : IA_PD
IA_ID                         : 987675961
Server DUID                   : 24a1b455ddace5b0131fb
Server IPv6 address           : 2001:db8:2::2
Interface                     : gigabitethernet0/1/0
PEVLAN/CEVLAN                 : 3526/2430
VPN instance                  : --
Client MAC address            : 00e0-fc12-3456
Info-request transaction-id   : 0xa71cf0
Transaction-id                : 0xd28de3
Rapid Commit                  : on
Client IPv6 PD prefix         : 2001:db8:1::1/64
  Valid time                  : 42401 days 4 hours 43 minutes
  Lease                       : 3663463433
  Remain-Lease                : 3663462932                 
  Status                      : UP
- -------------------------------------------------------

# Display information about the DHCPv6 client with MAC address 00e0-fc12-3456.

<HUAWEI> display dhcpv6 relay userinfo table mac-address 00e0-fc12-3456
- ---------------------------------------------------------------------------------
   Index      IAID IA type   DUID                                   
        Interface                     PEVLAN/CEVLAN   MAC  
        IPv6 address                  IPv6 PD prefix 
- ---------------------------------------------------------------------------------
      0  987675961 IA_PD     eee5e2b70a5ebe37e214f01c374c3e7cad5c52a14  
        gigabitethernet0/1/0          3526/2430       00e0-fc12-3456
- -                            2001:db8:1::1/64
- ---------------------------------------------------------------------------------
The table count             :  1

**Table 1** Description of the **display dhcpv6 relay userinfo table** command output
Item	Description
Index	Table index.
Client DUID	Client's DHCP unique identifier.
Client MAC address	Client's MAC address.
Client IPv6 PD prefix	Client's PD prefix.
DUID	Client's DHCP unique identifier.
IA type	Client's identity association type, which can be IA_NA or IA_PD.
Server DUID	Server's DHCP unique identifier.
Server IPv6 address	Server's IPv6 address.
IPv6 address	Client's IPv6 address.
IPv6 PD prefix	Client's PD prefix.
Interface	Access interface.
PEVLAN/CEVLAN	Client's PE-VLAN ID and CE-VLAN ID.
VPN instance	Client's VPN instance name.
MAC	Client's MAC address.
Info-request transaction-id	Transaction-id carried in client's Information-Request messages.
Transaction-id	Transaction-id carried in client's Solicit or Request messages.
Rapid Commit	Client's Rapid-Commit option (If on is displayed, the client requires the server's rapid response. If off is displayed, the client does not require the server's rapid response.).
Valid time	Lease time of the client's IPv6 address, in days, hours, and minutes.
Lease	Lease time of the client's IPv6 address, in seconds.
Remain-Lease	Remaining lease time of the client's IPv6 address, in seconds.
Status	Client's status. UP: The client has been assigned an IPv6 address. INIT: The client has not been assigned an IPv6 address. SOLICIT: The client is in the Solicit state. ERR: The client is in the Error state.
IAID	Client's IA_ID.
The table count	Number of entries.