display dhcp relay client-info

Function

The display dhcp relay client-info command displays the history records of information exchange between a DHCP client and a DHCP server over a DHCP relay agent.

Format

display dhcp relay client-info [ interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] ] | mac-address mac-address | option option-value ]

Parameters

Parameter	Description	Value
interface interface-type interface-number	Specifies an interface on a DHCP relay agent. interface-type: specifies the type of the interface. interface-number: specifies the number of the interface.	-
pevlan pevlan-id	Specifies the outer VLAN ID of the interface or the start value of the outer VLAN ID range.	The value is an integer ranging from 1 to 4094.
end-pevlan-id	Specifies the end value of the outer VLAN ID range.	The value is an integer ranging from 1 to 4094. The value of end-pevlan-id must be greater than the value of pevlan-id.
cevlan cevlan-id	Specifies the inner VLAN ID of the interface or the start value of the inner VLAN ID range.	The value is an integer ranging from 1 to 4094.
end-cevlan-id	Specifies the end value of the inner VLAN ID range.	The value is an integer ranging from 1 to 4094. The value of end-cevlan-id must be greater than the value of cevlan-id.
mac-address mac-address	Specifies the MAC address of the DHCP client.	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.
option option-value	Specifies the option value of a DHCP packet.	The value is a string of 1 to 64 characters in hexadecimal notation.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
dhcp	read

Usage Guidelines

Usage Scenario

To view the history records of information exchange between a DHCP client and a DHCP server over a DHCP relay agent, run the display dhcp relay client-info command.

Example

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

# Display all the history records of information exchange between a DHCP client and a DHCP server.

<HUAWEI> display dhcp relay client-info
----------------------------------------------------------
Table index: 1
Table create time: 2018-03-10 09:08:18
Table status: success
Interface: GigabitEthernet0/1/1.1
PE VLAN: 100
CE VLAN: -
MAC address: 0100-0000-0000
Option: 01 00 00 00 
----------------------------------------------------------
Table index: 2
Table create time: 2018-03-10 09:08:18
Table status: success
Interface: GigabitEthernet0/1/1.1
PE VLAN: 100
CE VLAN: -
MAC address: 0200-0000-0000
Option: 02 00 00 00 
----------------------------------------------------------
total number: 2

**Table 1** Description of the **display dhcp relay client-info** command output
Item	Description
Table index	Entry index.
Table create time	Time when an entry is created.
Table status	Entry status. success: The user successfully goes online. wait offer: The device is waiting for the DHCP server to send a DHCP Offer message. wait request: The device is waiting for the DHCP client to send a DHCP Request message. wait ack: The device is waiting for the DHCP server to send a DHCP ACK message. invalid: The device is in the abnormal state.
PE VLAN	Outer VLAN ID carried in DHCP packets.
CE VLAN	Inner VLAN ID carried in DHCP packets.
MAC address	MAC address of the DHCP client.
total number	Total number of history records.
Interface	Interface through which the DHCP client goes online.
Option	Option code or sub-option code carried in DHCP packets. If no option code or sub-option code exists in DHCP packets, this item is displayed as "-".