TechLibrary

Navigation

Supported Platforms

show subscribers

Syntax

show subscribers <detail | extensive |terse><aci-interface-set-name aci-interface-set-name><address address><agent-circuit-identifier agent-circuit-identifier-substring><client-type client-type><count><interface interface><logical-system logical-system><mac-address mac-address><physical-interface physical-interface-name><profile-name profile-name><routing-instance routing-instance><stacked-vlan-id stacked-vlan-id><subscriber-state subscriber-state><user-name user-name><vlan-id vlan-id>

Release Information

Command introduced in Junos OS Release 9.3.

Command introduced in Junos OS Release 9.3 for EX Series switches.

client-type, mac-address, subscriber-state, and extensive options introduced in Junos OS Release 10.2.

count option usage with other options introduced in Junos OS Release 10.2.

Command introduced in Junos OS Release 11.1 for the QFX Series.

Options aci-interface-set-name and agent-circuit-identifier introduced in Junos OS Release 12.2.

The physical-interface and user-name options introduced in Junos OS Release 12.3.

Description

Display information for active subscribers.

Options

detail | extensive | 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.168.17.1). If you specify the IP address as a prefix with a netmask (for example, 192.168.17.1/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 the specified client type (DHCP, L2TP, PPP, PPPOE, VLAN, or static).

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.

—

(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.

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.

vlan-id

—

(Optional) Display subscribers whose VLAN ID matches the specified VLAN ID.

stacked-vlan-id

—

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

Note: Due to display limitations, logical system and routing instance output values are truncated when necessary.

Required Privilege Level

view

Related Documentation

EX, J, M, MX, T Series, QFabric System, QFX Series standalone switches
show subscribers summary
MX Series
Verifying and Managing Agent Circuit Identifier-Based Dynamic VLAN Configuration

List of Sample Output

Output Fields

Table 1 lists the output fields for the show subscribers command. Output fields are listed in the approximate order in which they appear.

Table 1: show subscribers Output Fields

Field Name	Field Description
User Name	Name of subscriber.
Type	Subscriber client type (DHCP, L2TP, PPP, PPPoE, STATIC-INTERFACE, VLAN).
IP Address	Subscriber IPv4 address.
IP Netmask	Subscriber IP netmask.
Primary DNS Address	IP address of primary DNS server.
Secondary DNS Address	IP address of secondary DNS server.
Primary WINS Address	IP address of primary WINS server.
Secondary WINS Address	IP address of secondary WINS server.
IPv6 Address	Subscriber IPv6 address, or multiple addresses.
IPv6 Prefix	Subscriber IPv6 prefix. If you are using DHCPv6 prefix delegation, this is the delegated prefix.
IPv6 User Prefix	IPv6 prefix obtained through ND/RA.
IPv6 Address Pool	Subscriber IPv6 address pool. The IPv6 address pool is used to allocate IPv6 prefixes to the DHCPv6 clients.
IPv6 Network Prefix Length	Length of the network portion of the IPv6 address.
IPv6 Prefix Length	Length of the subscriber IPv6 prefix.
Logical System	Logical system associated with the subscriber.
Routing Instance	Routing instance associated with the subscriber.
Interface	Interface associated with the subscriber. The router or switch displays subscribers whose interface matches or begins with the specified interface. The * character indicates a continuation of addresses for the same session.
Interface Type	Whether the subscriber interface is Static or Dynamic.
Interface Set	Internally generated name of the dynamic ACI interface set used by the subscriber session.
Interface Set Type	Interface type of the ACI interface set: Dynamic. This is the only ACI interface set type currently supported.
Interface Set Session ID	Identifier of the dynamic ACI interface set entry in the session database.
Underlying Interface	Name of the underlying interface for the subscriber session.
Dynamic Profile Name	Dynamic profile used for the subscriber.
Dynamic Profile Version	Version number of the dynamic profile used for the subscriber.
MAC Address	MAC address associated with the subscriber.
State	Current state of the subscriber session (Init, Configured, Active, Terminating, Tunneled).
VLAN Id	VLAN ID associated with the subscriber in the form tpid.vlan-id.
Stacked VLAN Id	Stacked VLAN ID associated with the subscriber in the form tpid.vlan-id.
RADIUS Accounting ID	RADIUS accounting ID associated with the subscriber.
Agent Circuit ID	Option 82 agent circuit ID associated with the subscriber. The ID is displayed as an ASCII string unless the value has nonprintable characters, in which case it is displayed in hexadecimal format.
Agent Remote ID	Option 82 agent remote ID associated with the subscriber. The ID is displayed as an ASCII string unless the value has nonprintable characters, in which case it is displayed in hexadecimal format.
DHCP Relay IP Address	IP address used by the DHCP relay agent.
Login Time	Date and time at which the subscriber logged in.
IPv4 rpf-check Fail Filter Name	Name of the filter applied by the dynamic profile to IPv4 packets that fail the RPF check.
IPv6 rpf-check Fail Filter Name	Name of the filter applied by the dynamic profile to IPv6 packets that fail the RPF check.
DHCP Options	len = number of hex values in the message. The hex values specify the type, length, value (TLV) for DHCP options, as defined in RFC 2132.
Session ID	ID number for a subscriber service session.
Underlying Session ID	For DHCPv6 subscribers on a PPPoE network, displays the session ID of the underlying PPPoE interface.
Service Sessions	Number of service sessions (that is, a service activated using RADIUS CoA) associated with the subscribers.
Service Session Name	Service session profile name.
Session Timeout (seconds)	Number of seconds of access provided to the subscriber before the session is automatically terminated.
Idle Timeout (seconds)	Number of seconds subscriber can be idle before the session is automatically terminated.
IPv6 Delegated Address Pool	Name of the pool used for DHCPv6 prefix delegation.
IPv6 Delegated Network Prefix Length	Length of the prefix configured for the IPv6 delegated address pool.
IPv6 Interface Address	Address assigned by the Framed-Ipv6-Prefix AAA attribute.
IPv6 Framed Interface Id	Interface ID assigned by the Framed-Interface-Id AAA attribute.
ADF IPv4 Input Filter Name	Name assigned to the Ascend-Data-Filter (ADF) interface IPv4 input filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style.
ADF IPv4 Output Filter Name	Name assigned to the Ascend-Data-Filter (ADF) interface IPv4 output filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style.
ADF IPv6 Input Filter Name	Name assigned to the Ascend-Data-Filter (ADF) interface IPv6 input filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style.
ADF IPv6 Output Filter Name	Name assigned to the Ascend-Data-Filter (ADF) interface IPv6 output filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style.
IPv4 Input Filter Name	Name assigned to the IPv4 input filter (client or service session).
IPv4 Output Filter Name	Name assigned to the IPv4 output filter (client or service session).
IPv6 Input Filter Name	Name assigned to the IPv6 input filter (client or service session).
IPv6 Output Filter Name	Name assigned to the IPv6 output filter (client or service session).
IFL Input Filter Name	Name assigned to the logical interface input filter (client or service session).
IFL Output Filter Name	Name assigned to the logical interface output filter (client or service session).

Sample Output

show subscribers (IPv4)

user@host> show subscribers

Interface               IP Address/VLAN ID   User Name         LS:RI
ge-1/3/0.1073741824     100                                    default:default
demux0.1073741824       10.0.0.10           WHOLESALER-CLIENT default:default
demux0.1073741825       11.0.0.3            RETAILER1-CLIENT  test1:retailer1
demux0.1073741826       12.0.0.3            RETAILER2-CLIENT  test1:retailer2

show subscribers (IPv6)

user@host> show subscribers

Interface          IP Address/VLAN ID   User Name           LS:RI
ge-1/0/0.0         2001:db8:c0:0:0:0/74    WHOLESALER-CLIENT   default:default
     *             2001:db8:1/128          subscriber-25       default:default

show subscribers (IPv4 and IPv6 Dual Stack)

user@host> show subscribers

Interface           IP Address/VLAN ID         User Name                      LS:RI
demux0.1073741834   0x8100.1002 0x8100.1                                 default:default
demux0.1073741835   0x8100.1001 0x8100.1                                 default:default
pp0.1073741836      61.1.1.1                 dualstackuser1@EXAMPLE1.com     default:ASP-1
*                   2041:1:1::/48
*                   2061:1:1:1::/64
pp0.1073741837      23.1.1.3                 dualstackuser2@EXAMPLE1.com     default:ASP-1
*                   2001:db81:2:5::/64

show subscribers (LNS on MX Series Routers)

user@host> show subscribers

Interface          IP Address/VLAN ID   User Name         LS:RI
si-4/0/0.1         192.168.4.1          xyz@example.com   default:default

show subscribers client-type dhcp detail

user@host> show subscribers client-type dhcp
detail

Type: DHCP
IP Address: 10.20.9.7
IP Netmask: 255.255.0.0
Logical System: default
Routing Instance: default
Interface: demux0.1073744127
Interface type: Dynamic
Dynamic Profile Name: dhcp-demux-prof
MAC Address: 00:10:95:00:00:98
State: Active
Radius Accounting ID: jnpr :2304
Login Time: 2009-08-25 14:43:52 PDT

Type: DHCP
IP Address: 10.20.10.7
IP Netmask: 255.255.0.0
Logical System: default
Routing Instance: default
Interface: demux0.1073744383
Interface type: Dynamic
Dynamic Profile Name: dhcp-demux-prof
MAC Address: 00:10:94:00:01:f3
State: Active
Radius Accounting ID: jnpr :2560
Login Time: 2009-08-25 14:43:56 PDT

show subscribers count

user@host> show subscribers count

Total Subscribers: 188, Active Subscribers: 188

show subscribers address detail (IPv6)

user@host> show subscribers address 10.16.12.137
detail

Type: PPPoE
User Name: pppoeTerV6User1Svc
IP Address: 10.16.12.137
IP Netmask: 255.0.0.0
IPv6 User Prefix: 1016:0:0:c88::/64
Logical System: default
Routing Instance: default
Interface: pp0.1073745151
Interface type: Dynamic
Underlying Interface: demux0.8201
Dynamic Profile Name: pppoe-client-profile
MAC Address: 00:0d:02:01:00:01
Session Timeout (seconds): 31622400
Idle Timeout (seconds): 86400
State: Active
Radius Accounting ID: jnpr demux0.8201:6544
Session ID: 6544
Agent Circuit ID: ifl3720
Agent Remote ID: ifl3720
Login Time: 2012-05-21 13:37:27 PDT
Service Sessions: 1

show subscribers detail (IPv4)