Changes between Initial Version and Version 1 of TraceReport


Ignore:
Timestamp:
02/28/07 11:45:50 (14 years ago)
Author:
spa1
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TraceReport

    v1 v1  
     1{{{tracereport}}} is a libtrace tool that is capable of producing a variety of different reports about a trace.
     2
     3=== Usage ===
     4{{{tracereport [ -f | --filter=bpf ] [ -e | --error ] [ -F | --flow ] [ -P | --protocol ] [ -p | --port ] [ -T | --tos ] }}}
     5{{{            [ -t | --ttl ] [ -O | --tcpoptions ] [ -o | --synoptions ] [ -n | --nlp ] [ -d | --direction ] [ -C | --ecn ] }}}
     6{{{            [ -s | --tcpsegment ] inputuri }}}
     7
     8=== Options ===
     9 {{{-f, --filter}}}::
     10   Only consider packets that match the bpf filter expression. See tcpdump(1) for the syntax of the bpf filter expression.
     11 {{{-e, --error}}}::
     12   Produce a report on the number of packets that contained errors of some sort, e.g. checksum failures or DAG rxerrors.
     13 {{{-F, --flow}}}::
     14   Produce a count of the number of flows observed in the trace.
     15 {{{-P, --protocol}}}::
     16   Produce a report on the transport layer protocols that are observed in the trace, e.g. TCP, UDP, ICMP.
     17 {{{-p, --port}}}::
     18   Produce a report on which port numbers are being used in the trace.
     19 {{{-T, --tos}}}::
     20   Produce a report that contains a breakdown of the values observed in the ToS field of the IP header.
     21 {{{-t, --ttl}}}::
     22   Produce a report that contains a breakdown of the TTL for packets in the trace.
     23 {{{-O, --tcpoptions}}}::
     24   Produce a report that details which TCP options are observed on all packets in the trace.
     25 {{{-o, --synoptions}}}::
     26   Produce a report that details which combinations of TCP options are observed on SYN packets in the trace.
     27 {{{-n, --nlp}}}::
     28   Produce a report on the network layer protocols that are observed in the trace.
     29 {{{-d, --direction}}}::
     30   Produce a report on the amount of traffic observed travelling in each direction in the trace.
     31 {{{-C, --ecn}}}::
     32   Produce a report on the usage of the ECN flag by packets in the trace.
     33 {{{-s, --tcpsegment}}}::
     34   Produce a report on the tcp segment sizes observed in the trace.
     35
     36=== Applications ===
     37
     38=== Output ===
     39Each different report will create a separate output file in the directory from which {{{tracereport}}} is run. At this stage, there is no way to specify the names of output files but this may be added in a future version of libtrace. Each output file is named so that it should be obvious which report is which.
     40
     41=== Notes ===
     42 * Unlike most of the other libtrace tools, {{{tracereport}}} is still under active development. Many of the existing reports do not yet conform to the new output scheme we have developed and will just write straight to stdout. We are also likely to add more reports in the future.
     43 * The version of tracereport that was distributed with the libtrace-3.0.0 release is actually quite different to what is described above - see the tracereport(1) manpage that came with your distribution for more details.