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 break condition will evaluate to true if 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.
The command returns the id of the new breakpoint. This can be used to manage and delete the breakpoint using the bp object. The -once flag causes the breakpoint to automatically be removed after it has triggered.
If object is provided, then the breakpoint functionality is added on that object.