Red Hat ENTERPRISE LINUX 4 - DEVELOPER TOOLS GUIDE, Manual

Page: 290 / 410

280 Chapter 27. gdb Annotations
Between these annotations is the main body of the frame, which can consist of
•
^Z^Zfunction-call
function-call-string
where
function-call-string
is text designed to convey to the user that this frame is associated
with a function call made by gdb to a function in the program being debugged.
•
^Z^Zsignal-handler-caller
signal-handler-caller-string
where
signal-handler-caller-string
is text designed to convey to the user that this frame
is associated with whatever mechanism is used by this operating system to call a signal handler (it
is the frame which calls the signal handler, not the frame for the signal handler itself).
•
A normal frame.
This can optionally (depending on whether this is thought of as interesting information for the user
to see) begin with
^Z^Zframe-address
address
^Z^Zframe-address-end
separator-string
where
address
is the address executing in the frame (the same address as in the
frame-begin
annotation, but printed in a form which is intended for user consumption--in particular, the syntax
varies depending on the language), and
separator-string
is a string intended to separate this
address from what follows for the user’s benefit.
Then comes
^Z^Zframe-function-name
function-name
^Z^Zframe-args
arguments
where
function-name
is the name of the function executing in the frame, or
??
if not known,
and
arguments
are the arguments to the frame, with parentheses around them (each argument is
annotated individually as well, (refer to Section 27.3 Values ).
If source information is available, a reference to it is then printed:
^Z^Zframe-source-begin
source-intro-string
^Z^Zframe-source-file
filename
^Z^Zframe-source-file-end
:
^Z^Zframe-source-line
line-number
^Z^Zframe-source-end
where
source-intro-string
separates for the user’s benefit the reference from the text which
precedes it,
filename
is the name of the source file, and
line-number
is the line number within
that file (the first line is line 1).
If gdb prints some information about where the frame is from (which library, which load segment,
etc.; currently only done on the RS/6000), it is annotated with
^Z^Zframe-where
information