Manual: pppstats

PPPSTATS(8)					   System Manager's Manual					 PPPSTATS(8)

NAME
       pppstats - print PPP statistics

SYNOPSIS
       pppstats [ -a ] [ -d ] [ -v ] [ -r ] [ -z ] [ -c  ] [ -w  ] [ interface ]

DESCRIPTION
       The pppstats utility reports PPP-related statistics at regular intervals for the specified PPP interface.  If the in‐
       terface	is  unspecified,  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	 in‐
       terface.

       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.

       -d     Show data rate (kB/s) instead of bytes.

       -c count
	      Repeat  the display count times.	If this option is not specified, the default repeat count is 1 if the -w op‐
	      tion 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 algo‐
	      rithm.

       -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  algo‐
	      rithm 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 er‐
	      rors.  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 compressed packets.  Only reported when the -r	 op‐
	      tion 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 spec‐
	      ified.

       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	 re‐
	      ported 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, pppstats 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) re‐
	      ceived.

       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 uncom‐
	      pressed 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)