manpagez: man pages & more
man kpfile(1)
Home | html | info | man


kpfile(1)                 BSD General Commands Manual                kpfile(1)


NAME

     kpfile -- convert raw kernel trace files


SYNOPSIS

     kpfile [-iv] [-F hz] file ...
     kpfile -t [-Nv] [-F hz] [-o output-file] [-c code-file] file
     kpfile -z [-v123] [-F hz] [-o output-file] file ...
     kpfile -V version [-v0123] [-F hz] [-o output-file] file ...


DESCRIPTION

     The kpfile program converts raw kernel trace files to a different version
     of the raw trace file format. Files are converted in place unless an
     alternate output file is set by -o output-file.

     In -t mode, the trace file is printed in text form.

     In -i mode, summary information about the trace files is printed.

     The following options are available:

     -c code-file
             Import trace codes from code-file in addition to the default set
             in /usr/share/misc/trace.codes.  If the option is given more than
             once, the code files are merged.

     -F hz   Provide the timebase frequency. Version 1 trace files don't
             include the frequency of the timebase used to generate time-
             stamps, and kpfile makes an educated guess. Use this option to
             override the guess. It has no effect when reading trace files
             with an embedded timebase frequency. See also the hw.tbfrequency
             sysctl OID.

     -H      Use default parameters from the local host. This will include
             hw.tbfrequency and hw.model values from the host running the
             kpfile tool when converting trace files that don't include this
             information. This is appropriate when converting traces that were
             recorded on the same machine.

     -h      Print help message.

     -i      Print summary information about trace files.

     -N      Do not import trace codes from /usr/share/misc/trace.codes.

     -o file
             Write output to file instead of converting files in place.

     -t      Print trace file as text.

     -V v    Convert trace files to version v.  Supported format versions are
             1, 2, and 3.

     -v      Print extra information.

     -z      Compress trace files. Files are converted to the preferred format
             version that supports compressed event data.

     -0      Don't compress trace files.

     -1      Use the fastest compression level.

     -2      Use the medium compression level.

     -3      Use the best compression level. This is the default.


SEE ALSO

     fs_usage(1), latency(1), trace(1)

Darwin                         January 10, 2014                         Darwin

OS X 10.10 - Generated Thu Oct 30 07:40:49 CDT 2014
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.