display access-user online-total-number

Function

The display access-user online-total-number command displays the total number of online users.

Format

For NetEngine 8000 F1A:

display access-user online-total-number ipv4 [ exclude-dual ] [ domain domain-name | type { ppp | l2tp | ip } | { interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] ] | slot slot-id [ card card-id ] } | vpn-instance vpn-instance-name ] ^*

display access-user online-total-number { ipv6 [ exclude-dual ] | dual } [ domain domain-name | type { ppp | l2tp | ip } | ipv6-address-protocol { nd | dhcpv6 } | ipv6-cpe-mode { ipv6 | ipv6-pd } ^* | { interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] ] | slot slot-id [ card card-id ] } | vpn-instance vpn-instance-name ] ^*

display access-user online-total-number { pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] } brief

For NetEngine 8000 F1A, NetEngine 8000 F2A:

display access-user online-total-number [ domain domain-name | type { ppp | l2tp | ip } | { interface { interface-name | interface-type interface-number } [ pevlan pevlan-id [ end-pevlan-id ] [ cevlan cevlan-id [ end-cevlan-id ] ] ] | slot slot-id [ card card-id ] } | vpn-instance vpn-instance-name [ inbound ] ] ^*

Parameters

Parameter	Description	Value
domain domain-name	Specifies the number of online users who belong to a specified domain.	The domain-name is a string of 1 to 64 characters.
type	Indicates the number of online users of a specified access type.	-
ppp	Indicates the number of online users that get online based on PPP.	-
l2tp	Display the number of online LNS users.	-
ip	Indicates the number of online users that get online based on IPoE.	-
ipv4	Indicates the number of IPv4 online users.	-
exclude-dual	Indicates the number of online IPv4 users meeting specified conditions.	-
interface interface-type	Specifies the number of online users that get online from a specified interface.	-
interface-number	Specifies the number of online users that get online from a specified interface.	-
pevlan pevlan-id	Specifies the number of online users of a specified outer VLAN, or displays the start VLANID in the outer VLAN range.	The value is an integer ranging from 0 to 4094.
end-pevlan-id	Specifies the end VLAN ID of the outer VLAN range. end-pevlan-id must be greater than or equal to pevlan vlan-id.	The value ranges from 0 to 4094.
cevlan cevlan-id	Specifies the number of online users of a specified inner VLAN, or the start VLAN ID of the inner VLAN range.	The value is an integer ranging from 0 to 4094.
end-cevlan-id	Specifies the end VLAN ID of the outer VLAN range. end-cevlan-id must be greater than or equal to cevlan vlan-id.	The value is an integer ranging from 0 to 4094.
slot slot-id	Specifies a slot ID. The slot ID range is determined by the device model.	The value is a string of 1 to 15 case-sensitive characters, spaces not supported.
vpn-instance vpn-instance-name	Specifies the number of online users of a specified VPN instance.	The VPN instance name is a string of 1 to 31 characters.
ipv6	Indicates the number of online IPv6 users.	-
ipv6	Indicates the number of online users that use CPE to obtain IPv6 addresses.	-
dual	Indicates the number of dual-stack online users.	-
ipv6-address-protocol	Indicates the number of online users that obtain IPv6 addresses using a specified protocol.	-
nd	Indicates the number of online users that obtain IPv6 addresses using an ND protocol.	-
dhcpv6	Indicates the number of online users that obtain IPv6 addresses using an DHCPv6 protocol.	-
ipv6-cpe-mode	Indicates the number of online users of a specified CPE mode.	-
ipv6-pd	Indicates the number of online users that use CPE to obtain IPv6 prefixes.	-
inbound	Specifies inbound direction.	-
card card-id	Specifies a subcard ID. The subcard ID range is determined by the device model.	The value is an integer that ranges from 0 to 255.
brief	Displays summary of online users, including only the user VLAN IDs, interfaces, and number of online users on these interfaces.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
aaa-access	read

Usage Guidelines

Usage Scenario

This command can be used to view online IPv4, IPv6, or dual-stack users that meet specified conditions.

In L2TP scenarios, LAC users are counted into IPv4 users of the display access-user online-total-number command output; LAC tunnel users are counted into Total users; PPPoLNS users are counted by IP address type, for example, users with IPv4 addresses are counted into IPv4 users, and users with IPv6 addresses are counted into IPv6 users.

Precautions

If the numbers of various types of users are all 0s, the number of queried users based on the specified parameter is 0 or the device does not support query based on the specified parameter.

Example

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

# Display the number of online users on the interfaces with the outer VLAN ID of 1.

<HUAWEI> display access-user online-total-number pevlan 1 brief
--------------------------------------------------------------------------------------------
  Vlan    Interface                access-number   
--------------------------------------------------------------------------------------------
    1/-   Eth-Trunk0.1                       20
    1/-   Eth-Trunk1.2                       0
    1/-   GigabitEthernet0/1/1.1             10
   ---------------------------------------------------------------------------

**Table 1** Description of the **display access-user online-total-number** command output
Item	Description
pevlan	Outer VLAN ID for user access.
Interface	Name of the interface through which the users access the device.
access-number	Number of online users on each displayed interface.