Technical Documentation

show interfaces (PPPoE)

Syntax

show interfaces pp0.logical <brief | detail | extensive | terse> <descriptions><media><snmp-index snmp-index><statistics>

Release Information

Command introduced before Junos OS Release 7.4.

Description

(J Series Services Routers, M120 routers, and M320 routers only) Display status information about the PPPoE interface.

Options

pp0.logical: Display standard status information about the PPPoE interface.
brief | detail | extensive | terse: (Optional) Display the specified level of output.
descriptions: (Optional) Display interface description strings.
media: (Optional) Display media-specific information about PPPoE interfaces.
snmp-index snmp-index: (Optional) Display information for the specified SNMP index of the interface.
statistics: (Optional) Display PPPoE interface statistics.

Required Privilege Level

view

List of Sample Output

show interfaces (PPPoE)
show interfaces brief (PPPoE)
show interfaces detail (PPPoE)
show interfaces detail (PPPoE on J Series Services Routers)
show interfaces extensive (PPPoE on M120 and M320 Internet Router)

Output Fields

Table 1 lists the output fields for the show interfaces (PPPoE) command. Output fields are listed in the approximate order in which they appear.

Table 1: show interfaces (PPPoE) Output Fields

Field Name	Field Description	Level of Output
Physical Interface
Physical interface	Name of the physical interface.	All levels
Enabled	State of the interface. Possible values are described in the “Enabled Field” section under Common Output Fields Description.	All levels
Interface index	Physical interface index number, which reflects its initialization sequence.	detail extensive none
SNMP ifIndex	SNMP index number for the physical interface.	detail extensive none
Generation	Unique number for use by Juniper Networks technical support only.	detail extensive
Type	Physical interface type (PPPoE).	All levels
Link-level type	Encapsulation on the physical interface (PPPoE).	All levels
MTU	MTU size on the physical interface.	All levels
Clocking	Reference clock source. It can be Internal or External.	All levels
Speed	Speed at which the interface is running.	All levels
Device flags	Information about the physical device. Possible values are described in the “Device Flags” section under Common Output Fields Description.	All levels
Interface flags	Information about the interface. Possible values are described in the “Interface Flags” section under Common Output Fields Description.	All levels
Link type	Physical interface link type: full duplex or half duplex.	All levels
Link flags	Information about the interface. Possible values are described in the “Link Flags” section under Common Output Fields Description.	All levels
Input rate	Input rate in bits per second (bps) and packets per second (pps).	None specified
Output rate	Output rate in bps and pps.	None specified
Physical Info	Physical interface information.	All levels
Hold-times	Current interface hold-time up and hold-time down, in milliseconds.	detail extensive
Current address	Configured MAC address.	detail extensive
Hardware address	MAC address of the hardware.	detail extensive
Alternate link address	Backup address of the link.	detail extensive
Statistics last cleared	Time when the statistics for the interface were last set to zero.	detail extensive
Traffic statistics	Number and rate of bytes and packets received and transmitted on the physical interface. Input bytes—Number of bytes received on the interface. Output bytes—Number of bytes transmitted on the interface. Input packets—Number of packets received on the interface. Output packets—Number of packets transmitted on the interface.	detail extensive
IPv6 transit statistics	Number of IPv6 transit bytes and packets received and transmitted on the physical interface if IPv6 statistics tracking is enabled. Input bytes—Number of bytes received on the interface. Output bytes—Number of bytes transmitted on the interface. Input packets—Number of packets received on the interface. Output packets—Number of packets transmitted on the interface.	detail extensive
Input errors	Input errors on the interface: Errors—Sum of incoming frame aborts and FCS errors. Drops—Number of packets dropped by the input queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism. Framing errors—Number of packets received with an invalid frame checksum (FCS). Runts—Number of frames received that are smaller than the runt threshold. Giants—Number of frames received that are larger than the giant threshold. Policed discards—Number of frames that the incoming packet match code discarded because they were not recognized or not of interest. Usually, this field reports protocols that the Junos OS does not handle. Resource errors—Sum of B chip Tx drops and IXP Tx net transmit drops.	extensive
Output errors	Output errors on the interface. The following paragraphs explain the counters whose meaning might not be obvious: Carrier transitions —Number of times the interface has gone from down to up. This number does not normally increment quickly, increasing only when the cable is unplugged, the far-end system is powered down and then up, or another problem occurs. If the number of carrier transitions increments quickly (perhaps once every 10 seconds), then the cable, the far-end system, or the PIM is malfunctioning. Errors—Sum of the outgoing frame aborts and FCS errors. Drops—Number of packets dropped by the output queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism. MTU errors—Number of packets whose size exceeded the MTU of the interface. Resource errors—Sum of B chip Tx drops and IXP Tx net transmit drops.	extensive
Logical Interface
Logical interface	Name of the logical interface.	All levels
Index	Logical interface index number (which reflects its initialization sequence).	detail extensive none
SNMP ifIndex	Logical interface SNMP interface index number.	detail extensive none
Generation	Unique number for use by Juniper Networks technical support only.	detail extensive
Flags	Information about the logical interface. Possible values are described in the “Logical Interface Flags” section under Common Output Fields Description.	All levels
Encapsulation	Type of encapsulation configured on the logical interface.	All levels
PPP parameters	PPP status: LCP restart timer—Length of time (in milliseconds) between successive Link Control Protocol (LCP) configuration requests. NCP restart timer—Length of time (in milliseconds) between successive Network Control Protocol (NCP) configuration requests.	detail
PPPoE	PPPoE status: State—State of the logical interface (up or down). Session ID—PPPoE session ID. Service name—Type of service required. Can be used to indicate an Internet service provider (ISP) name or a class or quality of service. Configured AC name—Configured access concentrator name. Auto-reconnect timeout—Time after which to try to reconnect after a PPPoE session is terminated, in seconds. Idle Timeout—Length of time (in seconds) that a connection can be idle before disconnecting. Underlying interface—Interface on which PPPoE is running.	All levels
Traffic statistics	Total number of bytes and packets received and transmitted on the logical interface. These statistics are the sum of the local and transit statistics. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. This counter usually takes less than 1 second to stabilize.	detail extensive
IPv6 transit statistics	Number of IPv6 transit bytes and packets received and transmitted on the logical interface if IPv6 statistics tracking is enabled. Input bytes—Number of bytes received on the interface. Output bytes—Number of bytes transmitted on the interface. Input packets—Number of packets received on the interface. Output packets—Number of packets transmitted on the interface.	detail extensive
Local statistics	Statistics for traffic received from and transmitted to the Routing Engine. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. This counter usually takes less than 1 second to stabilize.	detail extensive
Transit statistics	Statistics for traffic transiting the router. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. This counter usually takes less than 1 second to stabilize.	detail extensive
Keepalive settings	(PPP and HDLC) Configured settings for keepalives. interval seconds—The time in seconds between successive keepalive requests. The range is 10 seconds through 32,767 seconds, with a default of 10 seconds. down-countnumber—The number of keepalive packets a destination must fail to receive before the network takes a link down. The range is 1 through 255, with a default of 3. up-count number—The number of keepalive packets a destination must receive to change a link’s status from down to up. The range is 1 through 255, with a default of 1.	detail extensive
Keepalive statistics	(PPP and HDLC) Information about keepalive packets. Input—Number of keepalive packets received by PPP. (last seen 00:00:00 ago)—Time the last keepalive packet was received, in the format hh:mm:ss. Output—Number of keepalive packets sent by PPP and how long ago the last keepalive packets were sent and received. (last seen 00:00:00 ago)—Time the last keepalive packet was sent, in the format hh:mm:ss.	detail extensive
Input packets	Number of packets received on the logical interface.	None specified
Output packets	Number of packets transmitted on the logical interface.	None specified
LCP state	(PPP) Link Control Protocol state. Conf-ack-received—Acknowledgement was received. Conf-ack-sent—Acknowledgement was sent. Conf-req-sent—Request was sent. Down—LCP negotiation is incomplete (not yet completed or has failed). Not-configured—LCP is not configured on the interface. Opened—LCP negotiation is successful.	none detail extensive
NCP state	(PPP) Network Control Protocol state. Conf-ack-received—Acknowledgement was received. Conf-ack-sent—Acknowledgement was sent. Conf-req-sent—Request was sent. Down—NCP negotiation is incomplete (not yet completed or has failed). Not-configured—NCP is not configured on the interface. Opened—NCP negotiation is successful.	detail extensive none
CHAP state	(PPP) Displays the state of the Challenge Handshake Authentication Protocol (CHAP) during its transaction. Chap-Chal-received—Challenge was received but response not yet sent. Chap-Chal-sent—Challenge was sent. Chap-Resp-received—Response was received for the challenge sent, but CHAP has not yet moved into the Success state. (Most likely with RADIUS authentication.) Chap-Resp-sent—Response was sent for the challenge received. Closed—CHAP authentication is incomplete. Failure—CHAP authentication failed. Not-configured—CHAP is not configured on the interface. Success—CHAP authentication was successful.	none detail extensive
Protocol	Protocol family configured on the logical interface.	detail extensive none
protocol-family	Protocol family configured on the logical interface. If the protocol is inet, the IP address of the interface is also displayed.	brief
MTU	MTU size on the logical interface.	detail extensive none
Generation	Unique number for use by Juniper Networks technical support only.	detail extensive
Route table	Routing table in which the logical interface address is located. For example, 0 refers to the routing table inet.0.	detail extensive none
Flags	Information about the protocol family flags. Possible values are described in the “Family Flags” section under Common Output Fields Description.	detail extensive none
Addresses, Flags	Information about the addresses configured for the protocol family. Possible values are described in the “Addresses Flags” section under Common Output Fields Description.	detail extensive none
Destination	IP address of the remote side of the connection.	detail extensive none
Local	IP address of the logical interface.	detail extensive none
Broadcast	Broadcast address.	detail extensive none

Sample Output

show interfaces (PPPoE)

user@host> show interfaces pp0

Physical interface: pp0, Enabled, Physical link is Up
  Interface index: 128, SNMP ifIndex: 24
  Type: PPPoE, Link-level type: PPPoE, MTU: 1532
  Device flags   : Present Running
  Interface flags: Point-To-Point SNMP-Traps
  Link type      : Full-Duplex
  Link flags     : None
  Input rate     : 0 bps (0 pps)
  Output rate    : 0 bps (0 pps)
  
  Logical interface pp0.0 (Index 72) (SNMP ifIndex 72) 
    Flags: Hardware-Down Point-To-Point SNMP-Traps 0x4000 Encapsulation: PPPoE
    PPPoE:
      State: SessionDown, Session ID: None,
      Service name: None, Configured AC name: sapphire, 
      Auto-reconnect timeout: 100 seconds, Idle timeout: Never,
      Underlying interface: at-5/0/0.0 (Index 70)
  Input packets : 0 
  Output packets: 0
  LCP state: Not-configured
  NCP state: inet: Not-configured, inet6: Not-configured, iso: Not-configured,   mpls: Not-configured
  CHAP state: Closed
    Protocol inet, MTU: 100
      Flags: User-MTU, Negotiate-Address

show interfaces brief (PPPoE)

user@host> show interfaces pp0 brief

Physical interface: pp0, Enabled, Physical link is Up
  Type: PPPoE, Link-level type: PPPoE, MTU: 1532, Speed: Unspecified
  Device flags   : Present Running
  Interface flags: Point-To-Point SNMP-Traps

  Logical interface pp0.0 
    Flags: Hardware-Down Point-To-Point SNMP-Traps 0x4000 Encapsulation: PPPoE
    PPPoE:
      State: SessionDown, Session ID: None,
      Service name: None, Configured AC name: sapphire, 
      Auto-reconnect timeout: 100 seconds, Idle timeout: Never,
      Underlying interface: at-5/0/0.0 (Index 70)
    inet

show interfaces detail (PPPoE)

user@host> show interfaces pp0 detail

Physical interface: pp0, Enabled, Physical link is Up
  Interface index: 128, SNMP ifIndex: 24, Generation: 9
  Type: PPPoE, Link-level type: PPPoE, MTU: 1532, Speed: Unspecified
  Device flags   : Present Running
  Interface flags: Point-To-Point SNMP-Traps
  Link type      : Full-Duplex
  Link flags     : None
  Physical info  : Unspecified
  Hold-times     : Up 0 ms, Down 0 ms
  Current address: Unspecified, Hardware address: Unspecified
  Alternate link address: Unspecified
  Statistics last cleared: Never
  Traffic statistics:
   Input  bytes  :                    0                    0 bps
   Output bytes  :                    0                    0 bps
   Input  packets:                    0                    0 pps
   Output packets:                    0                    0 pps
  Logical interface pp0.0 (Index 72) (SNMP ifIndex 72) (Generation 14)
    Flags: Hardware-Down Point-To-Point SNMP-Traps 0x4000 Encapsulation: PPPoE
    PPPoE:
      State: SessionDown, Session ID: None,
      Service name: None, Configured AC name: sapphire, 
      Auto-reconnect timeout: 100 seconds, Idle timeout: Never,
      Underlying interface: at-5/0/0.0 (Index 70)
    Traffic statistics:
     Input  bytes  :                    0
     Output bytes  :                    0
     Input  packets:                    0
     Output packets:                    0
    Local statistics:
     Input  bytes  :                    0
     Output bytes  :                    0
     Input  packets:                    0
     Output packets:                    0
    Transit statistics:
     Input  bytes  :                    0                    0 bps
     Output bytes  :                    0                    0 bps
     Input  packets:                    0                    0 pps
     Output packets:                    0                    0 pps
  LCP state: Not-configured
  NCP state: inet: Not-configured, inet6: Not-configured, iso: Not-configured,   mpls: Not-configured
  CHAP state: Closed
    Protocol inet, MTU: 100, Generation: 14, Route table: 0
      Flags: User-MTU, Negotiate-Address

show interfaces detail (PPPoE on J Series Services Routers)