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.
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.