pppstats Man page

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

NAME

pppstats – print PPP statistics

SYNOPSIS

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

DESCRIPTION

The pppstats utility reports PPP-related statistics at regular inter‐
vals 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 inter‐
face.

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 ini‐
tiated. 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 recep‐
tion 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 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 inter‐
face. 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 speci‐
fied.

When the -z option is specified, pppstats instead displays the follow‐
ing fields, relating to the packet compression algorithm currently in
use. If packet compression is not in use, these fields will all dis‐
play 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)