Technical Documentation

show subscribers

Syntax

show subscribers <address address><count><interface interface><logical-system logical-system><profile-name profile-name><routing-instance routing-instance><vlan-id vlan-id><stacked-vlan-id stacked-vlan-id><detail | terse>

Release Information

Command introduced in JUNOS Release 9.3.

Command introduced in JUNOS Release 9.3 for EX Series switches.

Description

Display information for active subscribers.

Options

address

(Optional) Display subscribers whose IP address matches the specified address.

count

(Optional) Display the specified count. The count option cannot be used with any other options.

interface

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

logical system

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

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.

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.

detail | terse

(Optional) Display the specified level of output.

Required Privilege Level

view

List of Sample Output

show subscribers
show subscribers detail
show subscribers logical-system
show subscribers count
show subscribers vlan-id
show subscribers vlan-id detail
show subscribers stacked-vlan-id detail
show subscribers stacked-vlan-id vlan-id detail (combined output)
show subscribers stacked-vlan-id vlan-id interface detail (combined output for a specific interface)

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.

IP Address

Subscriber IP address. Both IPv4 and IPv6 addresses are supported.

IP Netmask

Subscriber IP netmask.

Logical System

Logical system associated with the subscriber.

Interface

Interface associated with the subscriber. The router displays subscribers whose interface matches or begins with the specified interface.

Interface Type

Whether the subscriber interface is static or dynamic.

Dynamic Profile Name

Dynamic profile used for the subscriber.

Routing Instance

Routing instance associated with the subscriber.

MAC Address

MAC address associated with the subscriber.

State

Current status of the subscriber session.

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.

DHCP Relay IP Address

IP address used by the DHCP relay agent.

Login Time

Date and time at which the subscriber logged in.

Sample Output

show subscribers

user@host> show subscribers 
                                                    
Interface       IP Address                                 User Name
ge-0/0/0.0      192.168.15.10                              user@isp5555.net   
ge-0/0/0.1      1234:5678:9012:3456:7890:1234:5678:9012    useripv6@isp5555.net

show subscribers detail

user@host> show subscribers detail 
Type: DHCP
User Name: igmp-user1
IP Address: 192.168.1.10
IP Netmask: 255.255.0.0
Logical System: default
Routing Instance: default
Interface: demux0.1073741824
Interface type: Static
Dynamic Profile Name: user-profile–15
MAC Address: 00:00:65:02:01:02
State: Active
Radius Accounting ID: 1
DHCP Relay IP Address: 192.168.32.2
Login Time: 2008-10-08 08:22:12 PDT

show subscribers logical-system

user@host> show subscribers logical-system default terse 
Interface         User Name            Ip Address
ge-0/0/0.1        user1@isp5555.net    192.168.15.10
ge-0/0/0.2        user2@isp5555.net    2001:0db8:0:22:3300:4040:1428:57ab

show subscribers count

user@host> show subscribers count 
Total Subscribers: 2, Active Subscribers: 2

show subscribers vlan-id

user@host> show subscribers vlan-id 100
Interface           IP Address                              User Name
ge-1/0/0.1073741824
ge-1/2/0.1073741825

show subscribers vlan-id detail

user@host> show subscribers vlan-id 100 detail
Type: VLAN
Interface: ge-1/0/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: vlan-prof-tpid
State: Active
VLAN Id: 100
Login Time: 2009-03-11 06:48:54 PDT

Type: VLAN
Interface: ge-1/2/0.1073741825
Interface type: Dynamic
Dynamic Profile Name: vlan-prof-tpid
State: Active
VLAN Id: 100
Login Time: 2009-03-11 06:48:54 PDT

show subscribers stacked-vlan-id detail

user@host> show subscribers stacked-vlan-id 101 detail
Type: VLAN
Interface: ge-1/2/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: svlan-prof
State: Active
Stacked VLAN Id: 0x8100.101
VLAN Id: 0x8100.100
Login Time: 2009-03-27 11:57:19 PDT

show subscribers stacked-vlan-id vlan-id detail (combined output)

user@host> show subscribers stacked-vlan-id 101 vlan-id 100 detail
Type: VLAN
Interface: ge-1/2/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: svlan-prof
State: Active
Stacked VLAN Id: 0x8100.101
VLAN Id: 0x8100.100
Login Time: 2009-03-27 11:57:19 PDT

show subscribers stacked-vlan-id vlan-id interface detail (combined output for a specific interface)

user@host> show subscribers stacked-vlan-id 101 vlan-id 100 interface ge-1/2/0.* detail
Type: VLAN
Interface: ge-1/2/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: svlan-prof
State: Active
Stacked VLAN Id: 0x8100.101
VLAN Id: 0x8100.100
Login Time: 2009-03-27 11:57:19 PDT

Published: 2010-01-13