""

iftop.8

@@ -0,0 +1,84 @@
+.TH DRIFTNET 1
+.\"
+.\" iftop.1:
+.\" Manual page for iftop.
+.\"
+.\" $Id$
+.\"
+
+.SH NAME
+iftop - display bandwidth usage on a network interface by host
+
+.SH SYNOPSIS
+.B iftop
+.B -h
+| [
+.B -i
+.I interface
+] [
+.B -f
+.I filter code
+]
+
+.SH DESCRIPTION
+\fBiftop\fP listens to network traffic on a named \fIinterface\fP, or \fBeth0\fP
+if none is specified, and displays a table of current bandwidth usage by pairs
+of hosts.
+
+When run, \fBiftop\fP displays, for each pair of hosts, the rate at which data
+is sent and received averaged over 3, 15 and 60 second intervals. The direction
+of data flow is indicated by arrows, <= and =>. In addition, a simple bar graph
+shows the 15-second average. The pairs of hosts which consume the most bandwidth
+are displayed at the top of the screen.
+
+By default, \fBiftop\fP will look up the hostnames associated with addresses it
+finds in packets. This can cause substantial traffic of itself, and may result
+in a confusing display. You may wish to suppress display of DNS traffic by
+using filter code such as `not port domain', or switch it off entirely, by
+using the \fB-d\fP option or the `r' key when the program is running.
+
+.SH OPTIONS
+
+.TP
+.B -h
+Print a summary of usage.
+
+.TP
+.B -d
+Don't do hostname lookups. This setting may be altered at run time.
+
+.TP
+\fB-i\fP \fIinterface\fP
+Listen to packets on \fIinterface\fP.
+
+.TP
+\fB-f\fP \fIfilter code\fP
+Use \fIfilter code\fP to select the packets to count. Only IP packets are ever
+counted, so the specified code is evaluated as `(\fIfilter code\fP) and ip'.
+
+.SH SEE ALSO
+.BR tcpdump (8),
+.BR pcap (3),
+.BR driftnet (1)
+
+.SH AUTHOR
+Paul Warren <pdw@ex-parrot.com>
+
+.SH VERSION
+$Id$
+
+.SH COPYING
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+