ifstat - Man Page

handy utility to read network interface statistics

Examples (TL;DR)

Synopsis

ifstat [ Options ] [ INTERFACE_LIST ]

INTERFACE_LIST := INTERFACE_LIST | interface

Description

ifstat 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.

Options

-h,  --help

Show summary of options.

-V,  --version

Show version of program.

-a,  --ignore

Ignore the history file.

-d,  --scan=SECS

Sample statistics every SECS second.

-e,  --errors

Show errors.

-n,  --nooutput

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

-r,  --reset

Reset history.

-s,  --noupdate

Don't update the history file.

-t,  --interval=SECS

Report average over the last SECS seconds.

-z,  --zeros

Show entries with zero activity.

-j,  --json

Display results in JSON format

-p,  --pretty

If combined with --json, pretty print the output.

-x,  --extended=TYPE

Show extended stats of TYPE. Supported types are:

cpu_hits - Counts only packets that went via the CPU.

Environment

IFSTAT_HISTORY

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

See Also

ip(8)

Author

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

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

Info

28 Oct 2015 iproute2 Linux