IPTRAF(8)                  System Manager's Manual                 IPTRAF(8)

NAME         top

       iptraf - Interactive Colorful IP LAN Monitor

SYNOPSIS         top

       iptraf { [ -f ] [ -q ] [ -u ] [ { -i iface | -g | -d iface | -s iface
       | -z iface | -l iface } [ -t timeout ] [ -B [ -L logfile ] ] ] | [ -h
       ] }

DESCRIPTION         top

       iptraf is an ncurses-based IP LAN monitor that generates various
       network statistics including TCP info, UDP counts, ICMP and OSPF
       information, Ethernet load info, node stats, IP checksum errors, and

       If the iptraf command is issued without any command-line options, the
       program comes up in interactive mode, with the various facilities
       accessed through the main menu.

OPTIONS         top

       These options can also be supplied to the command:

       -i iface
              immediately start the IP traffic monitor on the specified
              interface, or all interfaces if "-i all" is specified

       -g     immediately start the general interface statistics

       -d iface
              allows you to immediately start the detailed on the indicated
              interface (iface)

       -s iface
              allows you to immediately monitor TCP and UDP traffic on the
              specified interface (iface)

       -z iface
              shows packet counts by size on the specified interface

       -l iface
              start the LAN station monitor on the specified interface, or
              all LAN interfaces if "-l all" is specified

       -t timeout
              tells IPTraf to run the specified facility for only timeout
              minutes.  This option is used only with one of the above

       -B     redirect standard output to /dev/null, closes standard input,
              and forks the program into the background.  Can be used only
              with one of the facility invocation parameters above.  Send
              the backgrounded process a USR2 signal to terminate.

       -L logfile
              allows you to specify an alternate log file name.  The default
              log file name is based on either the interface selected
              (detailed interface statistics, TCP/UDP service statistics,
              packet size breakdown), or the instance of the facility (IP
              traffic monitor, LAN station monitor).  If a path is not
              specified, the log file is placed in /var/log/iptraf

       -f     clears all locks and counters, causing this instance of IPTraf
              to think it's the first one running.  This should only be used
              to recover from an abnormal termination or system crash.

       -u     allow use of unsupported interfaces as ethernet devices.  This
              is needed if you changed the name of an interface (ex: ip link
              set eth0 name foo0)

       -q     no longer needed, maintained only for compatibility.

       -h     shows a command summary

SIGNALS         top

        SIGUSR1 - rotates log files while program is running
        SIGUSR2 - terminates an IPTraf process running in the background.

FILES         top

        /var/log/iptraf/*.log - log file
        /var/lib/iptraf/* - important IPTraf data files

SEE ALSO         top

        Documentation/* - complete documentation written by the author

AUTHOR         top

       Gerard Paul Java (

MANUAL AUTHOR         top

       Frederic Peters (, using iptraf -h General manual
       page modifications by Gerard Paul Java (

COLOPHON         top

       This page is part of the iptraf-ng (Interactive Colorful IP LAN
       Monitor) project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for
       this manual page, see 
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository 
       ⟨⟩ on 2017-03-13.  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

                              IPTraf Help Page                     IPTRAF(8)