<bp-manager.con-string>.run-until

Synopsis

Description

Run the simulation until the text string appear on the console.

Example of waiting for a typical shell prompt on console object $con:

bp.console_string.run-until $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:

• Wait for 3 digits:

  $con.bp-run-until-string -regexp "\\d{3}"
  

• Wait for a '4' somewhere between square brackets (note that in regular expressions, [] have special meanings, so must be escaped):

  $con.bp-run-until-string -regexp "\\[.*4.*\\]"
  

• Wait for a 3 characters or 6 curly braces:

  $con.bp-run-until-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.

Provided By