Postpones execution of a script branch until the graphical breakpoint defined by filename matches.
A graphical breakpoint matches when its image appears on the screen, in the same location as when it was saved. The breakpoint must have been created using the Simics GUI or the command save-break-xy. The screen is checked for matches every interval seconds of virtual time on the clock associated to the console.
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.
The command will by default only wait for events that occur when the simulation is running forward. To wait for events in the reverse direction use the -reverse flag. Similarly, the -always flag tells the command to wait for events in both simulation directions.