Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show ppp statistics

Syntax

Description

Display PPP interface statistics information.

Options

detail

(Optional) Display the detailed statistics.

memory

(Optional) Display PPP process memory statistics.

recovery

(Optional) Display recovery state of PPP after a GRES or restart. It is safe to force another GRES or restart only when the recovery state indicates the recovery is done.

Note:

When you issue this command option during the recovery process, the command may time out or fail silently rather than display output. Recovery is not complete until the command displays Recovery state: recovery done.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show ppp statistics command. Output fields are listed in the approximate order in which they appear.

Table 1: show ppp statistics Output Fields

Field Name

Field Description

Level of Output

Total sessions

Number of PPP sessions on an interface.

none detail

Sessions in disabled phase

Number of PPP sessions disabled. Number of sessions where the link is either administratively or physically down. Once the PPP process learns from the kernel that Layer 2 is ready to send and receive traffic, it will do a phase transition from disabled to established. When LCP and NCP transitions through states, links transition to the establish phase when terminate packets are exchanged or some other failure, such as authentication or expiration of a timer occurs.

none detail

Sessions in establish phase

Number of PPP sessions in establish phase. In order to establish communications over a point-to-point link, each end of the PPP link must first send LCP packets to configure and test the data link.

none detail

Sessions in authenticate phase

Number of PPP sessions in authenticate phase. Each end of the PPP link must first send LCP packets to configure the data link during the link establishment phase. After the link has been established, PPP provides for an optional authentication phase before proceeding to the Network-Layer Protocol (NLP) phase.

none detail

Sessions in network phase

Number of PPP sessions in the network phase. After a link has been established and optional facilities have been negotiated as needed by the LCP, PPP must send Network Control Protocol (NCP) packets to choose and configure one or more network-layer protocols, such as IP, IPX, or AppleTalk. Once each of the chosen network-layer protocols has been configured, datagrams from each network-layer protocol can be sent over the link.

none detail

Bundles in pending phase

Number of unique bundles to which PPP links are referring.

none detail

Type

Type of structure for which memory is allocated.

  • Queued rtsock msgs—Queued route socket messages. When a PPP process is unable to send a route socket message to the kernel (typically because of congestion of the route socket interface), the message is queued for deferred processing.

  • PPP session—Active PPP session. Stores all the information for a PPP session, such as authentication, sequence number, LCP session, and NCP session information.

  • Interface address—Interface address associated with a PPP connection. Stores the information about the interface address that PPP obtains from the kernel.

  • Destination profile—Stores the destination profile information associated with an interface address.

  • ML link settings—Stores information about an MLPPP link, such as the bundle name and compressed real-time transport protocol (CRTP) settings.

  • IPCP blocked address—When addresses are blocked in an address pool (for example, when the interface address is within the range of an address pool, it will be implicitly blocked), this structure is used to store the address in the pool.

  • PPP session trace—A PPP session trace is allocated for record keeping for each session listed at the [set protocols ppp monitor-session] hierarchy level.

  • IFL redundancy state—Stores redundancy state information needed for high availability (HA) operation.

  • Protocol family—Stores the information about the protocol family that PPP obtains from the kernel.

detail

Type (continued)

  • ML bundle settings—Multilink bundle settings. Stores the context information for a MLPPP bundle.

  • PPP LCP session—PPP Link Control Protocol session, used for establishing, configuring, and testing the data-link connection. Stores the information for an LCP session, such as negotiated options, current state, and statistics.

  • PPP NCP session—PPP Network Control Protocol (NCP) phase in the PPP link connection process. Stores the information for an NCP session, such as negotiated options, current state, address family, and statistics.

  • Physical interface—Stores the information about the physical interface that PPP obtains from the kernel.

  • Access profile—Stores the information found at the [edit access profile] hierarchy level for each profile.

  • ML wait entry—Created when there are MLPPP links joining a bundle. before its addition to the PPP process. Links are saved here, and when the bundle is added, are properly assigned to the bundle.

  • Group profile—Stores information set in the PPP stanza of a group profile, such as the primary and secondary Domain Name System (DNS), primary and secondary NDNS, and address pool name.

  • Profile client—Stores the per-client information of the access profile (information obtained from the [set access profile name client client-name] hierarchy level.

  • PPP Auth session—PPP authentication session. Stores all the session-specific authentication protocol parameters.

  • Logical interface—Stores the information about the logical interface that PPP obtains from the kernel.

  • Non-tagged—Generic catch-all for allocations not of a particular structure type.

detail

Type

If you specify the memory keyword, the following memory statistics are displayed for Ethernet interfaces on M120 and M320 routers.

  • authenticate—Stores information common to all PPP authentication protocols.

  • linkInterface—Stores information about PPP link interfaces.

  • pap—Stores information about PPP PAP authentication protocol. Includes authenticator and authenticate state machines.

  • lcp—PPP Link Control Protocol session. Used for establishing, configuring and testing the data-link connection. Stores information for LCP session, such as negotiated options, state, and statistics.

  • chap—Stores information about PPP CHAP authentication protocol. Includes authenticator and authenticate state machines.

  • eapBuffer—Stores runtime authentication information for EAP.

  • eap—Stores information about PPP EAP authentication protocol. Includes authenticator and authenticate state machines.

  • authNone—Stores information about no PPP authentication. Includes the authenticator state machine.

  • networkInterface—Stores information about NCP portions of PPP protocol.

  • ipNcp—PPP IPCP session information. Used for configuring, negotiating, and establishing IPCP protocol. Stores the current state, and configured and negotiated options.

  • ipv6Ncp—PPP IPv6CP session information. Used for configuring, negotiating, and establishing IPv6CP protocol. Stores the current state, and configured and negotiated options.

  • osiNcp—PPP OSICP session information. Used for configuring, negotiating, and establishing OSICP protocol. Stores the current state, and configured and negotiated options.

  • mplsNcp—PPP MPLSCP session information. Used for configuring, negotiating, and establishing MPLSCP protocol. Stores the current state.

  • trace—Stores information for PPP debugging.

memory

Total

Total memory allocations.

detail

Size

Size of the structure.

detail

Active

Number of instances of the structure that are used.

detail

Free

Number of instances of the structure that are on the free list. Types with a number in the Free column are pooled structures, and are typically types that are often used.

detail

Limit

Maximum number of instances that can be on the free list. Types with a number in the Limit column are pooled structures, and are typically types that are often used.

detail

Total size

Total amount of memory being used by a type of structure (includes active and free instances).

detail

Requests

Number of allocation requests made by a type of structure.

detail

Failures

Number of failed allocations.

detail

Recovery state

State of PPP recovery after a GRES or restart:

  • recovery done—All sessions have recovered; it is safe to force another GRES or restart.

  • recovery cleanup pending—Not all PPP sessions have recovered; it is not safe to force another GRES or restart.

none

Subscriber sessions pending retention

Number of PPP subscriber sessions that are in the process of being recovered.

none

Subscriber sessions recovered OK

Number of PPP subscriber sessions that have recovered after a GRES or restart.

none

Subscriber sessions recovery failed

Number of PPP subscriber sessions that have failed to recover after a GRES or restart.

none

Sample Output

show ppp statistics

show ppp statistics detail

show ppp statistics recovery (Safe to Restart)

show ppp statistics recovery (Unsafe to Restart)