TRACETOPENDS(1)

NAME
tracetopends - reports the endpoints that are responsible for the most traffic in a trace

SYNOPSIS
tracetopends [ -t threads ] [ -f bpf ] [ -A addrtype ] [ -S ] [ -D ] [ -s ] [ -d ] [ -b ] [ -a ] [ -p ] [ -n topcount ] inputuri [inputuri ...]

DESCRIPTION
tracetopends reports the number of bytes and packets sent and received by the busiest endpoints observed in the input trace(s).

OPTIONS

-t threads
    Use the given number of threads for packet processing. Defaults to 1 thread.

-f bpf filter
    Output only packets that match tcpdump style bpf filter.

-n top count
    Report the top N endpoints (defaults to 10).

-A address type
    Specifies how an endpoint should be defined. Suitable options are "mac", "v4" and "v6" which will report endpoint stats for each observed MAC address, IPv4 address and IPv6 address respectively.

-S  Do not track endpoints which are sending traffic. Mutually exclusive with the -D option.

-D  Do not track endpoints which are receiving traffic. Mutually exclusive with the -S option.

-s  Sort endpoints based on the amount of outgoing traffic (will cancel any previous -d option. This is on by default.

-d  Sort endpoints based on the amount of incoming traffic (will cancel any previous -s option.

-b  Sort endpoints based on the amount of IP traffic (will cancel any previous -a or -p options. This is on by default.

-a  Sort endpoints based on the amount of application layer traffic (will cancel any previous -b or -p options.

-p  Sort endpoints based on the amount of packets (will cancel any previous -b or -a options.

OUTPUT
Output is written to stdout in columns separated by blank space. The columns are (in order):
 * Endpoint address
 * Time last observed
 * Packets originating from the endpoint
 * Bytes originating from the endpoint (IP header onwards)
 * Payload originating from the endpoint (post transport header)
 * Packets sent to the endpoint
 * Bytes sent to the endpoint (IP header onwards)
 * Payload sent to the endpoint (post transport header)

EXAMPLES
Find the IPv4 addresses that are sending the most traffic.
tracetopends -A v4 -b -s -D erf:trace.erf.gz

LINKS
More details about tracetopends (and libtrace) can be found at https://github.com/LibtraceTeam/libtrace/wiki

SEE ALSO
libtrace(3), tracemerge(1), tracefilter(1), traceconvert(1), tracesplit_dir(1), tracereport(1), tracertstats(1), tracestats(1), tracepktdump(1), traceanon(1), tracesummary(1), tracereplay(1), tracediff(1), traceends(1)

AUTHORS
Shane Alcock <salcock@cs.waikato.ac.nz>