NAME

       pppstats - print PPP statistics

SYNOPSIS

       pppstats [ -a ] [ -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.

       -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)