Wait for the output of the text string on the console. This command can only be run from a script branch where it suspends the branch until the string has been found in the output.
Example of waiting for a typical shell prompt on console object $con:
bp.console_string.wait-for $con "~ $"
If -regexp is specified, the breakpoint string will be interpreted as a regular expression (regexp). The regexp syntax follows the common Perl style, as interpreted by the Hyperscan library https://hyperscan.io.
Note that the string is a Simics CLI string, and thus \ has to be escaped as \\ when writing the regexp.
Examples:
$con.bp-wait-for-console-string -regexp "\\d{3}"
$con.bp-wait-for-console-string -regexp "\\[.*4.*\\]"
$con.bp-wait-for-console-string -regexp "\\w{3}|[{}]{6}"
For more information about regular expression syntax, see https://perldoc.perl.org/re.html.
If timeout is a positive number, the command will run for at most that many seconds of virtual time.
If timeout-rt is a positive number, the command will run for at most that many seconds of real time.
A time-out will be signaled by throwing a CLI exception, which can be captured using try/except in order to take specific action, or to let it pass unhandled.