Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

show pppoe interfaces

Syntax

show pppoe interfaces <brief | detail | extensive><pp0.logical>

Release Information

Command introduced before Junos OS Release 7.4.

Description

(J Series Services Routers, M120 routers, M320 routers, and MX Series routers only) Display session-specific information about PPPoE interfaces.

Options

none

Display interface information for all PPPoE interfaces.

brief | detail

(Optional) Display the specified level of output.

extensive

(J Series Services Routers) (Optional) Display information about the number of packets sent and received and the number of timeouts during a PPPoE session.

pp0.logical

(Optional) Name of an interface. The logical unit number for static interfaces can be a value from 0 through 16385. The logical unit number for dynamic interfaces can be a value from 1073741824 through the maximum number of logical interfaces supported on your router.

Required Privilege Level

view

List of Sample Output

show pppoe interfaces
show pppoe interfaces (Status for the Specified Interface)
show pppoe interfaces brief
show pppoe interfaces detail
show pppoe interfaces extensive (J Series Services Routers only)
show pppoe interfaces (PPPoE Subscriber Interface with ACI Interface Set)

Output Fields

Table 1 lists the output fields for the show pppoe interfaces command. Output fields are listed in the approximate order in which they appear. Not all fields are displayed for PPPoE interfaces on M120 and M320 routers in server mode.

Table 1: show pppoe interfaces Output Fields

Field Name

Field Description

Level of Output

Logical Interface 

Logical interface

Name of the logical interface.

All levels

Index

Index number of the logical interface, which reflects its initialization sequence.

detail extensive none

State

State of the logical interface: up or down.

All levels

Session ID

Session ID.

All levels

Type

Origin of the logical interface: Static or Dynamic. Indicates whether the interface was statically or dynamically created.

detail extensive none

Service name

Type of service required (can be used to indicate an ISP name or a class or quality of service).

detail extensive none

Configured AC name

Configured access concentrator name.

detail extensive none

Session AC name

Name of the access concentrator.

detail extensive none

Remote MAC address or Remote MAC

MAC address of the remote side of the connection, either the access concentrator or the PPPoE client.

All levels

Auto-reconnect timeout

(J Series Services Routers only) Time after which to try to reconnect after a PPPoE session is terminated, in seconds.

detail extensive none

Idle timeout

(J Series Services Routers only) Length of time (in seconds) that a connection can be idle before disconnecting.

detail extensive none

Session uptime

Length of time the session has been up, in hh:mm:ss.

detail extensive none

Dynamic Profile

Name of the dynamic profile that was used to create this interface. If the interface was statically created, this field is not displayed.

detail extensive none

Underlying interface

Interface on which PPPoE is running.

All levels

Agent Circuit ID

Agent circuit identifier (ACI) that corresponds to the DSLAM interface that initiated the client service request. An asterisk is interpreted as a wildcard character and can appear at the beginning, the end, or both the beginning and end of the string. If the agent circuit ID is not configured, this field is not displayed.

detail extensive none

Agent Remote ID

Agent remote identifier that corresponds to the subscriber associated with the DSLAM interface that initiated the service request. An asterisk is interpreted as a wildcard character and can appear at the beginning, the end, or both at the beginning and end of the string. If the agent remote ID is not configured, this field is not displayed.

detail extensive none

ACI Interface Set

Internally-generated name of the dynamic ACI interface set, if configured, and the set index number of the ACI entry in the session database.

detail extensive none

Packet Type

Number of packets sent and received during the PPPoE session, categorized by packet type and packet errors:

  • PADI—PPPoE Active Discovery Initiation packets.
  • PADO—PPPoE Active Discovery Offer packets.
  • PADR—PPPoE Active Discovery Request packets.
  • PADS—PPPoE Active Discovery Session-Confirmation packets.
  • PADT—PPPoE Active Discovery Termination packets.
  • Service name error—Packets for which the Service-Name request could not be honored.
  • AC system error—Packets for which the access concentrator experienced an error in performing the host request. For example, the host had insufficient resources to create a virtual circuit.
  • Generic error—Packets that indicate an unrecoverable error occurred.
  • Malformed packets—Malformed or short packets that caused the packet handler to discard the frame as unreadable.
  • Unknown packets—Unrecognized packets.

extensive

Timeout

(J Series Services Routers only) Information about timeouts that occurred during the PPPoE session:

  • PADI—No PADO packet has been received within the timeout period.
  • PADO—No PADR packet has been received within the timeout period. (This value is always zero and is not supported.)
  • PADR—No PADS packet has been received within the timeout period.

extensive

Sample Output

show pppoe interfaces

user@host> show pppoe interfaces
pp0.0 Index 66
  State: Down, Session ID: None,
  Service name: None, Configured AC name: sapphire,
  Session AC name: None, Remote MAC address: 00:00:00:00:00:00,
  Auto-reconnect timeout: 100 seconds, Idle timeout: Never,
  Underlying interface: at-5/0/0.0 Index 71

show pppoe interfaces (Status for the Specified Interface)

user@host> show pppoe interfaces pp0.1073741827
pp0.1073741827 Index 70
  State: Session Up, Session ID: 30, Type: Dynamic,
  Session AC name: velorum,
  Remote MAC address: 00:90:1A:42:0A:C1,
  Session uptime: 16:45:46 ago,
  Underlying interface: ge-2/0/3.1 Index 73
  Service name: premium
  Dynamic Profile: PppoeProfile
  Agent Circuit ID: velorum-ge-2/0/3
  Agent Remote ID: westford

show pppoe interfaces brief

user@host> show pppoe interfaces brief
Interface       Underlying            State       Session    Remote
                interface                         ID         MAC
pp0.0           ge-2/0/3.2            Session Up  27         00:90:1A:42:0A:C1
pp0.1           ge-2/0/3.2            Session Up  28         00:90:1A:42:0A:C1
pp0.1073741824  ge-2/0/3.1            Session Up  29         00:90:1A:42:0A:C1
pp0.1073741825  ge-2/0/3.1            Session Up  30         00:90:1A:42:0A:C1
pp0.1073741826  ge-2/0/3.1            Session Up  31         00:90:1A:42:0A:C1

show pppoe interfaces detail

user@host> show pppoe interfaces detail
pp0.0 Index 66
  State: Down, Session ID: None, Type: Static,
  Service name: None, Configured AC name: sapphire,
  Session AC name: None, Remote MAC address: 00:00:00:00:00:00,
  Auto-reconnect timeout: 100 seconds, Idle timeout: Never,
  Underlying interface: at-5/0/0.0 Index 71

show pppoe interfaces extensive (J Series Services Routers only)

user@host> show pppoe interfaces pp0.1 extensive
pp0.1 Index 66
  State: Down, Session ID: 26, Type: Static,
  Service name: None, Configured AC name: sapphire,
  Session AC name: None, Remote MAC address: 00:00:00:00:00:00,
  Auto-reconnect timeout: 100 seconds, Idle timeout: Never,
  Underlying interface: ge-3/0/3.1 Index 71
  PacketType                       Sent         Received
    PADI                              0                0
    PADO                              0                0
    PADR                              0                6
    PADS                              6                0
    PADT                              6                0
    Service name error                0                0
    AC system error                   0                0
    Generic error                     0                0
    Malformed packets                 0                0
    Unknown packets                   0                0
  Timeout
    PADI                              0
    PADO                              0
    PADR                              0

show pppoe interfaces (PPPoE Subscriber Interface with ACI Interface Set)

user@host> show pppoe interfaces pp0.1073741827
pp0.1073741827 Index 346
  State: Session Up, Session ID: 4, Type: Dynamic,
  Service name: AGILENT, Remote MAC address: 00:00:64:39:01:02,
  Session AC name: nbc,
  Session uptime: 6d 02:22 ago,
  Dynamic Profile: aci-vlan-pppoe-profile,
  Underlying interface: demux0.1073741826 Index 345
  Agent Circuit ID: aci-ppp-dhcp-dvlan-50
  ACI Interface Set: aci-1002-demux0.1073741826 Index 2

Published: 2013-08-01