DragonFly On-Line Manual Pages

TCPPROF(1)             DragonFly General Commands Manual            TCPPROF(1)

NAME
     tcpprof - report profile of network traffic

SYNOPSIS
     tcpprof [-?hdnpR] [-f filter expr] [-i interface] [-P port] [-r filename]
             [-s seconds] [-S letters] [-t lines]

DESCRIPTION
     tcpprof reports a profile of network traffic by ranking it by link type,
     ip protocol, TCP/UDP port, ip address, or network address.

     Network information is collected either by reading data from filename, or
     by directly monitoring the network interface interface.  The default
     action for tcpprof is to automatically search for an appropriate
     interface, and to generate a profile before it exits.

     When reading data from filename, tcpprof will display the profile and
     exit immediately after the entire file has been processed.  When
     collecting data from interface, tcpprof will keep running unless the -s
     option had been specified.

OPTIONS
     The options are as follows:

     -f filter expr
                 Filter the packets according the rules given by filter expr.
                 For the syntax of these rules, see tcpdump(1).  The argument
                 must be quoted if it contains spaces in order to separate it
                 from other options.

     -h, -?      Display version and a brief help message.

     -d          tcpprof will track the source and destination information
                 separately, where applicable, and identify source data with a
                 ">" and destination data with "<".  For example, a "http <"
                 statistic signifies all traffic with destination port 80
                 (http). This option only applies to port, host and network
                 statistics.

     -i interface
                 Do a live capture (rather than read from a file) on the
                 interface interface given on the command line.  If interface
                 is "auto" then tcpprof tries to find an appropriate one by
                 itself.

     -P port     This tells tcpprof to ignore TCP and UDP ports greater than
                 or equal to port when displaying port statistics.  This is
                 not the same as filtering these port numbers out of the data
                 set.  This way, packets with i.e. the source port above port
                 and the destination port below port will be able to still
                 count the lower port number as a statistic.  In addition,
                 this doesn't affect the other statistic types (link,
                 protocol, etc.)

     -p          Set the interface into non-promiscuous mode (promiscuous is
                 the default) when doing live captures.

     -r filename
                 Read all data from filename, which may be a regular file, a
                 named pipe or "-" to read it's data from standard input.
                 Acceptable file formats include pcap (tcpdump(1) files) and
                 "snoop" format files.  filename is usually a file created by
                 the tcpdump(1) command using the "-w" option.

     -S letters  Tells tcpprof which statistics to display.  letters must be a
                 string of one or more of the following letters:

                 l     show stats about the link layer

                 i     show stats about all ip protocols

                 p     show stats about TCP/UDP ports

                 h     show stats about hosts/ip addresses

                 n     show stats about network addresses

                 a     a synonym for "liphn"

     -s seconds  When monitoring an interface, tcpprof runs for only seconds
                 seconds, and then quits.  Has no effect when reading data
                 from a file.

     -t lines    When printing a profile of the data, tcpprof will display a
                 maximum of lines lines for each statistic.

SIGNALS
     Upon receiving a SIGINT, tcpprof will print any remaining statistics, and
     then exit.

FILES
     /dev/bpfn    the packet filter device

EXAMPLES
           tcpprof -i fxp0 -S a

     Displays a complete profile of network data passing through the fxp0
     network interface, after the user enters ^C (control C).

           tcpprof -r file.dump -S a

     Displays a complete profile of network data from the tcpdump(1) generated
     file "file.dump".

SEE ALSO
     tcpdump(1), pcap(3), bpf(4)

HISTORY
     tcpprof was first written along side tcpstat in Winter 1998 using FreeBSD
     3.0, and then finaly retrofited for Linux in Spring 2000.  It became
     installed along with tcpstat since version 1.5.

AUTHORS
     Paul Herman <pherman@frenchfries.net>
     Cologne, Germany.

     Please send all bug reports to this address.

BUGS
     Not tested with link types other than Ethernet, PPP, and "None" types.

     There may be problems reading non-IPv4 packets across platforms when
     reading null type link layers.  This is due to a lack of a standardized
     packet type descriptor in libpcap for this link type.

     Snoop file formats cannot be read from stdin or named pipes.

DragonFly 6.5-DEVELOPMENT      December 22, 2001     DragonFly 6.5-DEVELOPMENT