1pppstats(1M)            System Administration Commands            pppstats(1M)
2
3
4

NAME

6       pppstats - print PPP statistics
7

SYNOPSIS

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

DESCRIPTION

14       The  pppstats  utility reports PPP-related statistics at regular inter‐
15       vals for the specified PPP interface. If the interface is  unspecified,
16       pppstats  defaults  to  sppp0.  The  display is split horizontally into
17       input and output sections containing columns of  statistics  describing
18       the  properties  and  volume of packets received and transmitted by the
19       interface.
20

OPTIONS

22       The pppstats options are:
23
24       -a           Display absolute values  rather  than  deltas.  With  this
25                    option,  all  reports show statistics for the time elapsed
26                    since the link was initiated.  Without  this  option,  the
27                    second and subsequent reports show statistics for the time
28                    since the last report.
29
30
31       -c count     Repeat the display count times.  If  this  option  is  not
32                    specified,  the default repeat count is 1 if the -w option
33                    is not specified, otherwise infinity.
34
35
36       -r           Display additional statistics summarizing the  compression
37                    ratio achieved by the packet compression algorithm in use.
38
39
40       -v           Display  additional statistics relating to the performance
41                    of the Van Jacobson TCP header compression algorithm.
42
43
44       -w wait      Pause  wait seconds between each display. If  this  option
45                    is not specified, the default interval is five seconds.
46
47
48       -z           Instead  of the standard display, show statistics indicat‐
49                    ing the performance of the packet compression algorithm in
50                    use.
51
52

EXTENDED DESCRIPTION

54       The  following  fields are printed on the input side when the -z option
55       is not used:
56
57       IN         Total number of bytes received by this interface.
58
59
60       PACK       Total number of packets received by this interface.
61
62
63       VJCOMP     Number of header-compressed TCP  packets  received  by  this
64                  interface.
65
66
67       VJUNC      Number  of  header-uncompressed TCP packets received by this
68                  interface. Not reported when the -r option is specified.
69
70
71       VJERR      Number of corrupted or bogus header-compressed  TCP  packets
72                  received  by this interface. Not reported when the -r option
73                  is specified.
74
75
76       VJTOSS     Number of VJ header-compressed TCP packets dropped on recep‐
77                  tion  by  this  interface  because of preceding errors. Only
78                  reported when the -v option is specified.
79
80
81       NON-VJ     Total number of non-TCP packets received by this  interface.
82                  Only reported when the -v option is specified.
83
84
85       RATIO      Compression  ratio  achieved  for  received  packets  by the
86                  packet compression scheme in  use,  defined  as  the  uncom‐
87                  pressed  size  divided by the compressed size. Only reported
88                  when the -r option is specified.
89
90
91       UBYTE      Total number of bytes received, after decompression of  com‐
92                  pressed  packets. Only reported when the -r option is speci‐
93                  fied.
94
95
96
97       The following fields are printed on the output side:
98
99       OUT       Total number of bytes transmitted from this interface.
100
101
102       PACK      Total number of packets transmitted from this interface.
103
104
105       VJCOMP    Number of TCP packets transmitted from  this  interface  with
106                 VJ-compressed TCP headers.
107
108
109       VJUNC     Number  of  TCP  packets transmitted from this interface with
110                 VJ-uncompressed TCP headers. Not reported when the -r  option
111                 is specified.
112
113
114       NON-VJ    Total  number of non-TCP packets transmitted from this inter‐
115                 face. Not reported when the -r option is specified.
116
117
118       VJSRCH    Number of searches for the  cached  header  entry  for  a  VJ
119                 header  compressed  TCP  packet.  Only  reported  when the -v
120                 option is specified.
121
122
123       VJMISS    Number of failed searches for the cached header entry  for  a
124                 VJ  header  compressed  TCP packet. Only reported when the -v
125                 option is specified.
126
127
128       RATIO     Compression ratio achieved for  transmitted  packets  by  the
129                 packet  compression scheme in use, defined as the size before
130                 compression divided by the  compressed  size.  Only  reported
131                 when the -r option is specified.
132
133
134       UBYTE     Total  number  of  bytes to be transmitted before packet com‐
135                 pression is applied. Only reported  when  the  -r  option  is
136                 specified.
137
138
139
140       When the -z option is specified, pppstats displays the following fields
141       relating to the packet  compression  algorithm  currently  in  use.  If
142       packet  compression  is  not  in  use, these fields display zeroes. The
143       fields displayed on the input side are:
144
145       COMPRESSED BYTE        Number of bytes of compressed packets received.
146
147
148       COMPRESSED PACK        Number of compressed packets received.
149
150
151       INCOMPRESSIBLE BYTE    Number of bytes of incompressible packets  (that
152                              is, those which were transmitted in uncompressed
153                              form) received.
154
155
156       INCOMPRESSIBLE PACK    Number of incompressible packets received.
157
158
159       COMP RATIO             Recent compression ratio for  incoming  packets,
160                              defined  as the uncompressed size divided by the
161                              compressed size (including both compressible and
162                              incompressible packets).
163
164
165
166       The fields displayed on the output side are:
167
168       COMPRESSED BYTE        Number  of bytes of compressed packets transmit‐
169                              ted.
170
171
172       COMPRESSED PACK        Number of compressed packets transmitted.
173
174
175       INCOMPRESSIBLE BYTE    Number  of  bytes  of   incompressible   packets
176                              received;  that  is, those that were transmitted
177                              by the peer in uncompressed form.
178
179
180       INCOMPRESSIBLE PACK    Number of incompressible packets transmitted.
181
182
183       COMP RATIO             Recent compression ratio for outgoing packets.
184
185

ATTRIBUTES

187       See attributes(5)  for descriptions of the following attributes:
188
189
190
191
192       ┌─────────────────────────────┬─────────────────────────────┐
193       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
194       ├─────────────────────────────┼─────────────────────────────┤
195       │Availability                 │SUNWpppdu                    │
196       ├─────────────────────────────┼─────────────────────────────┤
197       │Interface Stability          │Evolving                     │
198       └─────────────────────────────┴─────────────────────────────┘
199

SEE ALSO

201       pppd(1M), attributes(5)
202
203
204
205SunOS 5.11                        4 May 2001                      pppstats(1M)
Impressum