<bp-manager.log>.break <bp-manager.log>.trace
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<bp-manager.log>.run-until

Synopsis

<bp-manager.log>.run-until [object] [-regexp] [-re] ["substr"] ["substring"] [type] [-recursive] [timeout] [timeout-rt]

Description

Run the simulation until a specified log message is emitted. The type, and substr arguments can be used to run until log messages matching certain conditions are emitted. The object argument of the command can be used to only consider log messages on a certain object. The substr argument is a string to look for. It is interpreted as a regular expression, as defined by the re module in Python, if the -regexp flag is specified.

When used in an expression, the commands returns a list with the following information: [<clock-object>, <seconds>, <cycles>, <log-level>, <log-type>, <log-group>, <object>, <message>]. The first three entries form a time stamp for when the log entry was generated.

Note that the log level must be set high enough for the message to be generated or it will not be found. If -recursive is used, not only the object, but the objects hierarchically below the object will be considered when adding the breakpoint. 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

bp-manager
<bp-manager.log>.break <bp-manager.log>.trace