<bp-manager.con-string>.break

Synopsis

<bp-manager.con-string>.break object "string" [-regexp] [-once]

Description

This command uses breakpoint functionality on object, with the following description:

Set Simics to break simulation when string is seen on the console.

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

bp.console_string.break $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-break-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-break-string -regexp "\\[.*4.*\\]"
```

Wait for a 3 characters or 6 curly braces:

$con.bp-break-string -regexp "\\w{3}|[{}]{6}"

For more information about regular expression syntax, see https://perldoc.perl.org/re.html.

The -once flag causes the breakpoint to automatically be removed after it has triggered.

Provided By

bp-manager