iptraf-ng(8)

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

NAME

6       iptraf - Interactive Colorful IP LAN Monitor
7

SYNOPSIS

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

DESCRIPTION

13       iptraf-ng is an ncurses-based IP LAN  monitor  that  generates  various
14       network statistics including TCP info, UDP counts, ICMP and OSPF infor‐
15       mation, Ethernet load info, node stats, IP checksum errors, and others.
16
17       If the iptraf-ng command is issued without  any  command-line  options,
18       the  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-ng to run the specified facility for  only  timeout
48              minutes.  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  (de‐
59              tailed  interface statistics, TCP/UDP service statistics, packet
60              size breakdown), or the instance of  the  facility  (IP  traffic
61              monitor,  LAN station monitor).  If a path is not specified, the
62              log file is placed in /var/log/iptraf-ng
63
64       -f     clears all locks and counters, causing this instance of  IPTraf-
65              ng  to  think  it's  the first one running.  This should only be
66              used to recover from an abnormal termination or system crash.
67
68       -h     shows a command summary
69

SIGNALS

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

FILES

76        /var/log/iptraf-ng/*.log - log file
77        /var/lib/iptraf-ng/* - important IPTraf-ng data files
78
79

AUTHOR

85       Gerard Paul Java (riker@mozcom.com)
86
87

MANUAL AUTHOR

89       Frederic Peters (fpeters@debian.org), using iptraf-ng -h General manual
90       page modifications by Gerard Paul Java (riker@mozcom.com), Phil Cameron
91       (pcameron@redhat.com)
92
93
94
95
96                              IPTraf-ng Help Page                 IPTRAF-NG(8)