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 finally
       retrofitted 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.

Debian                                          December 22, 2001                                     TCPPROF(1)