'\" t
.\"     Title: trace-cmd-split
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 09/11/2020
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "TRACE\-CMD\-SPLIT" "1" "09/11/2020" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
trace-cmd-split \- split a trace\&.dat file into smaller files
.SH "SYNOPSIS"
.sp
\fBtrace\-cmd split\fR [\fIOPTIONS\fR] [\fIstart\-time\fR [\fIend\-time\fR]]
.SH "DESCRIPTION"
.sp
The trace\-cmd(1) split is used to break up a trace\&.dat into small files\&. The \fIstart\-time\fR specifies where the new file will start at\&. Using \fItrace\-cmd\-report(1)\fR and copying the time stamp given at a particular event, can be used as input for either \fIstart\-time\fR or \fIend\-time\fR\&. The split will stop creating files when it reaches an event after \fIend\-time\fR\&. If only the end\-time is needed, use 0\&.0 as the start\-time\&.
.sp
If start\-time is left out, then the split will start at the beginning of the file\&. If end\-time is left out, then split will continue to the end unless it meets one of the requirements specified by the options\&.
.SH "OPTIONS"
.PP
\fB\-i\fR \fIfile\fR
.RS 4
If this option is not specified, then the split command will look for the file named
\fItrace\&.dat\fR\&. This options will allow the reading of another file other than
\fItrace\&.dat\fR\&.
.RE
.PP
\fB\-o\fR \fIfile\fR
.RS 4
By default, the split command will use the input file name as a basis of where to write the split files\&. The output file will be the input file with an attached \*(Aq\&.#\e\*(Aq to the end: trace\&.dat\&.1, trace\&.dat\&.2, etc\&.
.sp
.if n \{\
.RS 4
.\}
.nf
This option will change the name of the base file used\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-o file  will create file\&.1, file\&.2, etc\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-s\fR \fIseconds\fR
.RS 4
This specifies how many seconds should be recorded before the new file should stop\&.
.RE
.PP
\fB\-m\fR \fImilliseconds\fR
.RS 4
This specifies how many milliseconds should be recorded before the new file should stop\&.
.RE
.PP
\fB\-u\fR \fImicroseconds\fR
.RS 4
This specifies how many microseconds should be recorded before the new file should stop\&.
.RE
.PP
\fB\-e\fR \fIevents\fR
.RS 4
This specifies how many events should be recorded before the new file should stop\&.
.RE
.PP
\fB\-p\fR \fIpages\fR
.RS 4
This specifies the number of pages that should be recorded before the new file should stop\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Note: only one of *\-p*, *\-e*, *\-u*, *\-m*, *\-s* may be specified at a time\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
If *\-p* is specified, then *\-c* is automatically set\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-r\fR
.RS 4
This option causes the break up to repeat until end\-time is reached (or end of the input if end\-time is not specified)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-r \-e 10000
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
This will break up trace\&.dat into several smaller files, each with at most
10,000 events in it\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-c\fR
.RS 4
This option causes the above break up to be per CPU\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-c \-p 10
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
This will create a file that has 10 pages per each CPU from the input\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-C\fR \fIcpu\fR
.RS 4
This option will split for a single CPU\&. Only the cpu named will be extracted from the file\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-C 1
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
This will split out all the events for cpu 1 in the file\&.
.fi
.if n \{\
.RE
.\}
.RE
.SH "SEE ALSO"
.sp
trace\-cmd(1), trace\-cmd\-record(1), trace\-cmd\-report(1), trace\-cmd\-start(1), trace\-cmd\-stop(1), trace\-cmd\-extract(1), trace\-cmd\-reset(1), trace\-cmd\-list(1), trace\-cmd\-listen(1)
.SH "AUTHOR"
.sp
Written by Steven Rostedt, <\m[blue]\fBrostedt@goodmis\&.org\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "RESOURCES"
.sp
git://git\&.kernel\&.org/pub/scm/linux/kernel/git/rostedt/trace\-cmd\&.git
.SH "COPYING"
.sp
Copyright (C) 2010 Red Hat, Inc\&. Free use of this software is granted under the terms of the GNU Public License (GPL)\&.
.SH "NOTES"
.IP " 1." 4
rostedt@goodmis.org
.RS 4
\%mailto:rostedt@goodmis.org
.RE