show user-plane subscribers
Syntax
show user-plane subscribers <detail | extensive | terse> <accounting-statistics> <address ip-address> <client-type client-type> <count> <id subscriber-id> <interface interface-name> <license-usage> <mac-address mac-address> <physical-interface physical-interface-name> <routing-instance routing-instance-name> <stacked-vlan-id stacked-vlan-id> <subscriber-state subscriber-state> <Summary> <vlan-id vlan-id>
Description
Displays information for the BNG User Plane subscribers.
Options
| None |
Displays information by interface, IP address or VLAN ID, and LS:RI. |
detail | extensive | terse |
(Optional) Displays the specified level of output. |
accounting-statistics |
Displays subscriber accounting statistics. If you do not configure the statement, the CLI displays a value of 0 for the accounting statistics. |
address ip-address |
(Optional) Display subscribers whose IP address matches the specified address. You must specify the IPv4 or IPv6 address prefix without a netmask (for example, 192.0.2.0). If you specify the IP address as a prefix with a netmask (for example, 192.0.2.0/32), the router displays a message that the IP address is invalid and rejects the command. |
client-type client-type |
(Optional) Display subscribers whose client type matches one of the following client types:
|
count |
(Optional) Displays the count of total subscribers and active subscribers for any specified option. |
id subscriber-id |
(Optional) Displays a subscriber of a session with an ID matching the specific subscriber ID. |
interface interface-name |
(Optional) Displays subscribers with an interface that matches the specified interface. |
license-usage |
(Optional) Displays the license usage for the last 48 hours. |
mac-address mac-address |
(Optional) Displays subscribers with a MAC address that matches the specified MAC address. |
physical-interface
physical-interface-name |
(Optional) Displays subscribers whose physical interface matches the specified physical interface. |
routing-instance
routing-instance-name |
(Optional) Displays subscribers with a routing instance that matches the specified routing instance. |
stacked-vlan-id
stacked-vlan-id |
(Optional) Displays subscribers with a stacked VLAN ID that matches the specified stacked VLAN ID. |
subscriber-state
subscriber-state |
(Optional) Display subscribers whose subscriber state matches the specified subscriber state (ACTIVE, CONFIGURED, INIT, TERMINATED, or TERMINATING). |
summary |
(Optional) Displays summary information for subscribers. |
vlan-id vlan-id |
(Optional) Displays subscribers that have a VLAN ID that
matches the specified VLAN ID, regardless of whether the
subscriber uses a single-tagged or double-tagged VLAN. For
subscribers using a double-tagged VLAN, this option
displays subscribers where the inner VLAN tag matches the
specified VLAN ID. To display only subscribers where the
specified value matches only double-tagged VLANs, use the
|
Because of display limitations, logical system and routing instance output values are truncated when necessary.
Required Privilege Level
view
Output Fields
Table 1 lists the output fields for the show user-plane
subscribers command. Output fields are listed in the
approximate order in which they appear.
|
Field Name |
Field Description |
|---|---|
|
|
Interface associated with the subscriber. The router or switch displays subscribers with interfaces that match or begin with the specified interface. The asterisk (*) character indicates a continuation of addresses for the same session. |
|
|
Subscriber IP address or VLAN ID associated with the subscriber in the form tpid.vlan-id. No IP address or VLAN ID is assigned to a Layer 2
Tunneling Protocol (L2TP) tunnel-switched session.
For these subscriber sessions the value is
|
|
|
Logical system and routing instance associated with the subscriber. |
|
|
Subscriber client type (DHCP, L2TP, PPP, PPPoE, and VLAN). |
|
|
Subscriber IPv4 address. |
|
|
Logical system associated with the subscriber. |
|
|
Routing instance associated with the subscriber. |
|
|
Name of the enhanced subscriber management
logical interface, in the form
|
|
|
Whether the subscriber interface is
|
|
|
Name of the underlying interface for the subscriber session. |
|
|
MAC address associated with the subscriber. |
|
|
Current state of the subscriber session
( |
|
|
Forwarding flow identifier. |
|
|
VLAN ID associated with the subscriber in the form tpid.vlan-id. |
|
|
ID number for a subscriber session. |
|
|
Number of service sessions (that is, a service that is activated using RADIUS CoA) associated with the subscribers. |
|
|
ID number for a subscriber service session. |
|
|
Service session profile name. |
|
|
Name assigned to the IPv4 input filter (client or service session). |
|
|
Name assigned to the IPv4 output filter (client or service session). |
|
|
Time at which the first family in this service became active. |
|
|
How often statistics are collected for the accounting profile. |
|
|
Values for variables that are passed into the dynamic profile from RADIUS. |
|
|
Number of subscribers summarized by state. The summary information includes the following:
|
|
|
Number of subscribers, summarized by client type. Client types can include DHCP, L2TP, PPP, PPPoE, and VLAN. Also displays the total number of subscribers for all client types. |
|
|
Number of subscribers, summarized by logical system:routing instance (LS:RI) combination. Also displays the total number of subscribers for all LS:RI combinations. |
Redundancy
Service Id |
The redundancy service ID number. |
Sample Output
- show user-plane subscribers
- show user-plane subscribers count
- show user-plane subscribers detail
- show user-plane subscribers client-type (PPPoE)
- show user-plane subscribers client-type (DHCP)
- show user-plane subscribers extensive
- show user-plane subscribers interface interface-name extensive
show user-plane subscribers
user@host> show user-plane subscribers
Interface IP Address/VLAN ID LS:RI
demux0.3222276148 0x8100.210 0x8100.209 default:default
demux0.3222276149 0x8100.210 0x8100.210 default:default
demux0.3222276150 0x8100.210 0x8100.211 default:default
demux0.3222276151 0x8100.210 0x8100.212 default:default
demux0.3222276152 0x8100.210 0x8100.213 default:default
demux0.3222276153 0x8100.210 0x8100.214 default:default
demux0.3222276154 0x8100.210 0x8100.215 default:default
demux0.3222276155 0x8100.210 0x8100.216 default:default
demux0.3222276156 0x8100.210 0x8100.217 default:default
demux0.3222276157 0x8100.210 0x8100.218 default:default
demux0.3222276158 192.168.10.254 default:default
demux0.3222276159 192.168.10.252 default:default
demux0.3222276160 192.168.10.253 default:default
demux0.3222276161 192.168.10.248 default:default
demux0.3222276162 192.168.10.249 default:default
demux0.3222276163 192.168.10.250 default:default
show user-plane subscribers count
user@host> show user-plane subscribers count Total Subscribers: 1, Active Subscribers: 1
show user-plane subscribers detail
user@host> show user-plane subscribers detail Oct 15 11:03:30 Type: VLAN Logical System: default Routing Instance: default Interface: demux0.3221749760 Interface type: Dynamic Underlying Interface: ps1.32767 State: Active Session ID: 43 PFE Flow ID: 537395225 VLAN Id: 1 Stacked VLAN Id: 100 Type: DHCP IP Address: 5.0.0.102 Logical System: default Routing Instance: default Interface: demux0.3221749761 Interface type: Dynamic Underlying Interface: demux0.3221749760 MAC Address: 00:21:01:00:00:01 State: Active Session ID: 44 PFE Flow ID: 537395227 VLAN Id: 1 Stacked VLAN Id: 100 SGRP ID: 3 Type: VLAN Logical System: default Routing Instance: default Interface: demux0.3221749762 Interface type: Dynamic Underlying Interface: ps1.32767 State: Active Session ID: 45 PFE Flow ID: 537395228 VLAN Id: 100 Stacked VLAN Id: 100 Type: PPPoE IP Address: 5.0.0.103 Logical System: default Routing Instance: default Interface: pp0.3221749763 Interface type: Dynamic Underlying Interface: demux0.3221749762 MAC Address: 00:23:01:00:00:01 State: Active Session ID: 46 PFE Flow ID: 537395229 VLAN Id: 100 Stacked VLAN Id: 100 SGRP ID: 3
show user-plane subscribers client-type (PPPoE)
user@host> show user-plane subscribers client-type pppoe Oct 15 11:03:36 Interface IP Address/VLAN ID LS:RI pp0.3221749763 5.0.0.103 default:default
show user-plane subscribers client-type (DHCP)
user@host> show user-plane subscribers client-type dhcp Oct 15 11:03:39 Interface IP Address/VLAN ID LS:RI demux0.3221749761 5.0.0.102 default:default
show user-plane subscribers extensive
user@host> show user-plane subscribers extensive Oct 15 11:03:42 Type: VLAN Logical System: default Routing Instance: default Interface: demux0.3221749760 Interface type: Dynamic Underlying Interface: ps1.32767 State: Active Session ID: 43 PFE Flow ID: 537395225 VLAN Id: 1 Stacked VLAN Id: 100 Type: DHCP IP Address: 5.0.0.102 Logical System: default Routing Instance: default Interface: demux0.3221749761 Interface type: Dynamic Underlying Interface: demux0.3221749760 MAC Address: 00:21:01:00:00:01 State: Active Session ID: 44 PFE Flow ID: 537395227 VLAN Id: 1 Stacked VLAN Id: 100 SGRP ID: 3 Type: VLAN Logical System: default Routing Instance: default Interface: demux0.3221749762 Interface type: Dynamic Underlying Interface: ps1.32767 State: Active Session ID: 45 PFE Flow ID: 537395228 VLAN Id: 100 Stacked VLAN Id: 100 Type: PPPoE IP Address: 5.0.0.103 Logical System: default Routing Instance: default Interface: pp0.3221749763 Interface type: Dynamic Underlying Interface: demux0.3221749762 MAC Address: 00:23:01:00:00:01 State: Active Session ID: 46 PFE Flow ID: 537395229 VLAN Id: 100 Stacked VLAN Id: 100 SGRP ID: 3
show user-plane subscribers interface interface-name extensive
user@host> show user-plane subscribers interface interface-name extensive Type: PPPoE IP Address: 192.168.1.199 Logical System: default Routing Instance: default Interface: pp0.3221749860 Interface type: Dynamic Underlying Interface: demux0.3221749760 MAC Address: 00:00:64:08:01:65 State: Active Session ID: 111 PFE Flow ID: 537395323 VLAN Id: 1000 Stacked VLAN Id: 1000 SGRP ID: 2048 Redundancy Service Id: