<tcf_exec_tracer>.save file [-overwrite] [-text-format] [index-granularity]
This command saves the collected traces to the file specified in file. If the file already exists, -overwrite must be used to overwrite the contents. The format is binary by default unless -text-format is set. If not traces are available, nothing will be saved. Available traces can be checked with tcf_exec_tracer.status.
When saving a binary trace file (not using -text-format), an index map file is created with the same name as the trace file but ending with .idx (for example trace1.bin.idx). The index map file contains entries that map CPU time and file offsets to specific trace lines, allowing selective decoding and faster seeking when analyzing large trace files offline.
The index-granularity parameter controls how many consecutive trace lines are represented by each index entry. The default value is 100000 (one entry per trace line). Higher values reduce index file size but decrease seek precision. For example, with index-granularity=10, each index entry covers 10 trace lines, reducing the index file size by approximately 90%.
tcf-agent
new-tcf-exec-tracer,
<tcf_exec_tracer>.clear,
<tcf_exec_tracer>.delete,
<tcf_exec_tracer>.disable,
<tcf_exec_tracer>.enable,
<tcf_exec_tracer>.properties,
<tcf_exec_tracer>.status,
<tcf_exec_tracer_manager>.delete,
<tcf_exec_tracer_manager>.disable,
<tcf_exec_tracer_manager>.enable,
<tcf_exec_tracer_manager>.new,
<tcf_exec_tracer_manager>.status