iptraf



IPTRAF(8)                                                            IPTRAF(8)




NAME

       iptraf - Interactive Colorful IP LAN Monitor


SYNOPSIS

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


DESCRIPTION

       iptraf is an ncurses-based IP LAN monitor that generates  various  net-
       work  statistics including TCP info, UDP counts, ICMP and OSPF informa-
       tion, Ethernet load info, node stats, IP checksum errors, and others.

       If the 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

       These options can also be supplied to the command:

       -i iface
              immediately start the IP traffic monitor on the specified inter-
              face, 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 min-
              utes.   This  option  is used only with one of the above parame-
              ters.

       -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 speci-
              fied, 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.

       -q     no longer needed, maintained only for compatibility.

       -h     shows a command summary


SIGNALS

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



FILES

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



SEE ALSO

        Documentation/* - complete documentation written by the author



AUTHOR

       Gerard Paul Java (riker@mozcom.com)



MANUAL AUTHOR

       Frederic Peters (fpeters@debian.org), using iptraf --help General  man-
       ual page modifications by Gerard Paul Java (riker@mozcom.com)




                               IPTraf Help Page                      IPTRAF(8)

Man(1) output converted with man2html