pppstat(1M)

NAME
     pppstat - Point-to-Point Protocol (PPP) Status

SYNOPSIS
     pppstat [-n] [-u unit] [-i interval] [-m d|r|z]

DESCRIPTION
     pppstat displays the current status of PPP links.  Both configuration
     values (e.g. IP addresses, protocols, and packet sizes) and operational
     values (e.g. recent compression performance, corrupted packets, and
     current links in the multilink bundle) are displayed.

     The options are:

     -n   display numbers instead of names.

     -u unit
          display the stat of PPP unit unit instead of the first active unit.

     -i interval
          refresh the screen every interval seconds instead of once per
          second.

     -m d|r|z
          display using d or delta mode (changes since last screen update), r
          or reset mode or values since link start, or z or zeroed mode or
          values since last zeroed.

     The current status of a PPP link is displayed on seven screens.  The
     first four or "link" screens indicate what is happening on one of the
     links in a multilink bundle.  The fifth or "I/O" screen displays input
     and output status and counts for the overall multilink bundle.  The sixth
     displays accounting information, such as how long the links in the bundle
     have been active and how many phone calls have been attempted.  The
     seventh displays various generally uninteresting values, such as the next
     multilink serial number and how often the type-of-service (TOS) queuing
     mechanisms have been invoked.

     pppstat accepts single-character commands while it is running.  Single
     digits select the corresponding screen.  Plus (+) and minus (-) select
     the previous or next active interface or unit.  The letters "D", "Z", and
     "R" select "delta" (changes since last screen update), "zeroed" (values
     since last "Z"), and "reset modes" (values since link start).

     After the configuration has been checked (e.g. IP addresses) the most
     important or at least commonly monitored values are the number of packets
     with bad FCS in screens 1-4, the current bit rates in screen 5, and the
     number of links in the bundle and PPP processes adding links in screen 6.

Screens 1-4
     The per-link screens are empty when the corresponding link in the
     multilink bundle is not active.  When a link is active, its screen
     includes information about:

     peer:
          the Ident string received from the peer, which for IRIX includes
          information about the hardware and software.

     link type,
          whether synchronous or asynchronous, and whether the phone call was
          answered or originated.

     raw input and output
          in total bytes.

     link rate
          in bits per second if know and not inferred (e.g. specified in
          control file).

     RTT  or measured round-trip-time.

     MRU, MTU, MRRU, MTRU
          or maximum transmit and receive unit (packet) sizes and reassembled
          unit (multilink packet) sizes.

     bad packets
          or packets discarded because with bad checksums (FCS), insufficient
          buffer memory (no buf), too small to contain a packet (tiny),
          aborted by the peer, too long, or ridiculously long babble frames.
          Note that when using a modem, null frames are often sent before
          packet after a link has been idle to minimize the effects of line
          noise.

     compression
          various internal values of the data and header (or "VJ") compression
          machinery are displayed on the bottom of the screens 1-4

Screen 5
     The I/O screen contains general input/output information, including:

     input and output
          counts of the raw or compressed bytes moved and the number of bytes
          of IP packets.  Note that without compression, the number of raw
          bytes is more than the number of IP bytes.  The recent input and
          output bit rates are displayed along with an indication of whether
          those rates appeared to the PPP system medium or high compared to
          the capacity of the multilink bundle.

     available and previous
          bits per second of the overall multilink bundle as estimated by the
          PPP system are displayed below the measured rates.
     compression
          When compression is done "above" the multilink bundle, so that the
          per-link compression is the same as the compression of the entire
          bundle, the bottom of screen 5 contains information about the
          compression machinery like that found on screens 1-4.

Screen 6
     The accounting screen tells about the number of phone calls, their
     duration, and what the machinery is doing about adding or removing links.

FILES
     /tmp/.ppp-rendezvous   rendezvous with PPP daemons

SEE ALSO
     ppp(1m)