PPPSTATS(8) Maintenance Commands and Procedures 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, pppstats defaults to sppp0. 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.

OPTIONS

The pppstats options are:

-a
Display absolute values rather than deltas. With this
option, all reports show statistics for the time elapsed
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 five seconds.


-z
Instead of the standard display, show statistics
indicating the performance of the packet compression
algorithm in use.

EXTENDED DESCRIPTION

The following fields are printed on the input side when the -z option
is not used:

IN
Total number of bytes received by this interface.


PACK
Total number of packets received by this interface.


VJCOMP
Number of header-compressed TCP packets received by this
interface.


VJUNC
Number of header-uncompressed TCP packets received by this
interface. Not reported when the -r option is specified.


VJERR
Number of corrupted or bogus header-compressed TCP packets
received by this interface. Not reported when the -r
option is specified.


VJTOSS
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
Total number of non-TCP packets received by this
interface. Only reported when the -v option is specified.


RATIO
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
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
Total number of bytes transmitted from this interface.


PACK
Total number of packets transmitted from this interface.


VJCOMP
Number of TCP packets transmitted from this interface with
VJ-compressed TCP headers.


VJUNC
Number of TCP packets transmitted from this interface with
VJ-uncompressed TCP headers. Not reported when the -r
option is specified.


NON-VJ
Total number of non-TCP packets transmitted from this
interface. Not reported when the -r option is specified.


VJSRCH
Number of searches for the cached header entry for a VJ
header compressed TCP packet. Only reported when the -v
option is specified.


VJMISS
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
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
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 displays the following
fields relating to the packet compression algorithm currently in use.
If packet compression is not in use, these fields display zeroes. The
fields displayed on the input side are:

COMPRESSED BYTE
Number of bytes of compressed packets
received.


COMPRESSED PACK
Number of compressed packets received.


INCOMPRESSIBLE BYTE
Number of bytes of incompressible packets
(that is, those which were transmitted in
uncompressed form) received.


INCOMPRESSIBLE PACK
Number of incompressible packets received.


COMP RATIO
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
Number of bytes of compressed packets
transmitted.


COMPRESSED PACK
Number of compressed packets transmitted.


INCOMPRESSIBLE BYTE
Number of bytes of incompressible packets
received; that is, those that were transmitted
by the peer in uncompressed form.


INCOMPRESSIBLE PACK
Number of incompressible packets transmitted.


COMP RATIO
Recent compression ratio for outgoing packets.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+

SEE ALSO

attributes(7), pppd(8)

May 4, 2001 PPPSTATS(8)