1IFSTAT(8)                            Linux                           IFSTAT(8)
2
3
4

NAME

6       ifstat - handy utility to read network interface statistics
7

SYNOPSIS

9       ifstat [ OPTIONS ] [ INTERFACE_LIST ]
10
11       INTERFACE_LIST := INTERFACE_LIST | interface
12

DESCRIPTION

14       ifstat  neatly  prints  out  network interface statistics.  The utility
15       keeps records of the previous data displayed in history  files  and  by
16       default  only  shows  difference between the last and the current call.
17       Location of the history files defaults to /tmp/.ifstat.u$UID but may be
18       overridden with the IFSTAT_HISTORY environment variable. Similarly, the
19       default location for xstat (extended stats) is /tmp/.<xstat  name>_ifs‐
20       tat.u$UID.
21

OPTIONS

23       -h, --help
24              Show summary of options.
25
26       -V, --version
27              Show version of program.
28
29       -a, --ignore
30              Ignore the history file.
31
32       -d, --scan=SECS
33              Sample statistics every SECS second.
34
35       -e, --errors
36              Show errors.
37
38       -n, --nooutput
39              Don't display any output.  Update the history file only.
40
41       -r, --reset
42              Reset history.
43
44       -s, --noupdate
45              Don't update the history file.
46
47       -t, --interval=SECS
48              Report average over the last SECS seconds.
49
50       -z, --zeros
51              Show entries with zero activity.
52
53       -j, --json
54              Display results in JSON format
55
56       -p, --pretty
57              If combined with --json, pretty print the output.
58
59       -x, --extended=TYPE
60              Show extended stats of TYPE. Supported types are:
61
62                      cpu_hits - Counts only packets that went via the CPU.
63
64

ENVIRONMENT

66       IFSTAT_HISTORY
67              If  set,  it's  value  is  interpreted as alternate history file
68              path.
69

SEE ALSO

71       ip(8)
72

AUTHOR

74       ifstat was written by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>.
75
76       This manual page was written by Petr Sabata <contyk@redhat.com>.
77
78
79
80iproute2                          28 Oct 2015                        IFSTAT(8)