source: tools/tracertstats/tracertstats.1 @ 322c516

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivelibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 322c516 was d2df7c4, checked in by Shane Alcock <salcock@…>, 6 years ago

Make -c option work for tracertstats

It's only an approximate stopping point (a lower bound to be exact), as we
only check whether we've passed the count in the reporting thread.

Removed references to tracertstats_parallel from Makefile.am

  • Property mode set to 100644
File size: 2.8 KB
Line 
1.TH TRACERTSTATS "1" "November 2006" "tracertstats (libtrace)" "User Commands"
2.SH NAME
3tracertstats \- perform simple filter based analysis on a trace
4.SH SYNOPSIS
5.B tracertstats
6[ -f | --filter bpf ]
7[ -i | --interval interval ]
8[ -t | --threads max ]
9[ -c | --count count ]
10[ -o | --output-format csv,txt,png,html ]
11[ -m | --merge-inputs ]
12inputuri...
13.P
14.B tracertstats
15-H|--libtrace-help
16.SH DESCRPTION
17tracertstats takes a list of bpf expressions and outputs the number of packets
18and bytes that match that expression every interval seconds, or count packets.
19.TP
20.PD 0
21.BI \-f " bpf-filter"
22.TP
23.PD
24.BI \-\^\-filter " bpf-filter"
25Add another "bpf filter"
26
27.TP
28.PD 0
29.BI \-i " interval"
30.TP
31.PD
32.BI \-\^\-interval " interval"
33Output results every \fIinterval\fR seconds.
34
35.TP
36.PD 0
37.BI \-t " max"
38.TP
39.PD
40.BI \-\^\-threads " max"
41Use \fImax\fR packet processing threads. The default is 4 threads, but adding
42more or less threads may improve performance.
43
44.TP
45.PD 0
46.BI \-c " count"
47.TP
48.PD
49.BI \-\^\-count " count"
50Stop after processing this amount of packets. Note that this is only a
51lower bound as this is only evaluated once per thread per interval.
52
53.TP
54.PD 0
55.BI \-m
56.TP
57.PD
58.BI \-\^\-merge-inputs
59Treats all inputs as a single input, resulting a single unified output rather
60than an output for each input. Works best with traces that are consecutive to
61create a single CSV, for instance.
62
63.TP
64.PD 0
65.BI \-o " format"
66.TP
67.PD
68.BI \-\^\-output\-format " format"
69Selects the output format.
70
71.RS
72.TP
73txt
74Human readable text.  This is the default output format which provides output
75easily understood by a human.  This format has the disadvantage that it takes
76up quite a bit of horizontal space.
77
78.TP
79csv
80Comma Seperated Values. This is suitable for further analysis in a spreadsheet,
81or other program.
82
83.TP
84png
85PNG Graphic.  Produces a fairly incomprehensible png graph.  This relies on
86gdc being available at compile time.
87
88.TP
89html
90This produces output suitable for display to a human in a webbrowser.
91
92.SH EXAMPLES
93.nf
94tracertstats \-\^\-filter 'host sundown' \\
95        \-\^\-filter 'port http' \\
96        \-\^\-filter 'port ftp or ftp-data' \\
97        \-\^\-filter 'port smtp' \\
98        \-\^\-filter 'tcp[tcpflags] & tcp-syn!=0' \\
99        \-\^\-filter 'not ip' \\
100        \-\^\-filter 'ether[0] & 1 == 1' \\
101        \-\^\-filter 'icmp[icmptype] == icmp-unreach' \\
102        \-\^\-output\-format html
103        erf:/traces/trace1.gz \\
104        erf:/traces/trace2.gz
105.fi
106
107.SH LINKS
108More details about tracertstats (and libtrace) can be found at
109http://www.wand.net.nz/trac/libtrace/wiki/UserDocumentation
110
111.SH SEE ALSO
112libtrace(3), tracemerge(1), tracesplit(1), tracesplit_dir(1), tracefilter(1),
113traceconvert(1), tracereport(1), tracepktdump(1), traceanon(1), tracesummary(1),
114traceconvert(1), tracereplay(1), tracediff(1), traceends(1), tracetopends(1)
115
116.SH AUTHORS
117Perry Lorier <perry@cs.waikato.ac.nz>
Note: See TracBrowser for help on using the repository browser.