The file argument specifies a file to write the trace to, without any file, the trace will be printed to standard out.
The optional name argument can be used to set a name of the created object. If no name is given, a default name trace followed by a sequence number is generated (trace0, trace1,...).
The optional processors argument, supports connecting one or several processors directly. With the optional parent argument a hierarchical object can be specified and all processors below this object matching the provider requirements will be connected to the tool. The -connect-all flag can be given to add a connection to all supported processors in the configuration.
The optional argument group let a user specify a named instrumentation group to use for the connection. (See add-instrumentation-group for details on named groups.)
Each new connection to the tracer tool can be configured by supplying the following flags:
-trace-data : Enabling tracing of data operations.
-trace-instructions : Enabling tracing of instruction.
-trace-exceptions : Enabling tracing of exceptions.
-print-register-changes : Print register changes after traced instruction and/or traced exception. Registers that normally change with every instruction, like program counter or cycles counter, are not listed.
-print-old-value : Print the previous register value together with register changes.
-print-virtual-address : Print the virtual address of an entry.
-print-physical-address : Print the physical address of an entry.
-print-linear-address : Print the linear address of an entry (only x86).
-print-opcode : Print the opcode of an instruction entry.
-print-access-type : Print the access type (only x86).
-print-memory-type : Print the memory type (only x86).
-use-cpu-number : Print the CPU number instead of its name.
-remove-duplicates : Remove duplicated lines from the output.
If none of the -print... or -trace.. flags are given all of those will be enabled by default except -print-register-changes, i.e., trace and print everything except register changes.
If only -print-register-changes are given everything including register changes will be enabled.