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