Technical Documentation

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 | extensive: (Optional) Display the specified level of output.
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, M120 routers, and M320 routers only)

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 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
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, M120 routers, and M320 routers only)

user@host> show pppoe interfaces extensive

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
  PacketType                       Sent         Received
    PADI                              0                0
    PADO                              0                0
    PADR                              0                0
    PADS                              0                0
    PADT                              0                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