The view argument decides which instruction "perspective" that should be collected. Currently there are eight 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, e.g., ADD_GPRv_GPRv_01.
4. xed-extension - Uses Intel® X86 Encoder Decoder (Intel® XED) module and groups the x86 instruction by their extension, e.g., SSE.
5. xed-isa-set - Uses Intel® X86 Encoder Decoder (Intel® XED) module and groups the x86 instruction by their isa-set, e.g., I386.
6. xed-iclass - Uses Intel® X86 Encoder Decoder (Intel® XED) module and groups the x86 instruction by their iclass, e.g., ADD.
7. xed-category - Uses Intel® X86 Encoder Decoder (Intel® XED) module and groups the x86 instruction by their category, e.g., LOGICAL.
8. x86-normalized - The instruction disassembly, but replaces register names and immediates with normalized names.
Default, the mnemonic view is used. The xed-iform, xed-extension, xed-isa-set, xed-iclass, xed-contegory, 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 lets a user specify a named instrumentation group to use for the connection. (See add-instrumentation-group for details on named groups.)