For each access the following trace format will used: [dest object] <- initiator object I type offset size data where dest object is the destination ram/rom object, initiator object is the object that sends the transaction, I is displayed if the transaction is an inquiry access, type will be Execute, Read, or Write. Size is the size of the transaction in bytes and data is the raw content in bytes.
The file argument specifies a file to write the trace to, without any file, the trace will be printed to standard out.
The optional name argument can be used to set a name of the created object. If no name is given, a default name rt followed by a sequence number is generated (rt0, rt1,...).
The optional ram-objects argument, supports connecting one or several ram-objects directly. With the optional parent argument a hierarchical object can be specified and all ram-objects 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 ram-objects 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.)
The -read, -write, -execute flags can be set to only trace specific accesses. The -inquiry flag can be used to trace inquiry accesses as well. Every access is traced by default but with inquiry switched off.