1PPPSTATS(8)                 System Manager's Manual                PPPSTATS(8)
2
3
4

NAME

6       pppstats - print PPP statistics
7

SYNOPSIS

9       pppstats  [ -a ] [ -d ] [ -v ] [ -r ] [ -z ] [ -c <count> ] [ -w <secs>
10       ] [ interface ]
11

DESCRIPTION

13       The pppstats utility reports PPP-related statistics at  regular  inter‐
14       vals for the specified PPP interface.  If the interface is unspecified,
15       it will default to ppp0.  The display is split horizontally into  input
16       and  output  sections  containing  columns of statistics describing the
17       properties and volume of packets received and transmitted by the inter‐
18       face.
19
20       The options are as follows:
21
22       -a     Display  absolute  values rather than deltas.  With this option,
23              all reports show statistics for the time since the link was ini‐
24              tiated.   Without this option, the second and subsequent reports
25              show statistics for the time since the last report.
26
27       -d     Show data rate (kB/s) instead of bytes.
28
29       -c count
30              Repeat the display count times.  If this option  is  not  speci‐
31              fied,  the  default  repeat  count  is 1 if the -w option is not
32              specified, otherwise infinity.
33
34       -r     Display additional statistics summarizing the compression  ratio
35              achieved by the packet compression algorithm in use.
36
37       -v     Display additional statistics relating to the performance of the
38              Van Jacobson TCP header compression algorithm.
39
40       -w wait
41              Pause wait seconds between each display.  If this option is  not
42              specified, the default interval is 5 seconds.
43
44       -z     Instead  of the standard display, show statistics indicating the
45              performance of the packet compression algorithm in use.
46
47       The following fields are printed on the input side when the  -z  option
48       is not used:
49
50       IN     The total number of bytes received by this interface.
51
52       PACK   The total number of packets received by this interface.
53
54       VJCOMP The  number  of  header-compressed  TCP packets received by this
55              interface.
56
57       VJUNC  The number of header-uncompressed TCP packets received  by  this
58              interface.  Not reported when the -r option is specified.
59
60       VJERR  The  number  of corrupted or bogus header-compressed TCP packets
61              received by this interface.  Not reported when the -r option  is
62              specified.
63
64       VJTOSS The number of VJ header-compressed TCP packets dropped on recep‐
65              tion by  this  interface  because  of  preceding  errors.   Only
66              reported when the -v option is specified.
67
68       NON-VJ The  total number of non-TCP packets received by this interface.
69              Only reported when the -v option is specified.
70
71       RATIO  The compression ratio  achieved  for  received  packets  by  the
72              packet  compression  scheme  in use, defined as the uncompressed
73              size divided by the compressed size.  Only reported when the  -r
74              option is specified.
75
76       UBYTE  The  total number of bytes received, after decompression of com‐
77              pressed packets.  Only reported when the -r option is specified.
78
79       The following fields are printed on the output side:
80
81       OUT    The total number of bytes transmitted from this interface.
82
83       PACK   The total number of packets transmitted from this interface.
84
85       VJCOMP The number of TCP packets transmitted from this  interface  with
86              VJ-compressed TCP headers.
87
88       VJUNC  The  number  of TCP packets transmitted from this interface with
89              VJ-uncompressed TCP headers.  Not reported when the -r option is
90              specified.
91
92       NON-VJ The total number of non-TCP packets transmitted from this inter‐
93              face.  Not reported when the -r option is specified.
94
95       VJSRCH The number of searches for the cached  header  entry  for  a  VJ
96              header  compressed TCP packet.  Only reported when the -v option
97              is specified.
98
99       VJMISS The number of failed searches for the cached header entry for  a
100              VJ  header  compressed  TCP  packet.   Only reported when the -v
101              option is specified.
102
103       RATIO  The compression ratio achieved for transmitted  packets  by  the
104              packet  compression  scheme  in  use, defined as the size before
105              compression divided by the compressed size.  Only reported  when
106              the -r option is specified.
107
108       UBYTE  The  total number of bytes to be transmitted, before packet com‐
109              pression is applied.  Only reported when the -r option is speci‐
110              fied.
111
112       When  the -z option is specified, pppstats instead displays the follow‐
113       ing fields, relating to the packet compression algorithm  currently  in
114       use.   If  packet compression is not in use, these fields will all dis‐
115       play zeroes.  The fields displayed on the input side are:
116
117       COMPRESSED BYTE
118              The number of bytes of compressed packets received.
119
120       COMPRESSED PACK
121              The number of compressed packets received.
122
123       INCOMPRESSIBLE BYTE
124              The number of bytes of incompressible packets  (that  is,  those
125              which were transmitted in uncompressed form) received.
126
127       INCOMPRESSIBLE PACK
128              The number of incompressible packets received.
129
130       COMP RATIO
131              The  recent  compression  ratio for incoming packets, defined as
132              the uncompressed size divided by the compressed size  (including
133              both compressible and incompressible packets).
134
135       The fields displayed on the output side are:
136
137       COMPRESSED BYTE
138              The number of bytes of compressed packets transmitted.
139
140       COMPRESSED PACK
141              The number of compressed packets transmitted.
142
143       INCOMPRESSIBLE BYTE
144              The  number of bytes of incompressible packets transmitted (that
145              is, those which were transmitted in uncompressed form).
146
147       INCOMPRESSIBLE PACK
148              The number of incompressible packets transmitted.
149
150       COMP RATIO
151              The recent compression ratio for outgoing packets.
152

SEE ALSO

154       pppd(8)
155
156
157
158                                 26 June 1995                      PPPSTATS(8)
Impressum