VIRTUTECH CONFIDENTIAL    Previous - Up - Next

branch_recorder

Provided by

Simics Core

Class Hierarchy

conf-object → branch_recorder

Interfaces Implemented

branch_arc, address_profiler

Description

A branch recorder records the branches taken by the zero or more processors that it is attached to. For each pair of addresses, the branch recorder keeps track of how many times the processors have branched from the first to the second address. This information can be used directly, or be processed to yield e.g. execution count for each address.

Attributes

Attributes inherited from class conf-object

attributes, classname, component, iface, name, object_id, queue

Attribute List

address_type

Required attribute; read/write access; type: Integer.

Record physical or virtual addresses?

clean

Pseudo attribute; write-only access; type: Nil.

Write nil to this attribute to erase all recorded branch arcs.

cpu_type

Pseudo attribute; read-only access; type: String.

Type of processor this branch recorder can handle.

num_arcs

Pseudo attribute; read-only access; type: Integer.

Number of branch arcs in this recorder.

processors

Optional attribute; read/write access; type: [o*].

Processors this branch recorder is attached to.

Command List

Commands defined by interface address_profiler

address-profile-data, address-profile-info, address-profile-toplist

Commands

clean	delete all branch arcs in the branch recorder
info	print information about the device
print-branch-arcs	print branch arcs
status	print status of the device

Command Descriptions

<branch_recorder>.clean

Synopsis

<branch_recorder>.clean

Description

Delete all branch arcs stored in the branch recorder.

<branch_recorder>.info

Synopsis

<branch_recorder>.info

Description

Print detailed information about the configuration of the device.

<branch_recorder>.print-branch-arcs

Synopsis

<branch_recorder>.print-branch-arcs ["direction"] [start] [stop]

Description

Print a subset of the branch arcs in a branch recorder. With no arguments, print all arcs. Given start and stop addresses, print only arcs with 'to' or 'from' address in that interval, depending on whether direction is 'to' or 'from' (its default value is 'from'). The printed arcs are sorted by their 'to' or 'from' address, as specified by direction.

<branch_recorder>.status

Synopsis

<branch_recorder>.status

Description

Print detailed information about the current status of the device.

VIRTUTECH CONFIDENTIAL    Previous - Up - Next