source: tools/tracertstats/tracertstats.1 @ 3298e12

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivegetfragoffhelplibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 3298e12 was 3298e12, checked in by Shane Alcock <salcock@…>, 12 years ago
  • Fixed copy and paste error in the tracertstats man-page
  • Property mode set to 100644
File size: 2.1 KB
Line 
1.TH TRACESTATS "1" "November 2006" "tracestats (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[ -c | --count count ]
9[ -o | --output-format csv,txt,png,html ]
10inputuri...
11.P
12.B tracertstats
13-H|--libtrace-help
14.SH DESCRPTION
15tracertstats takes a list of bpf expressions and outputs the number of packets
16and bytes that match that expression every interval seconds, or count packets.
17.TP
18.PD 0
19.BI \-f " bpf-filter"
20.TP
21.PD
22.BI \-\^\-filter " bpf-filter"
23Add another "bpf filter"
24
25.TP
26.PD 0
27.BI \-i " interval"
28.TP
29.PD
30.BI \-\^\-interval " interval"
31Output results every \fIinterval\fR seconds.
32
33.TP
34.PD 0
35.BI \-c " count"
36.TP
37.PD
38.BI \-\^\-count " count"
39Output results every \fIcount\fR packets.
40
41.TP
42.PD 0
43.BI \-o " format"
44.TP
45.PD
46.BI \-\^\-output\-format " format"
47Selects the output format
48
49.RS
50.TP
51txt
52Human readable text.  This is the default output format which provides output
53easily understood by a human.  This format has the disadvantage that it takes
54up quite a bit of horizontal space.
55
56.TP
57csv
58Comma Seperated Values. This is suitable for further analysis in a spreadsheet,
59or other program.
60
61.TP
62png
63PNG Graphic.  Produces a fairly incomprehensible png graph.  This relies on
64gdc being available at compile time.
65
66.TP
67html
68This produces output suitable for display to a human in a webbrowser.
69
70.SH EXAMPLES
71.nf
72tracertstats \-\^\-filter 'host sundown' \\
73        \-\^\-filter 'port http' \\
74        \-\^\-filter 'port ftp or ftp-data' \\
75        \-\^\-filter 'port smtp' \\
76        \-\^\-filter 'tcp[tcpflags] & tcp-syn!=0' \\
77        \-\^\-filter 'not ip' \\
78        \-\^\-filter 'ether[0] & 1 == 1' \\
79        \-\^\-filter 'icmp[icmptype] == icmp-unreach' \\
80        \-\^\-output\-format html
81        erf:/traces/trace1.gz \\
82        erf:/traces/trace2.gz
83.fi
84
85.SH LINKS
86More details about tracertstats (and libtrace) can be found at
87http://www.wand.net.nz/trac/libtrace/wiki/UserDocumentation
88
89.SH SEE ALSO
90libtrace(3), tracemerge(1), tracesplit(1), tracesplit_dir(1), tracefilter(1),
91traceconvert(1), tracereport(1), tracedump(1), traceanon(1), tracesummary(1)
92
93.SH AUTHORS
94Perry Lorier <perry@cs.waikato.ac.nz>
Note: See TracBrowser for help on using the repository browser.