PPPSTATS(8)                                           PPPSTATS(8)

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 sec-
       tions 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  com-
              pression  ratio  achieved by the packet compression
              algorithm in use.

       -v     Display additional statistics relating to the  per-
              formance 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 compres-
              sion 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 inter-
              face.

       PACK   The total number of packets received by this inter-
              face.

       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  speci-
              fied.

       UBYTE  The  total  number  of bytes received, after decom-
              pression 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, instead displays the fol-
       lowing  fields,  relating  to the packet compression algo-
       rithm 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 transmit-
              ted.

       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                         1