Next: GDB/MI Frame Information, Previous: GDB/MI Async Records, Up: GDB/MI Output Records [Contents][Index]
When GDB reports information about a breakpoint, a tracepoint, a watchpoint, or a catchpoint, it uses a tuple with the following fields:
numberThe breakpoint number. For a breakpoint that represents one location of a multi-location breakpoint, this will be a dotted pair, like ‘1.2’.
typeThe type of the breakpoint. For ordinary breakpoints this will be ‘breakpoint’, but many values are possible.
catch-typeIf the type of the breakpoint is ‘catchpoint’, then this indicates the exact type of catchpoint.
dispThis is the breakpoint disposition—either ‘del’, meaning that the breakpoint will be deleted at the next stop, or ‘keep’, meaning that the breakpoint will not be deleted.
enabledThis indicates whether the breakpoint is enabled, in which case the
value is ‘y’, or disabled, in which case the value is ‘n’.
Note that this is not the same as the field enable.
addrThe address of the breakpoint. This may be a hexidecimal number, giving the address; or the string ‘<PENDING>’, for a pending breakpoint; or the string ‘<MULTIPLE>’, for a breakpoint with multiple locations. This field will not be present if no address can be determined. For example, a watchpoint does not have an address.
funcIf known, the function in which the breakpoint appears. If not known, this field is not present.
filenameThe name of the source file which contains this function, if known. If not known, this field is not present.
fullnameThe full file name of the source file which contains this function, if known. If not known, this field is not present.
lineThe line number at which this breakpoint appears, if known. If not known, this field is not present.
atIf the source file is not known, this field may be provided. If provided, this holds the address of the breakpoint, possibly followed by a symbol name.
pendingIf this breakpoint is pending, this field is present and holds the text used to set the breakpoint, as entered by the user.
evaluated-byWhere this breakpoint’s condition is evaluated, either ‘host’ or ‘target’.
threadIf this is a thread-specific breakpoint, then this identifies the thread in which the breakpoint can trigger.
taskIf this breakpoint is restricted to a particular Ada task, then this field will hold the task identifier.
condIf the breakpoint is conditional, this is the condition expression.
ignoreThe ignore count of the breakpoint.
enableThe enable count of the breakpoint.
traceframe-usageFIXME.
static-tracepoint-marker-string-idFor a static tracepoint, the name of the static tracepoint marker.
maskFor a masked watchpoint, this is the mask.
passA tracepoint’s pass count.
original-locationThe location of the breakpoint as originally specified by the user. This field is optional.
timesThe number of times the breakpoint has been hit.
installedThis field is only given for tracepoints. This is either ‘y’, meaning that the tracepoint is installed, or ‘n’, meaning that it is not.
whatSome extra data, the exact contents of which are type-dependent.
For example, here is what the output of -break-insert
(see GDB/MI Breakpoint Commands) might be:
-> -break-insert main
<- ^done,bkpt={number="1",type="breakpoint",disp="keep",
enabled="y",addr="0x08048564",func="main",file="myprog.c",
fullname="/home/nickrob/myprog.c",line="68",thread-groups=["i1"],
times="0"}
<- (gdb)
Next: GDB/MI Frame Information, Previous: GDB/MI Async Records, Up: GDB/MI Output Records [Contents][Index]