<tcf-context-proxy>.bp-break-source-line <tcf-context-proxy>.bp-run-until-source-line
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<tcf-context-proxy>.bp-break-source-location

Synopsis

<tcf-context-proxy>.bp-break-source-location ("location"|address) [length] [-error-not-planted] [-r] [-w] [-x] [-p] ["context-query"] [-once]

Description

Add a breakpoint on a particular location. The location is either location, which should specify a C expression or address. In addition you can specify the length of the breakpoint, i.e. how many consecutive memory addresses it should match with length.

The break condition will evaluate to true if any of the selected access methods operates on the address of the location 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 location 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.

Provided By

bp-manager
<tcf-context-proxy>.bp-break-source-line <tcf-context-proxy>.bp-run-until-source-line