Alternatively the file name, line number and column number can be specified using the filename, line-number, and optional column arguments. This will allow the filename to contain the colon character, something the line argument cannot handle.
The script branch will wait until any of the selected access methods operates on the address of the line in the target memory object. The default access method is execution and the default target memory object is the virtual memory space of the processor associated with the debug context.
To use other access methods, use any combination -r for read, -w for write and -x for execute.
To change the target memory object from the virtual memory object to the physical memory object of the processor for the debug context, set the -p argument flag.
If line could not be resolved to an address among the added symbol files, it is possible to make the command fail by specifying -error-not-planted.
You can limit the debug contexts the breakpoint applies to by providing a context query with context-query. It defaults to *, which matches all debug contexts. 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.