PPPSTATS(8)                                                        PPPSTATS(8)



NAME
       pppstats, slstats - print PPP/SLIP statistics

SYNOPSIS
       pppstats,  slstats  [  -a  ]  [  -v ] [ -r ] [ -z ] [ -c <count> ] [ -w
       <secs> ] [ interface ]

DESCRIPTION
       The pppstats or slstats utility reports PPP or SLIP related  statistics
       at  regular  intervals  for  the  specified PPP/SLIP interface.  If the
       interface is unspecified, pppstats will default  to  ppp0  and  slstats
       will  default to sl0.  The display is split horizontally into input and
       output sections containing columns of statistics describing the proper-
       ties 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 ini-
              tiated.   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  speci-
              fied,  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 recep-
              tion 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 com-
              pressed 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 inter-
              face.  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  com-
              pression is applied.  Only reported when the -r option is speci-
              fied.

       When the -z option is specified, pppstats instead displays the  follow-
       ing  fields,  relating to the packet compression algorithm currently in
       use.  This option is not supported by slstats and  it  always  displays
       zeros.  If packet compression is not in use, these fields will all dis-
       play 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), slattach(8)



                                 2 March 2006                      PPPSTATS(8)
