display cpe-user information

Function

The display cpe-user information command displays information about the online user (CPE).

Format

display cpe-user information [ cpe-ipv4 ipv4-address | cpe-ipv6 ipv6-address | statistic ] [ slot slot-number [ cpu cpu-number ] ] [ vsys vsys-name ]

Parameters

Parameter	Description	Value
ipv4-address	Specifies the IPv4 address of the CPE.	The address is in the X.X.X.X format.
ipv6-address	Specifies the IPv6 address of the CPE.	The address is in the X:X::X:X format.
slot-number	Specifies the slot ID. Only the USG6635E/6655E, USG6680E and USG6712E/6716E support this parameter.	-
cpu-number	Specifies the CPU ID. Only the USG6635E/6655E, USG6680E and USG6712E/6716E support this parameter.	The value ranges from 0 to 3.
statistic	Specifies the number of the user table.	-
vsys-name	Displays information about the specified virtual system.	The value is a string of 1 to 31 characters starting with a digit or letter and contains only letters, digits, underscores (_), and spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the port pre-allocation and incremental allocation feature is used in the NAT444 scenario, run the display cpe-user information cpe-ipv4 ipv4-address command to check the information about the online user (CPE).
If the port pre-allocation and incremental allocation feature is used in the DS-Lite scenario, run the display cpe-user information cpe-ipv6 ipv6-address command to check the information about the online user (CPE).

Example

# Display user table information after the port pre-allocation and incremental allocation feature is used.

[sysname] display cpe-user information cpe-ipv4 10.1.1.1 slot 6 cpu 0
 This operation will take a few minutes. Press 'Ctrl+C' to break ...
 UserTbl item(s) on slot 6 cpu 0                                    
 --------------------------------------------------------------------
 Scene: NAT444  DstZone: untrust CPEIP: 10.1.1.1                 
 TTL: 40   LeftTime: 34 Increase Count: 0  VPN: public                
 PoolID: addressgroup1  SectionID: 1  PublicIP: 1.1.2.2  StartPort: 2048
 PortNumber: 256  PortTotal: 256  Used Port Number: 0

Table 1 shows the description of the display cpe-user information command output.

**Table 1** Description of the **display cpe-user information** command output
Item	Description
Scene	Scenario field
DstZone	Destination security zone
CPEIP	IP address of the CPE
TTL	Aging time of the user table entry
LeftTime	Remaining aging time of the user table entry
Increase Count	Number of incremental allocations
VPN	Virtual system
PoolID	Address pool name
SectionID	ID of an IP address segment in the address pool
PublicIP	Translated public IP address
StartPort	Start port of the pre-allocated port range
PortNumber	Number of ports in the pre-allocated port range
PortTotal	Total number of allocated ports
Used Port Number	Number of used ports NOTE: 5-Tuple NAT can distinguish service flows in sessions based on destination addresses and ports. When 5-tuple NAT port pre-allocation is used, the source port can be reused, and the number of used ports (Used Port Number) is not counted. That is, the displayed value is always 0, but services are not affected.

# Display user table information after static mapping is used.

[sysname] display cpe-user information cpe-ipv4 10.1.1.1 slot 6 cpu 0
 This operation will take a few minutes. Press 'Ctrl+C' to break ...              
 UserTbl item(s) on slot 6 cpu 0                                                
 --------------------------------------------------------------------             
 Scene: NAT444  DstZone: untrust  CPEIP: 10.1.1.1
 TTL: 40   LeftTime: 40 Increase Count: 0  VPN: public
 StaticMapping ID: 1 PublicIP: 1.1.2.1  StartPort: 14336
 PortNumber: 256  PortTotal: 256  Used Port Number: 0

Table 2 shows the description of the display cpe-user information command output.

**Table 2** Description of the **display cpe-user information** command output
Item	Description
Scene	Scenario field
DstZone	Destination security zone
CPEIP	IP address of the CPE
TTL	Aging time of the user table entry
LeftTime	Remaining aging time of the user table entry
Increase Count	Number of incremental allocations
VPN	Specified the virtual system
StaticMapping ID	Specifies the index of the static mapping.
PublicIP	Translated public IP address
StartPort	Start port of the pre-allocated port range
PortNumber	Number of ports in the pre-allocated port range
PortTotal	Total number of allocated ports
Used Port Number	Number of used ports NOTE: 5-Tuple NAT can distinguish service flows in sessions based on destination addresses and ports. When 5-tuple NAT port pre-allocation is used, the source port can be reused, and the number of used ports (Used Port Number) is not counted. That is, the displayed value is always 0, but services are not affected.

# Display user table statistics.

[sysname] display cpe-user information statistic
This operation will take a few minutes. Press 'Ctrl+C' to break ... 
UserTbl statistic result on slot 6 cpu 0 
------------------------------------------- 
NAT64 Usertbl(s): 0    
DS-Lite Usertbl(s): 0 
NAT444 Usertbl(s): 100

Table 3 describes the output of the display cpe-user information statistic command.

**Table 3** Description of the **display cpe-user information statistic** command output
Item	Description
NAT64 Usertbl(s)	Number of NAT64 user tables
DS-Lite Usertbl(s)	Number of DS-Lite user tables
NAT444 Usertbl(s)	Number of NAT444 user tables