save-intel-obj save-preferences
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

save-persistent-state

Synopsis

save-persistent-state file [-z|-u] [-save-raw|-save-craff] [-independent-state] ["comment"]

Description

Save the persistent simulator state to file. Persistent data typically includes disk images, NVRAM and flash memory contents and clock settings, i.e. data that survive reboots. The persistent state is saved as a standard Simics configuration.

Unless the -independent-state flag is specified, the state is saved incrementally. This allows to save time and disk space but, as result, the saved state usually depends on the files which were saved earlier as well as on the files (e.g., disk images) which were used when simulation objects were created. This means that care should be taken when deleting files created previously.

Use the -independent-state flag for saving the complete image data independent of states which were saved earlier, instead of just the modified data (which is the default).

To add a description to the saved state, use the comment argument. The comment is saved in the info file in the persistent state bundle.

More information about saving persistent state can be found in the Configuration and Checkpointing chapter of the Simics User's Guide manual.

The command flags described below allow to control some subtle aspects related to the format used for the saved state and are rarely needed.

The -save-raw flag tells Simics to store images in raw format. The -save-craff flag (default) tells Simics to store images in the craff format.

The -u flag tells Simics to store images in the uncompressed craff format.

Provided By

Simics Core

See Also

load-persistent-state, write-configuration
save-intel-obj save-preferences