display dhcp chasten-user

Function

The display dhcp chasten-user command displays information about limited DHCP user connections.

Format

display dhcp chasten-user slot slotid [ mac-address mac-address [ interface { interface-type interface-num | interface-name } [ pe-vlan pe-vlan [ ce-vlan ce-vlan ] ] ] ] [ state { check | restrain } ]

display dhcpv6 chasten-user slot slotid [ mac-address mac-address [ interface { interface-type interface-num | interface-name } [ pe-vlan pe-vlan [ ce-vlan ce-vlan ] ] ] ] [ state { check | restrain } ]

Parameters

Parameter	Description	Value
mac-address mac-address	Displays information about limited DHCP user connections 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. It cannot be a broadcast or multicast MAC address.
interface interface-name	Displays information about limited DHCP user connections with a specified interface.	-
interface interface-type interface-num	Displays information about limited DHCP user connections with a specified interface.	-
pe-vlan pe-vlan	Displays information about limited DHCP user connections with a specified outer VLAN ID.	The value is an integer ranging from 1 to 4094.
ce-vlan ce-vlan	Displays information about limited DHCP user connections with a specified inner VLAN ID.	The value is an integer ranging from 1 to 4094.
state	Displays the status of a user.	Status of a user. RESTRAIN: suppression state. CHECK: check state.
check	Displays information about DHCP users in the check state.	-
restrain	Displays information about DHCP users in the suppression state.	-
slot slotid	Displays information about limited DHCP user connections on a specified board.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
dhcp	read

Usage Guidelines

To view information about limited DHCP user connections, run the display dhcp chasten-user command.

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.

# Display information about limited DHCP user connections with a MAC address of 0-0-e.

<HUAWEI> system-view
[~HUAWEI] display dhcp chasten-user slot 1 mac-address 0-0-e
-------------------------------------------------------------------------------
IfIndex: 5697
PE VLAN/CE VLAN: 1004/-
UserMac: 0000-0000-000e
State: CHECK
RecvPktTime: 2011-05-31 16:27:32
RecvPktCount: 3
RecvAuthenCount: 0
TotalRestrainPkt: 0
TotalPassPkt: 3
-------------------------------------------------------------------------------
IfIndex: 5705
PE VLAN/CE VLAN: 1003/-
UserMac: 0000-0000-000e
State: CHECK
RecvPktTime: 2011-05-31 16:28:47
RecvPktCount: 2
RecvAuthenCount: 0
TotalRestrainPkt: 0
TotalPassPkt: 2
-------------------------------------------------------------------------------
Total User Num: 2

**Table 1** Description of the **display dhcp chasten-user** command output
Item	Description
PE VLAN/CE VLAN	Outer VLAN ID/Inner VLAN ID carried in user packets.
Total User Num	Number of restricted DHCP users with the same MAC address.
IfIndex	Index of the interface through which the user goes online.
UserMac	MAC address of the user.
State	Status of the user: RESTRAIN: The user is in the suppression state. CHECK: The user is in the check state.
RecvPktTime	If the user is in the suppression state, this field indicates the start time of the suppression period. If the user is in the check state, this field indicates the start time of the check period.
RecvPktCount	If request-packets is not specified in the dhcp connection chasten command, the value of this field is displayed as 0. If request-packets is specified in the dhcp connection chasten command: If the user is in the suppression state, this field indicates the number of request packets received before the user enters the suppression state. If the user is in the check state, this field indicates the number of request packets received within the check period.
RecvAuthenCount	If authen-packets is not specified in the dhcp connection chasten command, the value of this field is displayed as 0. If authen-packets is specified in the dhcp connection chasten command: If the user is in the suppression state, this field indicates the number of authentication failure packets received before the user enters the suppression state. If the user is in the check state, this field indicates the number of authentication failure packets received within the check period.
TotalRestrainPkt	If the user is in the suppression state, this field indicates the number of request packets received within the suppression period. If the user is in the check state, the value of this field is displayed as 0.
TotalPassPkt	If the user is in the suppression state, this field indicates the number of request packets sent to the service module successfully before the user enters the suppression state. If the user is in the check state, this field indicates the number of request packets sent to the service module successfully within the check period.