The interface and class arguments can be used to filter the output, only including objects of a certain class, or implementing a certain interface.
If possible, the memory map will be probed using 'rwx' access mode. Otherwise, the mode specified by either of the -r, -w or -x flags is used, default is -r.
The command can probe the memory map recursively, or it can show the local map only. This can be controlled using the flags -recurse and -local. The default behavior of the non-namespaced version of this command is to probe recursively, while the default behaviour of the namespaced version is to probe the local memory map only.
The output table minimally shows these columns:
- Start and End are the start and the end of the mapping
- Device is the destination device
Optional columns, which are shown when required, are:
- Offset is the offset in the destination device
- Access is the access type for which the entry is valid
- Fn is the (deprecated) function number for the entry
- Target is the default target of the entry, which is used when device is a translator. This can only occur if -local was used or the command ended prematurely
When the command is used in an expression, a list is returned with entries describing individual mappings. Each entry describing an individual mapping is a list in the form [start, end, device, offset, access].
The list items are:
- start and end are the start and the end of the mapping
- device is the destination device
- offset is the offset in the destination device
- access is the bitmap of the access_t values showing for which access types the entry is valid.
Please note that the list describing an individual mapping may grow in future Simics versions, but the currently defined fields will not change.