display dhcp relay user-table
Parameters
Parameter |
Description |
Value |
|---|---|---|
all |
Displays all user entries on the DHCP relay agent. |
- |
ip-address ip-address |
Displays the user entry with a specified IP address on the DHCP relay agent. |
The value is in dotted decimal notation. |
mac-address mac-address |
Displays the user entry with a specified MAC address on the DHCP relay agent. |
The value is in H-H-H format. An H contains 4 hexadecimal digits. |
Usage Guidelines
Usage Scenario
A DHCP relay agent can dynamically create user entries after user entry detection is enabled. After this function is enabled, you can use the display dhcp relay user-table command to check the IP address, MAC address, VLAN ID, and Layer 3 access interface index of each DHCP client.
Prerequisites
User entry detection has been enabled on the DHCP relay agent using the dhcp relay detect enable command.
Example
# Display all user entries on the DHCP relay agent.
<AC6605> display dhcp relay user-table all IP Address MAC Address VLAN Interface Lease Time -------------------------------------------------------------------------------- 10.1.1.212 5cd9-98bc-0318 3501 Wlan-Dbss11:0 2017.05.05 15:55:22 10.1.1.222 000b-c002-9aed 3501 Wlan-Dbss11:0 2017.05.05 15:55:23 -------------------------------------------------------------------------------- Print count: 2 Total count: 2
# Display the user entry with IP address 10.1.1.212.
<AC6605> display dhcp relay user-table ip-address 10.1.1.212 IP Address MAC Address VLAN Interface Lease Time -------------------------------------------------------------------------------- 10.1.1.212 5cd9-98bc-0318 3501 Wlan-Dbss11:0 2017.05.05 15:55:22 -------------------------------------------------------------------------------- Print count: 1 Total count: 1
# Display the user entry with MAC address 5cd9-98bc-0318.
<AC6605> display dhcp relay user-table mac-address 5cd9-98bc-0318 IP Address MAC Address VLAN Interface Lease Time -------------------------------------------------------------------------------- 10.1.1.212 5cd9-98bc-0318 3501 Wlan-Dbss11:0 2017.05.05 15:55:22 -------------------------------------------------------------------------------- Print count: 1 Total count: 1
| Item | Description |
|---|---|
IP Address |
IP address of a DHCP client. |
MAC Address |
MAC address of the DHCP client. |
VLAN |
VLAN to which the DHCP client belongs. |
Interface |
Index of the Layer 3 interface to which the DHCP client connects. |
Lease Time |
Lease expiration time. |
Print count |
Number of user entries that are displayed. |
Total count |
Total number of user entries. |
