bp.notify.trace bp.os_awareness.break
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

bp.notify.wait-for

Synopsis

<bp-manager.notify>.wait-for [object|-global] "name" [timeout] [timeout-rt]

Description

Postpones execution of a script branch until a notifier triggers.

The name parameter specifies the notifier. If -global is specified, then the notifier must be global, otherwise the notifier must be registered on object.

If name is the name of a global notifier, then -global is not needed. If name is the name of a non-global notifier and object is not provided, then the breakpoint is added on all objects that have this notifier registered.

For the global notifiers, see the documentation of the global_notifier_type_t enum about which names should be used.

For the predefined non-global notifiers, see the documentation of the notifier_type_t enum about which names should be used.

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.notify.trace bp.os_awareness.break