new-instruction-count new-korben
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

new-instruction-histogram

Synopsis

new-instruction-histogram ["name"] [view] ([ processors ... ] | list of processors) [parent] [-connect-all] ["group"]

Description

Creates a new instruction_histogram object which can be connected to processors which support instrumentation. This tool can be used to get an instruction histogram based of the frequency of the instructions that have been executed.

The view argument decides which instruction "perspective" that should be collected. Currently there are four choices:
1. mnemonic - Groups all instructions with the same first word in the instruction disassembly.
2. size - Groups the instructions by the length of the instruction.
3. xed-iform - Uses IntelĀ® X86 Encoder Decoder (IntelĀ® XED) module and groups the x86 instruction by their instruction form definition.
4. x86-normalized - The instruction disassembly, but replaces register names and immediates with normalized names.
Default, the mnemonic view is used. The xed-iform and x86-normalized views are only applicable when connected to x86 target processors.

The optional name argument can be used to set a name of the created object. If no name is given, a default name ihist followed by a sequence number is generated (ihist0, ihist1,...).

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.)

Provided By

instruction-histogram
new-instruction-count new-korben