iptraf(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 ] [ { -i iface | -g | -d iface | -s iface | -z
10       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 command is issued without any command-line options, the  program
18       comes  up  in  interactive  mode,  with the various facilities accessed
19       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       -q     no longer needed, maintained only for compatibility.
69
70       -h     shows a command summary
71

SIGNALS

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

FILES

78        /var/log/iptraf/*.log - log file
79        /var/lib/iptraf/* - important IPTraf data files
80
81

AUTHOR

87       Gerard Paul Java (riker@mozcom.com)
88
89

MANUAL AUTHOR

91       Frederic Peters (fpeters@debian.org), using iptraf --help General  man‐
92       ual page modifications by Gerard Paul Java (riker@mozcom.com)
93
94
95
96
97                               IPTraf Help Page                      IPTRAF(8)