pppstats

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  inter-
       vals  for  the  specified PPP interface.	 If the interface is unspeci-
       fied, 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  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
	      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 com-
	      pressed packets.	Only reported when the -r  option  is  speci-
	      fied.

       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 com-
	      pression is applied.  Only reported when the -r option is spec-
	      ified.

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