xref: /aosp_15_r20/external/trace-cmd/Documentation/trace-cmd/trace-cmd-convert.1.txt (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)
1TRACE-CMD-CONVERT(1)
2===================
3
4NAME
5----
6trace-cmd-convert - convert trace files
7
8SYNOPSIS
9--------
10*trace-cmd convert* ['OPTIONS'] ['output-file']
11
12DESCRIPTION
13-----------
14The trace-cmd(1) convert command converts trace file. It reads the input file and copies the data
15into an output file. The output file may be in different format, depending on the command line
16arguments.
17
18OPTIONS
19-------
20*-i* 'input-file'::
21    By default, trace-cmd convert will read the file 'trace.dat'. But the *-i*
22    option open up the given 'input-file' instead.
23
24*-o* 'out-file'::
25    The name of the output file, this parameter is mandatory. Note, the output file may also be
26    specified as the last item on the command line.
27
28*--file-version*::
29    Desired version of the output file. Supported versions are 6 or 7.
30
31*--compression*::
32    Compression of the trace output file, one of these strings can be passed:
33
34    'any'  - auto select the best available compression algorithm
35
36    'none' - do not compress the trace file
37
38    'name' - the name of the desired compression algorithms. Available algorithms can be listed with
39    trace-cmd list -c
40
41*--help*::
42    Print usage information.
43
44EXAMPLES
45--------
46
47# trace-cmd convert --compression any trace_compress.dat
48
49SEE ALSO
50--------
51trace-cmd(1), trace-cmd.dat(1)
52
53AUTHOR
54------
55*Steven Rostedt* <[email protected]>, author of *trace-cmd*.
56*Tzvetomir Stoyanov* <[email protected]>, author of this man page.
57
58RESOURCES
59---------
60https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
61
62COPYING
63-------
64Copyright \(C) 2021 VMware. Free use of this software is granted under
65the terms of the GNU Public License (GPL).
66