In an image object, one or more files represent the image data. This is done in a transparent way: page ranges not present in one file is searched in subsequent files.
Image files can be in raw format, or in compressed CRAFF format. Use the craff utility to convert between image file formats.
Read/write access to single bytes. The attribute is indexed by an integer specifying offset, or by a slice (pair of integers) specifying range.
Storage page checksum.
If set to non-zero, saved diffs and checkpoints will use compressed craff files.
Whether there are unsaved changes not backed by any writable file
((file, read-only, start, size[, offset])+) Specifies the files that represent the (initial) image contents. Several files may be specified and may also overlap in memory. Later files override earlier files. file is the file name of a file in CRAFF or raw format or a raw disk device. read-only is "rw" or "ro" and specifies whether changes to an image should be written back to the file or cached in memory. start is the first address in the image represented by the file. size is the number of bytes the file represents. If zero, the size is taken from the file. offset is the offset in the file where this mapping starts.
In checkpoint files generated by Simics, file may contain a path of the form %n%. Such a sequence will be replaced by the nth element of the checkpoint_path attribute in the sim object, counting from zero. By using %n% as path, all absolute paths are kept in the checkpoint_path attribute, making it easier to update a checkpoint when files that it depends on have moved.
Object implementing the image_snoop. Intended for internal usage only; may change without notice.
Set if the memory should be preallocated, resident and contiguous.
If set, directory where to put a mappable file. Setting this causes this directory to be used to allocate mappable storage.
Maximum number of bytes cached by all images in the system before pages are swapped to disk. This is used to reduce memory consumption. Setting this limit too high or too low will adversely affect system performance. If set to 0, the limit is disabled.
Object implementing the image_snoop. Used internally for reverse execution; do not use.
size in bytes the image represents
|add-diff-file||add a diff file to the image|
|add-partial-diff-file||add a partial diff file to the image|
|save||save image to disk|
|save-diff-file||save changes since last checkpoint|
|set||set bytes in image to specified value|
|x||examine image data|
If value is larger than the specified size, behavior is undefined.
The -l and -b flags are used to select little-endian and big-endian byte order, respectively. If neither is given, the byte order of the currently selected processor is used.