Gdb/Objfiles-In-Guile
From Get docs
Next: Frames In Guile, Previous: Progspaces In Guile, Up: Guile API [Contents][Index]
23.3.3.14 Objfiles In Guile
GDB loads symbols for an inferior from various symbol-containing files (see Files). These include the primary executable file, any shared libraries used by the inferior, and any separate debug info files (see Separate Debug Files). GDB calls these symbol-containing files objfiles.
Each objfile is represented as an object of type <gdb:objfile>
.
The following objfile-related procedures are provided by the
(gdb)
module:
- Scheme Procedure
- objfile? object
- Return
#t
ifobject
is a<gdb:objfile>
object. Otherwise return#f
.
- Scheme Procedure
- objfile-valid? objfile
- Return
#t
ifobjfile
is valid,#f
if not. A<gdb:objfile>
object can become invalid if the object file it refers to is not loaded in GDB any longer. All other<gdb:objfile>
procedures will throw an exception if it is invalid at the time the procedure is called.
- Scheme Procedure
- objfile-filename objfile
- Return the file name of
objfile
as a string, with symbolic links resolved.
- Scheme Procedure
- objfile-progspace objfile
- Return the
<gdb:progspace>
that this object file lives in. See Progspaces In Guile, for more on progspaces.
- Scheme Procedure
- objfile-pretty-printers objfile
- Return the list of registered
<gdb:pretty-printer>
objects forobjfile
. See Guile Pretty Printing API, for more information.
- Scheme Procedure
- set-objfile-pretty-printers! objfile printer-list
- Set the list of registered
<gdb:pretty-printer>
objects forobjfile
toprinter-list
. Theprinter-list
must be a list of<gdb:pretty-printer>
objects. See Guile Pretty Printing API, for more information.
- Scheme Procedure
- current-objfile
- When auto-loading a Guile script (see Guile Auto-loading), GDB sets the “current objfile” to the corresponding objfile. This function returns the current objfile. If there is no current objfile, this function returns
#f
.
- Scheme Procedure
- objfiles
- Return a list of all the objfiles in the current program space.
Next: Frames In Guile, Previous: Progspaces In Guile, Up: Guile API [Contents][Index]