man7.org > Linux > man-pages

Linux/UNIX system programming training

ifstat(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | SEE ALSO | AUTHOR | COLOPHON 

IFSTAT(8)                         Linux                         IFSTAT(8)

NAME         top

       ifstat - handy utility to read network interface statistics

SYNOPSIS         top

       ifstat [ OPTIONS ] [ INTERFACE_LIST ]

       INTERFACE_LIST := INTERFACE_LIST | interface

DESCRIPTION         top

       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         top

       -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         top

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

SEE ALSO         top

       ip(8)

AUTHOR         top

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

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

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling
       TCP/IP networking and traffic) project.  Information about the
       project can be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       netdev@vger.kernel.org, shemminger@osdl.org.  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2025-08-11.  (At that time, the date of the most recent commit
       that was found in the repository was 2025-08-08.)  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

iproute2                       28 Oct 2015                      IFSTAT(8)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI