Symbol Tables In Guile (Debugging with GDB)
From Get docs
Gdb/docs/latest/gdb/Symbol-Tables-In-Guile
Next: Breakpoints In Guile, Previous: Symbols In Guile, Up: Guile API [Contents][Index]
23.4.3.18 Symbol table representation in Guile.
Access to symbol table data maintained by GDB on the inferior is exposed to Guile via two objects: <gdb:sal>
(symtab-and-line) and <gdb:symtab>
. Symbol table and line data for a frame is returned from the frame-find-sal
<gdb:frame>
procedure. See Frames In Guile.
For more information on GDB’s symbol table management, see Examining the Symbol Table.
The following symtab-related procedures are provided by the (gdb)
module:
- Scheme Procedure
- symtab? object
- Return
#t
ifobject
is an object of type<gdb:symtab>
. Otherwise return#f
.
- Scheme Procedure
- symtab-valid? symtab
- Return
#t
if the<gdb:symtab>
object is valid,#f
if not. A<gdb:symtab>
object becomes invalid when the symbol table it refers to no longer exists in GDB. All other<gdb:symtab>
procedures will throw an exception if it is invalid at the time the procedure is called.
- Scheme Procedure
- symtab-filename symtab
- Return the symbol table’s source filename.
- Scheme Procedure
- symtab-fullname symtab
- Return the symbol table’s source absolute file name.
- Scheme Procedure
- symtab-objfile symtab
- Return the symbol table’s backing object file. See Objfiles In Guile.
- Scheme Procedure
- symtab-global-block symtab
- Return the global block of the underlying symbol table. See Blocks In Guile.
- Scheme Procedure
- symtab-static-block symtab
- Return the static block of the underlying symbol table. See Blocks In Guile.
The following symtab-and-line-related procedures are provided by the (gdb)
module:
- Scheme Procedure
- sal? object
- Return
#t
ifobject
is an object of type<gdb:sal>
. Otherwise return#f
.
- Scheme Procedure
- sal-valid? sal
- Return
#t
ifsal
is valid,#f
if not. A<gdb:sal>
object becomes invalid when the Symbol table object it refers to no longer exists in GDB. All other<gdb:sal>
procedures will throw an exception if it is invalid at the time the procedure is called.
- Scheme Procedure
- sal-symtab sal
- Return the symbol table object (
<gdb:symtab>
) forsal
.
- Scheme Procedure
- sal-line sal
- Return the line number for
sal
.
- Scheme Procedure
- sal-pc sal
- Return the start of the address range occupied by code for
sal
.
- Scheme Procedure
- sal-last sal
- Return the end of the address range occupied by code for
sal
.
- Scheme Procedure
- find-pc-line pc
- Return the
<gdb:sal>
object corresponding to thepc
value. If an invalid value ofpc
is passed as an argument, then thesymtab
andline
attributes of the returned<gdb:sal>
object will be#f
and 0 respectively.
Next: Breakpoints In Guile, Previous: Symbols In Guile, Up: Guile API [Contents][Index]