.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 <firstname.lastname@example.org>. .PP This manual page was written by Petr Sabata <email@example.com>.