If the number parameter is specified, only magic instructions with that argument value are considered. The possible argument values depends on the processor type. To consider all magic instructions, the -all flag can be used. The default is to consider magic instructions with argument 0.
If no processor object is specified, magic instructions from all processors are considered.
See further about magic breakpoints in Simics User's Guide.
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.
If object is provided, then the breakpoint functionality is added on that object.