iptraf-ng(8)

1IPTRAF(8)                   System Manager's Manual                  IPTRAF(8)
2
3
4

NAME

6       iptraf - Interactive Colorful IP LAN Monitor
7

SYNOPSIS

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

DESCRIPTION

13       iptraf is an ncurses-based IP LAN monitor that generates  various  net‐
14       work  statistics including TCP info, UDP counts, ICMP and OSPF informa‐
15       tion, Ethernet load info, node stats, IP checksum errors, and others.
16
17       If the iptraf command is issued without any command-line  options,  the
18       program  comes  up  in  interactive  mode,  with the various facilities
19       accessed through the main menu.
20
21

OPTIONS

23       These options can also be supplied to the command:
24
25       -i iface
26              immediately start the IP traffic monitor on the specified inter‐
27              face, or all interfaces if "-i all" is specified
28
29       -g     immediately start the general interface statistics
30
31       -d iface
32              allows  you  to  immediately start the detailed on the indicated
33              interface (iface)
34
35       -s iface
36              allows you to immediately monitor TCP and  UDP  traffic  on  the
37              specified interface (iface)
38
39       -z iface
40              shows packet counts by size on the specified interface
41
42       -l iface
43              start the LAN station monitor on the specified interface, or all
44              LAN interfaces if "-l all" is specified
45
46       -t timeout
47              tells IPTraf to run the specified facility for only timeout min‐
48              utes.   This  option  is used only with one of the above parame‐
49              ters.
50
51       -B     redirect standard output to /dev/null,  closes  standard  input,
52              and  forks  the  program  into the background.  Can be used only
53              with one of the facility invocation parameters above.  Send  the
54              backgrounded process a USR2 signal to terminate.
55
56       -L logfile
57              allows  you  to specify an alternate log file name.  The default
58              log  file  name  is  based  on  either  the  interface  selected
59              (detailed  interface  statistics,  TCP/UDP  service  statistics,
60              packet size breakdown), or the  instance  of  the  facility  (IP
61              traffic  monitor, LAN station monitor).  If a path is not speci‐
62              fied, the log file is placed in /var/log/iptraf
63
64       -f     clears all locks and counters, causing this instance  of  IPTraf
65              to  think  it's the first one running.  This should only be used
66              to recover from an abnormal termination or system crash.
67
68       -u     allow use of unsupported interfaces as ethernet  devices.   This
69              is  needed  if you changed the name of an interface (ex: ip link
70              set eth0 name foo0)
71
72       -q     no longer needed, maintained only for compatibility.
73
74       -h     shows a command summary
75

SIGNALS

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

FILES

82        /var/log/iptraf/*.log - log file
83        /var/lib/iptraf/* - important IPTraf data files
84
85

AUTHOR

91       Gerard Paul Java (riker@mozcom.com)
92
93

MANUAL AUTHOR

95       Frederic Peters (fpeters@debian.org), using iptraf  -h  General  manual
96       page modifications by Gerard Paul Java (riker@mozcom.com)
97
98
99
100
101                               IPTraf Help Page                      IPTRAF(8)