source: tools/tracesplit/tracesplit.1 @ c7f1faf

.TH TRACESPLIT "1" "January 2011" "tracesplit (libtrace)" "User Commands"
.SH NAME
tracesplit \- split traces
.SH SYNOPSIS
.B tracesplit
[ \fB-f \fRbpf | \fB--filter=\fRbpf]
[ \fB-j \fRnumhdrs | \fB--jump=\fRnumhdrs]
[ \fB-c \fRcount | \fB--count=\fRcount]
[ \fB-b \fRbytes | \fB--bytes=\fRbytes]
[ \fB-i \fRseconds | \fB--seconds=\fRseconds]
[ \fB-s \fRunixtime | \fB--starttime=\fRunixtime]
[ \fB-e \fRunixtime | \fB--endtime=\fRunixtime]
[ \fB-m \fRmaxfiles | \fB--maxfiles=\fRmaxfiles]
[ \fB-S \fRsnaplen | \fB--snaplen=\fRsnaplen]
[ \fB-z \fRlevel | \fB--compress-level=\fRlevel]
[ \fB-Z \fRmethod | \fB--compress-type=\fRmethod]
inputuri [inputuri ...] outputuri
.SH DESCRIPTION
tracesplit splits the given input traces into multiple tracefiles
.TP
\fB\-f\fR bpf filter
output only packets that match tcpdump style bpf filter

.TP
\fB\-j\fR numhdrs
Strip headers before the numhdrs layer 3 header.  For example, \-j1 will strip
off all the layer 2 headers, \-j2 will strip off all the l2 headers, the first
l3 header, any transport headers, and return a trace that starts at the next
l3 header.

.TP
\fB\-c\fR count
output count packets per output file.  The output file will be named after
the basename given in the outputuri with the packet number of the first packet
in this file.

.TP
\fB\-b\fR bytes
output bytes bytes per file

.TP
\fB\-i\fR seconds
start a new tracefile after "seconds" seconds

.TP
\fB\-s\fR unixtime
don't output any packets before unixtime

.TP
\fB\-e\fR unixtime
don't output any packets after unixtime

.TP
\fB\-m\fR maxfiles
do not create more than "maxfiles" trace files

.TP
\fB\-S\fR snaplen
Truncate packets to "snaplen" bytes long.  The default is collect the entire
packet.

.TP
\fB\-z\fR level
Compress the data using the specified compression level, ranging from 0 to 9. 
Higher compression levels tend to result in better compression but require
more processing power to compress.

.TP
\fB-Z\fR compression-method
Compress the data using the specified compression algorithm. Accepted methods
are "gz", "bz", "lzo", "xz" or "no". Default value is "no" unless a 
compression level is specified, in which case gzip will be used.

.SH EXAMPLES
create a 1MB erf trace of port 80 traffic.
.nf
tracesplit \-z 1 -Z gzip \-f 'port 80' \-b $[ 1024 * 1024 ] 
erf:/traces/bigtrace.gz erf:/traces/port80.gz 
.fi

.SH LINKS
More details about tracesplit (and libtrace) can be found at
http://www.wand.net.nz/trac/libtrace/wiki/UserDocumentation

.SH 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), tracetopends(1)

.SH AUTHORS
Perry Lorier <perry@cs.waikato.ac.nz>