Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


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



NAME
       pppstats - print PPP statistics

SYNOPSIS
       pppstats [ -a ] [ -d ] [ -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 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.

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