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:
Return
#t
if object is a<gdb:objfile>
object. Otherwise return#f
.
Return
#t
if objfile 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.
Return the file name of objfile as a string, with symbolic links resolved.
Return the
<gdb:progspace>
that this object file lives in. See Progspaces In Guile, for more on progspaces.
Return the list of registered
<gdb:pretty-printer>
objects for objfile. See Guile Pretty Printing API, for more information.
Set the list of registered
<gdb:pretty-printer>
objects for objfile to printer-list. The printer-list must be a list of<gdb:pretty-printer>
objects. See Guile Pretty Printing API, for more information.
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
.