source: tools/tracertstats/tracertstats.1 @ 3bfeb7d

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivegetfragoffhelplibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 3bfeb7d was 67825b2, checked in by Perry Lorier <perry@…>, 15 years ago

Update all the man pages to make sure they refer to each other (and fix
any other typo's found along the way). This makes it easier to discover
new libtrace tools

  • Property mode set to 100644
File size: 2.0 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 \-i " 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 SEE ALSO
86libtrace(3), tracemerge(1), tracesplit(1), tracesplit_dir(1), tracefilter(1),
87traceconvert(1), tracereport(1), tracedump(1), traceanon(1), tracesummary(1)
88
89.SH AUTHORS
90Perry Lorier <perry@cs.waikato.ac.nz>
Note: See TracBrowser for help on using the repository browser.