display dhcpv6 relay client-info

Function

The display dhcpv6 relay client-info command displays DHCPv6 client login failure and logout records on a DHCPv6 relay agent.

Format

display dhcpv6 relay client-info { offline-record | online-fail-record } interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] ]

display dhcpv6 relay client-info { offline-record | online-fail-record } mac-address mac-address-data

display dhcpv6 relay client-info { offline-record | online-fail-record } client-duid client-duid-data

display dhcpv6 relay client-info { offline-record | online-fail-record }

Parameters

Parameter	Description	Value
offline-record	Displays DHCPv6 client logout records.	-
online-fail-record	Displays DHCPv6 client login failure records.	-
interface interface-type interface-number	Displays DHCPv6 client login failure and logout records on a specified DHCPv6 relay interface.	-
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.
mac-address mac-address-data	Displays login failure and logout records of 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.
client-duid client-duid-data	Displays login failure and logout records of the DHCPv6 client with a specified DUID.	The value is a hexadecimal number that ranges from 1 to 260, excluding 0x.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
dhcp	read

Usage Guidelines

Usage Scenario

To check DHCPv6 client login failure and logout records on a DHCPv6 relay agent, run the display dhcpv6 relay client-info command.

If an interface and a VLAN are specified, this command displays login failure and logout records of DHCPv6 clients that access from the specified interface and VLAN.
If a MAC address is specified, this command displays login failure and logout records of the DHCPv6 client with the specified MAC address.
If a DUID is specified, this command displays login failure and logout records of the DHCPv6 client with the specified DUID.
If no parameter is specified, this command displays all DHCPv6 client login failure and logout records

Example

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

# Display login failure records of the DHCPv6 client with a specified DUID.

<HUAWEI> display dhcpv6 relay client-info online-fail-record client-duid 00030001000000000006
--------------------------------------------------------
Index                         : 163
Client DUID                   : 00030001000000000006
IA type                       : IA_PD
IA_ID                         : 6
Interface                     : Eth-Trunk1
PEVLAN/CEVLAN                 : 0/0
VPN instance                  : --
Client MAC address            : 00e0-fc00-0006
Client IPv6 PD prefix         : --
  Online fail cause           : Up to interface or VLAN max session
  Online fail time            : 2013-11-21 06:03:11
--------------------------------------------------------

# Display logout records of the DHCPv6 client with MAC address 0e0-fc00-0064.

<HUAWEI> display dhcpv6 relay client-info offline-record mac-address 0e0-fc00-0064
--------------------------------------------------------
Index                         : 67
Client DUID                   : 00030001000000000064
IA type                       : IA_NA
IA_ID                         : 100
Interface                     : Eth-Trunk1
PEVLAN/CEVLAN                 : 0/0
VPN instance                  : --
Client MAC address            : 00e0-fc00-0064
Client IPv6 address           : 2001:db8:1::1
  IA status                   : SEND_RELEASE
  Delete cause                : Client request
  Delete time                 : 2013-11-21 10:08:24
--------------------------------------------------------

**Table 1** Description of the **display dhcpv6 relay client-info** command output
Item	Description
Index	Table index.
Client DUID	Client's DHCP unique identifier.
Client MAC address	Client's MAC address.
Client IPv6 address	Client's IPv6 address.
Client IPv6 PD prefix	Client's IPv6 address prefix.
IA type	Client's identity association type, which can be IA_NA or IA_PD. IA_NA: Identity Association for Non-temporary Address. IA_PD: Identity Association for Prefix Delegation.
IA status	Identity association status. TABLE_INIT: The client table is in the initialization state. SEND_SOLICIT_PKT: The client has sent a Solicit message. SEND_ADVERTISE_PKT: The server has sent an Advertise message in response to the Solicit message. SEND_REQUEST_PKT: The client has sent a Request message to request IP addresses and other configuration parameters from the server. SEND_RENEW_REBIND_PKT: The client has sent a Renew or Rebind message to extend the lease of the IP address assigned to the client. SEND_CONFIRM_PKT: The client has sent a Confirm message to the server to determine whether the IP address it was assigned is still applicable to the link to which the client is connected. SEND_DECLINE: The client has sent a Decline message to the server to indicate that the client has determined that the address assigned by the server is already in use on the link to which the client is connected. SEND_RELEASE: The client has sent a Release message to the server to indicate that the client will no longer use the assigned address. ADDR_UP: The client has been assigned an IP address. ERRO_STAT: The client table is in the error state.
IA_ID	Client's IA_ID.
Interface	Access interface.
PEVLAN/CEVLAN	Client's PE-VLAN ID and CE-VLAN ID.
VPN instance	Client's VPN instance name.
Online fail cause	Cause of the client login failure.
Online fail time	Time when the client failed to go online.
Delete cause	Reason why the client entry was deleted.
Delete time	Time when the client entry was deleted.