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