<tcf-context-proxy>.break-line – deprecated <tcf-context-proxy>.info
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<tcf-context-proxy>.break-location – deprecated

Synopsis

<tcf-context-proxy>.break-location ("location"|address) [length] [-error-not-planted] [-r] [-w] [-x] [-p] [-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 argument 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.

With the option -once you can specify the breakpoint to hit only once. After being hit the breakpoint is deleted.

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.

The command returns the id of the new breakpoint. This can be used to manage and delete the breakpoint using the breakpoints object.

Provided By

tcf-agent

See Also

bp.source_location.break, <tcf-context-proxy>.bp-run-until-source-location, <tcf-context-proxy>.bp-wait-for-source-location, show-memorymap, <bp_manager>.list, <bp_manager>.show, <bp_manager>.delete, <bp_manager>.enabled, <bp_manager>.ignore-count, <tcf-context-proxy>.bp-break-source-line
<tcf-context-proxy>.break-line – deprecated <tcf-context-proxy>.info