Technical Documentation

show pppoe underlying-interfaces

Syntax

show pppoe underlying-interfaces<brief | detail | extensive><logical-interface-name>

Release Information

Command introduced in Junos OS Release 10.0.

Description

(M120, M320, and MX Series routers only) Display information about PPPoE underlying interfaces.

Options

brief | detail | extensive: (Optional) Display the specified level of output.
logical-interface-name: (Optional) Name of a PPPoE underlying logical interface.

Required Privilege Level

view

List of Sample Output

show pppoe underlying-interfaces brief
show pppoe underlying-interfaces detail
show pppoe underlying-interfaces extensive

Output Fields

Table 1 lists the output fields for the show pppoe underlying-interfaces command. Output fields are listed in the approximate order in which they appear.

Table 1: show pppoe underlying-interfaces Output Fields

Field Name	Field Description	Level of Output
Underlying Interface	Name of the underlying PPPoE logical interface.	All levels
Service Name Table	Name of the service name table.	All levels
Dynamic Profile	Name of the dynamic profile that was used to create this interface. If the interface was statically created, then the value is none.	All levels
Index	Index number of the logical interface, which reflects its initialization sequence.	detail extensive
State	Origin of the logical interface: Static or Dynamic. Indicates whether the interface was statically or dynamically created.	detail extensive
Max Sessions	Maximum number of PPPoE logical interfaces that can be activated on the underlying interface. When this number of logical interfaces has been established, all subsequent PPPoE Active Discovery Initiation (PADI) packets are dropped and all subsequent PPPoE Active Discovery Request (PADR) packets trigger PPPoE Active Discovery Session (PADS) error responses.	detail extensive
Active Sessions	Number of active PPPoE sessions on the underlying interface. If a dynamic profile is listed, then it is the number of active PPPoE sessions on the underlying interface that are using this profile. The Active Sessions value must not exceed the Max Sessions value.	detail extensive
Duplicate Protection	State of PPPoE duplicate protection: On or Off. When duplicate protection is configured for the underlying interface, a dynamic PPPoE logical interface cannot be activated when an existing active logical interface is present for the same PPPoE client. The uniqueness of the PPPoE client is determined by the client's MAC address.	detail extensive
AC Name	Name of the access concentrator.	detail extensive
PacketType	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

Sample Output

show pppoe underlying-interfaces brief

user@host> show pppoe underlying-interfaces
brief

Underlying Interface    Service Name Table    Dynamic Profile
ge-4/0/3.1              Premium               None
ge-4/0/3.2              None                  PppoeProfile

show pppoe underlying-interfaces detail

user@host> show pppoe underlying-interfaces
detail

ge-4/0/3.1 Index 73
  State: Static, Dynamic Profile: None,
  Max Sessions: 4000, Active Sessions: 0,
  Service Name Table: Premium, Duplicate Protection: Off
  AC Name: velorum

ge-4/0/3.2 Index 78
  State: Dynamic, Dynamic Profile: PppoeProfile,
  Max Sessions: 500, Active Sessions: 3,
  Service Name Table: None, Duplicate Protection: On
  AC Name: velorum

show pppoe underlying-interfaces extensive

user@host> show pppoe underlying-interfaces
extensive

ge-4/0/3.1 Index 73
  State: Static, Dynamic Profile: None,
  Max Sessions: 4000, Active Sessions: 0,
  Service Name Table: None, Duplicate Protection: Off,
  AC Name: velorum
  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

ge-4/0/3.2 Index 78
  State: Dynamic, Dynamic Profile: PppoeProfile,
  Max Sessions: 4000, Active Sessions: 3,
  Service Name Table: None, Duplicate Protection: On,
  AC Name: velorum
  PacketType                       Sent         Received
    PADI                              0                5
    PADO                              5                0
    PADR                              0                5
    PADS                              4                0
    PADT                              0                1
    Service name error                0                0
    AC system error                   0                0
    Generic error                     0                0
    Malformed packets                 0                0
    Unknown packets                   0                0