NAME

       pppstats - print PPP statistics

SYNOPSIS

       pppstats [ -a ] [ -d ] [ -v ] [ -r ] [ -z ] [ -c <count> ] [ -w <secs> ] [ interface ]

DESCRIPTION

       The pppstats utility reports PPP-related statistics at regular intervals for the specified PPP interface.
       If  the  interface is unspecified, it will default to ppp0.  The display is split horizontally into input
       and output sections containing columns of statistics describing the  properties  and  volume  of  packets
       received and transmitted by the interface.

       The options are as follows:

       -a     Display absolute values rather than deltas.  With this option, all reports show statistics for the
              time  since  the  link was initiated.  Without this option, the second and subsequent reports show
              statistics for the time since the last report.

       -d     Show data rate (kB/s) instead of bytes.

       -c count
              Repeat the display count times.  If this option is not specified, the default repeat count is 1 if
              the -w option is not specified, otherwise infinity.

       -r     Display additional statistics summarizing the compression ratio achieved by the packet compression
              algorithm in use.

       -v     Display additional statistics  relating  to  the  performance  of  the  Van  Jacobson  TCP  header
              compression algorithm.

       -w wait
              Pause wait seconds between each display.  If this option is not specified, the default interval is
              5 seconds.

       -z     Instead  of  the  standard  display,  show  statistics  indicating  the  performance of the packet
              compression algorithm in use.

       The following fields are printed on the input side when the -z option is not used:

       IN     The total number of bytes received by this interface.

       PACK   The total number of packets received by this interface.

       VJCOMP The number of header-compressed TCP packets received by this interface.

       VJUNC  The number of header-uncompressed TCP packets received by this interface.  Not reported  when  the
              -r option is specified.

       VJERR  The  number  of  corrupted or bogus header-compressed TCP packets received by this interface.  Not
              reported when the -r option is specified.

       VJTOSS The number of VJ header-compressed TCP packets dropped on reception by this interface  because  of
              preceding errors.  Only reported when the -v option is specified.

       NON-VJ The  total  number of non-TCP packets received by this interface. Only reported when the -v option
              is specified.

       RATIO  The compression ratio achieved for received packets by  the  packet  compression  scheme  in  use,
              defined as the uncompressed size divided by the compressed size.  Only reported when the -r option
              is specified.

       UBYTE  The total number of bytes received, after decompression of compressed packets.  Only reported when
              the -r option is specified.

       The following fields are printed on the output side:

       OUT    The total number of bytes transmitted from this interface.

       PACK   The total number of packets transmitted from this interface.

       VJCOMP The number of TCP packets transmitted from this interface with VJ-compressed TCP headers.

       VJUNC  The  number  of TCP packets transmitted from this interface with VJ-uncompressed TCP headers.  Not
              reported when the -r option is specified.

       NON-VJ The total number of non-TCP packets transmitted from this interface.  Not  reported  when  the  -r
              option is specified.

       VJSRCH The  number  of  searches for the cached header entry for a VJ header compressed TCP packet.  Only
              reported when the -v option is specified.

       VJMISS The number of failed searches for the cached header entry for a VJ header compressed  TCP  packet.
              Only reported when the -v option is specified.

       RATIO  The  compression  ratio  achieved for transmitted packets by the packet compression scheme in use,
              defined as the size before compression divided by the compressed size.  Only reported when the  -r
              option is specified.

       UBYTE  The  total number of bytes to be transmitted, before packet compression is applied.  Only reported
              when the -r option is specified.

       When the -z option is specified, pppstats instead displays the following fields, relating to  the  packet
       compression  algorithm  currently  in  use.   If  packet compression is not in use, these fields will all
       display zeroes.  The fields displayed on the input side are:

       COMPRESSED BYTE
              The number of bytes of compressed packets received.

       COMPRESSED PACK
              The number of compressed packets received.

       INCOMPRESSIBLE BYTE
              The number of  bytes  of  incompressible  packets  (that  is,  those  which  were  transmitted  in
              uncompressed form) received.

       INCOMPRESSIBLE PACK
              The number of incompressible packets received.

       COMP RATIO
              The recent compression ratio for incoming packets, defined as the uncompressed size divided by the
              compressed size (including both compressible and incompressible packets).

       The fields displayed on the output side are:

       COMPRESSED BYTE
              The number of bytes of compressed packets transmitted.

       COMPRESSED PACK
              The number of compressed packets transmitted.

       INCOMPRESSIBLE BYTE
              The  number  of bytes of incompressible packets transmitted (that is, those which were transmitted
              in uncompressed form).

       INCOMPRESSIBLE PACK
              The number of incompressible packets transmitted.

       COMP RATIO
              The recent compression ratio for outgoing packets.

SEE ALSO

       pppd(8)

                                                  26 June 1995                                       PPPSTATS(8)