


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.



			   26 June 1995				1





PPPSTATS(8)					      PPPSTATS(8)


       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



			   26 June 1995				2





PPPSTATS(8)					      PPPSTATS(8)


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





			   26 June 1995				3





PPPSTATS(8)					      PPPSTATS(8)


       INCOMPRESSIBLE PACK
	      The number of incompressible packets transmitted.

       COMP RATIO
	      The  recent compression ratio for outgoing packets.

SEE ALSO
       pppd(8)

















































			   26 June 1995				4


