The node parameter is a node path pattern that identifies the software node to break on. See the Analyzer User's Guide for more information about node path patterns. The node path pattern will be evaluated every time a node becomes active in order to check if the break condition is fulfilled. This means that a node that did not exist when this command was issued might cause the simulation to halt.There is also a performance penalty involved. If only one node is of interest, a node id can be given (as an integer value) instead.
If the -once flag is specified, the breakpoint will be removed automatically when it is triggered.Also, if a node matching the node path is already active and the -immediately flag is specified, no breakpoint will be set.
If the -immediately flag is specified and any processor is active on any of the nodes matching the node path pattern, this command will break directly.
Planted breakpoints can be listed with the breakpoint managers list
command.
The return value is a breakpoint ID; give it to unbreak
to delete the breakpoint.
If given the cpu argument, this command will ignore events on all other processors.