| 1 |
.TH IFSTAT 8 "28 Oct 2015" "iproute2" "Linux" |
| 2 |
.SH NAME |
| 3 |
ifstat \- handy utility to read network interface statistics |
| 4 |
.SH SYNOPSIS |
| 5 |
.in +8 |
| 6 |
.ti -8 |
| 7 |
.BR ifstat " [ " |
| 8 |
.IR OPTIONS " ] [ " INTERFACE_LIST " ]" |
| 9 |
|
| 10 |
.ti -8 |
| 11 |
.IR INTERFACE_LIST " := " INTERFACE_LIST " | " interface |
| 12 |
.SH DESCRIPTION |
| 13 |
\fBifstat\fP neatly prints out network interface statistics. |
| 14 |
The utility keeps records of the previous data displayed in history files and |
| 15 |
by default only shows difference between the last and the current call. |
| 16 |
Location of the history files defaults to /tmp/.ifstat.u$UID but may be |
| 17 |
overridden with the IFSTAT_HISTORY environment variable. Similarly, the default |
| 18 |
location for xstat (extended stats) is /tmp/.<xstat name>_ifstat.u$UID. |
| 19 |
.SH OPTIONS |
| 20 |
.TP |
| 21 |
.B \-h, \-\-help |
| 22 |
Show summary of options. |
| 23 |
.TP |
| 24 |
.B \-V, \-\-version |
| 25 |
Show version of program. |
| 26 |
.TP |
| 27 |
.B \-a, \-\-ignore |
| 28 |
Ignore the history file. |
| 29 |
.TP |
| 30 |
.B \-d, \-\-scan=SECS |
| 31 |
Sample statistics every SECS second. |
| 32 |
.TP |
| 33 |
.B \-e, \-\-errors |
| 34 |
Show errors. |
| 35 |
.TP |
| 36 |
.B \-n, \-\-nooutput |
| 37 |
Don't display any output. Update the history file only. |
| 38 |
.TP |
| 39 |
.B \-r, \-\-reset |
| 40 |
Reset history. |
| 41 |
.TP |
| 42 |
.B \-s, \-\-noupdate |
| 43 |
Don't update the history file. |
| 44 |
.TP |
| 45 |
.B \-t, \-\-interval=SECS |
| 46 |
Report average over the last SECS seconds. |
| 47 |
.TP |
| 48 |
.B \-z, \-\-zeros |
| 49 |
Show entries with zero activity. |
| 50 |
.TP |
| 51 |
.B \-j, \-\-json |
| 52 |
Display results in JSON format |
| 53 |
.TP |
| 54 |
.B \-p, \-\-pretty |
| 55 |
If combined with |
| 56 |
.BR \-\-json , |
| 57 |
pretty print the output. |
| 58 |
.TP |
| 59 |
.B \-x, \-\-extended=TYPE |
| 60 |
Show extended stats of TYPE. Supported types are: |
| 61 |
|
| 62 |
.in +8 |
| 63 |
.B cpu_hits |
| 64 |
- Counts only packets that went via the CPU. |
| 65 |
.in -8 |
| 66 |
|
| 67 |
.SH ENVIRONMENT |
| 68 |
.TP |
| 69 |
.B IFSTAT_HISTORY |
| 70 |
If set, it's value is interpreted as alternate history file path. |
| 71 |
.SH SEE ALSO |
| 72 |
.BR ip (8) |
| 73 |
.br |
| 74 |
.SH AUTHOR |
| 75 |
ifstat was written by Alexey Kuznetsov <[email protected]>. |
| 76 |
.PP |
| 77 |
This manual page was written by Petr Sabata <[email protected]>. |