.TH IFSTAT 8 "28 Oct 2015" "iproute2" "Linux"

.SH NAME

ifstat \- handy utility to read network interface statistics

.SH SYNOPSIS

.in +8

.ti -8

.BR ifstat " [ "

.IR OPTIONS " ] [ " INTERFACE_LIST " ]"

.ti -8

.IR INTERFACE_LIST " := " INTERFACE_LIST " | " interface

.SH DESCRIPTION

\fBifstat\fP neatly prints out network interface statistics.

The utility keeps records of the previous data displayed in history files and

by default only shows difference between the last and the current call.

Location of the history files defaults to /tmp/.ifstat.u$UID but may be

overridden with the IFSTAT_HISTORY environment variable. Similarly, the default

location for xstat (extended stats) is /tmp/.<xstat name>_ifstat.u$UID.

.SH OPTIONS

.TP

.B \-h, \-\-help

Show summary of options.

.TP

.B \-V, \-\-version

Show version of program.

.TP

.B \-a, \-\-ignore

Ignore the history file.

.TP

.B \-d, \-\-scan=SECS

Sample statistics every SECS second.

.TP

.B \-e, \-\-errors

Show errors.

.TP

.B \-n, \-\-nooutput

Don't display any output.  Update the history file only.

.TP

.B \-r, \-\-reset

Reset history.

.TP

.B \-s, \-\-noupdate

Don't update the history file.

.TP

.B \-t, \-\-interval=SECS

Report average over the last SECS seconds.

.TP

.B \-z, \-\-zeros

Show entries with zero activity.

.TP

.B \-j, \-\-json

Display results in JSON format

.TP

.B \-p, \-\-pretty

If combined with

.BR \-\-json ,

pretty print the output.

.TP

.B \-x, \-\-extended=TYPE

Show extended stats of TYPE. Supported types are:

.in +8

.B cpu_hits

- Counts only packets that went via the CPU.

.in -8

.SH ENVIRONMENT

.TP

.B IFSTAT_HISTORY

If set, it's value is interpreted as alternate history file path.

.SH SEE ALSO

.BR ip (8)

.br

.SH AUTHOR

ifstat was written by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>.

.PP

This manual page was written by Petr Sabata <contyk@redhat.com>.