The nodes that are evaluated are specified in either in the node-pattern or in the node-id. The node-pattern parameter should contain string with a node path pattern. Node path patterns are described in the Analyzer User's Guide. The node-id parameter should contain a node-id.
If -immediately is specified, and the node condition is true when the command is issued, the command take action immediately, otherwise, the next time the node condition evaluates to true.
If a cpu is specified, this command will ignore events on all other processors. 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.