The file argument specifies a file to write the trace to. Without a file, the trace is printed to standard output.
If trace-history-size is set, the tool keeps entries in a cyclic memory buffer instead of writing continuously. The buffer can be saved to a file with save-trace-buffer or viewed with print-trace-buffer.
The address-type argument selects the type of address to trace. Use virtual (default) for virtual addresses or physical for physical addresses.
If -print-processor is specified, each trace entry is prefixed with the processor name.
If -print-engine is specified, each trace entry is prefixed with the engine used to execute the instruction.
If -thread-safe is specified, a mutex is used to protect the trace buffer from concurrent access when multiple processors run in parallel. Without this flag, buffer updates are faster but may produce incorrect results if processors execute simultaneously.
The optional name argument can be used to set a name of the created object. If no name is given, a default name pc_trace followed by a sequence number is generated (pc_trace0, pc_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 lets a user specify a named instrumentation group to use for the connection. (See add-instrumentation-group for details on named groups.)