iptraf.8

NAME

       iptraf - Interactive Colorful IP LAN Monitor

SYNOPSIS

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

DESCRIPTION

       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 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 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 traf­
              fic on the specified interface (iface)

       -z iface
              shows packet counts by size on the specified inter­
              face

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

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

       -f     override  multiple-instance  restrictions.   Erases
              any  tags  that may have been set by currently run­
              ning IPTraf processes.  Use with  extreme  caution.
              This  will  cause  this  instance to think it's the
              only copy of IPTraf running,  and  may  cause  con­
              flicts  with  other  IPTraf  instances should it be
              misused.  This option may be used to  recover  from
              an abnormal termination.

       -q     no  longer  needed, maintained only for compatibil­
              ity.

       -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/local/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  manual  page  modifications  by  Gerard Paul Java
       (riker@mozcom.com)