display dhcp-access user-table (System view)

Function

The display dhcp-access user-table command displays details about online DHCPv4 users.

This command is supported only on the NetEngine 8000 F1A.

Format

display dhcp-access user-table { all | index user-index | mac-address mac-address [ session-id session-id ] | user-id user-id } [ slave ]

Parameters

Parameter	Description	Value
all	Specifies details about all online DHCPv4 users.	-
index user-index	Specifies the index of a specified user table.	The value is an integer that ranges from 0 to 3145727.
mac-address mac-address	Displays details about a user with a specified MAC address.	The value is in the H-H-H format, of which H indicates a hexadecimal number of four characters, such as 00e0 and fc01. If less than four characters are entered, the remaining characters are 0s, for example, if e0 are entered, the value is 00e0.
session-id session-id	Displays details about the user with a specified session ID.	The value is an integer starting from 1 to 4294967295. If one-to-many mapping between one MAC address and many sessions is not enabled, the session ID of users is 0.
user-id user-id	Specifies the ID of a user.	The value is an integer that ranges from 0 to 3145727.
slave	Displays details on the slave main control board.	-

Views

System view

Default Level

3: Management level

Task Name and Operations

Task Name	Operations
bras-control	read

Usage Guidelines

Usage Scenario

The display dhcp-access user-table command is used to view details about online DHCPv4 users when you are monitoring DHCPv4 users or an error occurs in the DHCPv4 function.

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 DHCPv4 user whose ID is 12.

<HUAWEI> system-view
[~HUAWEI] display dhcp-access user-table user-id 12
  -------------------------------------------------------------------
  User-ID                    :   12
  User-Index                 :   12
  Interface                  :   GigabitEthernet0/1/2
  SVLAN/CVLAN                :   0/0
  User MAC Address           :   00e0-fc12-3456
  Session Id                 :   2147483649
  User State                 :   ONLINE
  VPN Instance               :   -
  User IP address            :   10.1.1.254(Radius)
         Renew time          :   1 days 12 hours 0  minutes
         Rebind time         :   2 days 10 hours 0  minutes
         Gateway             :   10.1.1.1
         Mask                :   255.255.255.0
         Lease               :   2011/09/29 19:10:20 -- 2011/10/02 19:10:20
         Remain-Lease(sec)   :   259184
  Address Pool Name          :   test_dhcp
  Server Ip                  :   -
  Server VPN Instance        :   - 
  DNS Primary Server         :   -
  DNS Second Server          :   - 
  Host name                  :   Tesgine2000       
  Option82 Bytes             :                     
  01 0c 30 33 30 33 2d 30 30 30 30 2d 47 45 02 13  
  4d 53 45 5f 30 34 2d 30 33 30 33 2d 30 30 30 30  
  2d 47 45                                        
  Client ID                  :                    
  01 00 01 01 01 01 01       
-------------------------------------------------------

**Table 1** Description of the **display dhcp-access user-table (System view)** command output
Item	Description
User-ID	User ID.
User-Index	Index for a user table.
Interface	User login interface.
SVLAN/CVLAN	VLAN IDs in the inner and outer VLAN tags.
User MAC Address	User MAC address.
User State	User status.
User IP address	IP address of a user.
Address Pool Name	Name of an address pool.
Session Id	User session ID, displayed only after one-to-many mapping between one MAC address and many sessions is enabled.
VPN Instance	Name of the VPN instance to which a user belongs to.
Renew time	Lease renewal time.
Rebind time	Rebind time.
Gateway	Gateway IP address.
Mask	Mask of the user IP address.
Lease	Lease.
Remain-Lease(sec)	Remaining lease.
Server Ip	IP address of a DHCP server.
Server VPN Instance	Name of a VPN instance to which a DHCP server belongs to.
DNS Primary Server	Primary DNS server.
DNS Second Server	Secondary DNS server.
Host name	Host name.
Option82 Bytes	DHCP Option 82 in binary format.
Client ID	Client ID.