Debian Codegraph @

upstream/opensuse-tumbleweed/man8/ifstat.8

raw
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 seconds.
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, its 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]>.