trace-cmd-split(1) — Linux manual page


TRACE-CMD-SPLIT(1)          libtracefs Manual         TRACE-CMD-SPLIT(1)

NAME         top

       trace-cmd-split - split a trace.dat file into smaller files

SYNOPSIS         top

       trace-cmd split [OPTIONS] [start-time [end-time]]

DESCRIPTION         top

       The trace-cmd(1) split is used to break up a trace.dat into small
       files. The start-time specifies where the new file will start at.
       Using trace-cmd-report(1) and copying the time stamp given at a
       particular event, can be used as input for either start-time or
       end-time. The split will stop creating files when it reaches an
       event after end-time. If only the end-time is needed, use 0.0 as
       the start-time.

       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.

OPTIONS         top

       -i file
           If this option is not specified, then the split command will
           look for the file named trace.dat. This options will allow
           the reading of another file other than trace.dat.

       -o file
           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 '.#\' to the end:
           trace.dat.1, trace.dat.2, etc.

               This option will change the name of the base file used.

               -o file  will create file.1, file.2, etc.

       -s seconds
           This specifies how many seconds should be recorded before the
           new file should stop.

       -m milliseconds
           This specifies how many milliseconds should be recorded
           before the new file should stop.

       -u microseconds
           This specifies how many microseconds should be recorded
           before the new file should stop.

       -e events
           This specifies how many events should be recorded before the
           new file should stop.

       -p pages
           This specifies the number of pages that should be recorded
           before the new file should stop.

               Note: only one of *-p*, *-e*, *-u*, *-m*, *-s* may be specified at a time.

               If *-p* is specified, then *-c* is automatically set.

           This option causes the break up to repeat until end-time is
           reached (or end of the input if end-time is not specified).

               trace-cmd split -r -e 10000

               This will break up trace.dat into several smaller files, each with at most
               10,000 events in it.

           This option causes the above break up to be per CPU.

               trace-cmd split -c -p 10

               This will create a file that has 10 pages per each CPU from the input.

       -C cpu
           This option will split for a single CPU. Only the cpu named
           will be extracted from the file.

               trace-cmd split -C 1

               This will split out all the events for cpu 1 in the file.

           This allows to keep the top buffer. The top buffer can be
           renamed using the -b option.

               trace-cmd split --top

               This will keep only the top buffer.

               trace-cmd split --top -b old_top

               This will keep only the top buffer and rename it 'old_top'.

       -B buffer
           This allows to keep the selected buffer. A buffer can be
           promoted to the top buffer using the -t option.

               trace-cmd split -B timer -B sched

               This will keep the 'timer' and 'sched' buffers.

               trace-cmd split -B timer -t -B sched

               This will keep the 'timer' and 'sched' buffers, with the events
               from the 'timer' buffer promoted to the top instance.

SEE ALSO         top

       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)

AUTHOR         top

       Written by Steven Rostedt, <[1]>

RESOURCES         top 

COPYING         top

       Copyright (C) 2010 Red Hat, Inc. Free use of this software is
       granted under the terms of the GNU Public License (GPL).

NOTES         top


COLOPHON         top

       This page is part of the trace-cmd (a front-end for Ftrace)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this
       manual page, see ⟨⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-02-22.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

libtracefs                     06/13/2024             TRACE-CMD-SPLIT(1)

Pages that refer to this page: trace-cmd(1)trace-cmd-agent(1)trace-cmd-attach(1)trace-cmd-check-events(1)trace-cmd-clear(1)trace-cmd-extract(1)trace-cmd-hist(1)trace-cmd-list(1)trace-cmd-listen(1)trace-cmd-mem(1)trace-cmd-options(1)trace-cmd-profile(1)trace-cmd-record(1)trace-cmd-report(1)trace-cmd-reset(1)trace-cmd-restore(1)trace-cmd-set(1)trace-cmd-show(1)trace-cmd-snapshot(1)trace-cmd-stack(1)trace-cmd-start(1)trace-cmd-stat(1)trace-cmd-stop(1)trace-cmd-stream(1)trace-cmd.dat.v6(5)trace-cmd.dat.v7(5)