Back to main site | Back to man page index

PPPSTATS(8)                                    System Manager's Manual                                    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  out‐
       put  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 pre‐
              ceding 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

       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 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 com‐
              pressed 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