Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

show services pcef subscribers

Syntax

Description

Displays information for Junos OS Subscriber Management subscribers who are a using policy control and enforcement function (PCEF) profile to define the treatment to apply to packets associated with specific applications (for example, Facebook) or to specific service data flows.

Options

detail | extensive | summary | terse

(Optional) Display the specified level of output.

aci-interface-set-name

(Optional) Display all dynamic subscriber sessions that use the specified agent circuit identifier (ACI) interface set. Use the ACI interface set name generated by the router, such as aci-1003-ge-1/0/0.4001, and not the actual ACI value found in the DHCP or PPPoE control packets.
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.
agent-circuit-identifier-substring

(Optional) Display all dynamic subscriber sessions whose ACI value matches the specified substring.
client-type

(Optional) Display subscribers whose client type matches one of the following client types:

  • dhcp—DHCP clients only.

  • dotlx—Dotlx clients only.

  • essm—ESSM clients only.

  • fwauth—FwAuth (authenticated across a firewall) clients only.

  • l2tp—L2TP clients only.

  • mlppp—MLPPP clients only.

  • ppp—PPP clients only.

  • pppoe—PPPoE clients only.

  • static—Static clients only.

  • vlan—VLAN clients only.

  • vpls-pw—VPLS pseudowire clients only.

  • xauth—Xauth clients only.
count

(Optional) Display the count of total subscribers and active subscribers for any specified option. You can use the count option alone or with the address, client-type, interface, logical-system, mac-address, profile-name, routing-instance, stacked-vlan-id, subscriber-state, or vlan-id options.
id

(Optional) Display a specific subscriber session whose session id matches the specified subscriber ID. You can display subscriber IDs by using the show subscribers extensive or the show subscribers interface extensive commands.

interface

(Optional) Display subscribers whose interface matches the specified interface.

logical-system

(Optional) Display subscribers whose logical system matches the specified logical system.
mac-address

(Optional) Display subscribers whose MAC address matches the specified MAC address.
physical-interface-name

(M120, M320, and MX Series routers only) (Optional) Display subscribers whose physical interface matches the specified physical interface.
profile-name

(Optional) Display subscribers whose dynamic profile matches the specified profile name.
routing-instance

(Optional) Display subscribers whose routing instance matches the specified routing instance.
stacked-vlan-id

(Optional) Display subscribers whose stacked VLAN ID matches the specified stacked VLAN ID.
subscriber-state

(Optional) Display subscribers whose subscriber state matches the specified subscriber state (ACTIVE, CONFIGURED, INIT, TERMINATED, or TERMINATING).
user-name

(M120, M320, and MX Series routers only) (Optional) Display subscribers whose username matches the specified subscriber name.
vci-identifier

(MX Series routers with MPCs and ATM MICs with SFP only) (Optional) Display active ATM subscribers whose ATM virtual circuit identifier (VCI) matches the specified VCI identifier. The range of values is 0 through 255.
vpi-identifier

(MX Series routers with MPCs and ATM MICs with SFP only) (Optional) Display active ATM subscribers whose ATM virtual path identifier (VPI) matches the specified VPI identifier. The range of values is 0 through 65,535.
vlan-id

(Optional) Display subscribers whose VLAN ID 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 stacked-vlan-id stacked-vlan-id option to match the outer VLAN tag.
Note:

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 services pcef subscribers command. Output fields are listed in the approximate order in which they appear.

Table 1: show services pcef subscribers Output Fields

Field Name

Field Description

Level of Output

Interface

Interface associated with the subscriber.

detail

extensive

terse

IP Address

Subscriber IPv4 or IPv6 address.

detail

extensive

terse

User Name

Name of subscriber.

detail

extensive

terse

Packets

Number of the subscriber’s packets that are processed by a PCEF profile.

  • Input—Input packets.

  • Output—Output packets.

terse

Packet Drops

Number of the subscriber’s packets that were dropped as a result of being processed by a PCEF profile.

  • Input—Input packets.

  • Output—Output packets.

terse

Session ID

ID number for a subscriber service session.

extensive

detail

PFE Flow ID

Variable-based forwarding flow ID.

extensive

detail

PCEF profile

PCEF profile that is assigned to the subscriber.

extensive

detail

Routing Instance

Routing instance associated with the subscriber.

extensive

detail

Service VRF

extensive

detail

Service set

Service set that is performing policy control.

extensive

detail

Input packets

Number of the subscriber’s input packets that are processed by a PCEF profile.

extensive

detail

Input octet

Number of the subscriber’s input octets that are processed by a PCEF profile.

extensive

detail

Output packets

Number of the subscriber’s output packets that are processed by a PCEF profile.

extensive

detail

Output octet

Number of the subscriber’s output octets that are processed by a PCEF profile.

extensive

detail

Input drops

Number of the subscriber’s input packets that were dropped as a result of being processed by a PCEF profile.

extensive

detail

Input drop bytes

Number of the subscriber’s input bytes that were dropped as a result of being processed by a PCEF profile.

extensive

detail

Output drops

Number of the subscriber’s output packets that were dropped as a result of being processed by a PCEF profile.

extensive

detail

Output drop bytes

Number of the subscriber’s output bytes that were dropped as a result of being processed by a PCEF profile.

extensive

detail

Rule count

Number of PCC rules that were applied to subscriber’s traffic.

extensive

detail

Rule information

For each PCC rule that is assigned to the subscriber, the following information appears:

  • Rule name—Name of PCC rule.

  • In sessions—Number of incoming sessions for the subscriber that are processed by the rule.

  • Out sessions—Number of outgoing sessions for the subscriber that are processed by the rule.

  • Input packets—Number of input packets and bytes for the subscriber that are processed by the rule.

  • Output packets—Number of output packets and bytes for the subscriber that are processed by the rule.

  • Input drop packets—Number of input packets and bytes for the subscriber that are dropped by the rule.

  • Output drop packets—Number of output packets and bytes for the subscriber that are dropped by the rule.

extensive

detail

Total subscribers

Total number of subscribers.

summary

Sample Output

show services pcef subscribers terse

show services pcef subscribers extensive

Sample Output

show services pcef subscribers summary

Release Information

Command introduced in Junos OS Release 17.2.

Related Documentation