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. Offset is the offset in the ram/rom object where the access hits. 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 lets 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. If -block-only is given, no tracing will occur, but the tool will still block caching of ram/rom pages which is useful for other tools, such as the transaction-tracer.