<port_space>.get-string address [max-size] [-list] [term]
Read up to max-size characters (default 256, maximum 1024) from physical memory at address, returning them as a string or list. The term argument controls how the end of the string in memory is determined. If term is "none" then all max-size characters are read and the returned string will contain any null bytes encountered. If it is "null" (default) the command stops reading from memory when it finds a null-terminator while an error is generated if no null-terminator is found within max-size characters. The "optional-null" argument value is similar to "null" but all max-size characters are returned as a string if no null-terminator is found.
The string is returned as a list of bytes if the -list argument is supplied.
The string read from memory must be in ASCII or UTF-8 encoding to be returned as a CLI string otherwise an exception is raised.
The get-string
command performs the access in inquiry mode without triggering any side-effects while read-string
may trigger side-effects.
Simics Core
<port_space>.set-string,
<port_space>.read-string,
<port_space>.get,
<port_space>.read