<tracer_tool>.add-filter <tracer_tool>.delete
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<tracer_tool>.add-instrumentation

Synopsis

<tracer_tool>.add-instrumentation ([ processors ... ] | list of processors) [parent] [-connect-all] ["group"] [-trace-data] [-trace-instructions] [-trace-exceptions] [-print-virtual-address] [-print-physical-address] [-print-linear-address] [-print-opcode] [-print-access-type] [-print-memory-type] [-print-register-changes] [-print-old-value] [-use-cpu-number] [-remove-duplicates]

Description

Connects the tool to one or several processors as given by the processors argument.The parent argument specifies an hierarchical object and all processors below this object matching the provider requirements will be added 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.

Provided By

instrumentation-tracer-tool
<tracer_tool>.add-filter <tracer_tool>.delete