gdb: Objfiles In Guile

 
 23.3.3.14 Objfiles In Guile
 ...........................
 
 GDB loads symbols for an inferior from various symbol-containing files
 (SeeFiles).  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' if OBJECT is a '<gdb:objfile>' object.  Otherwise
      return '#f'.
 
  -- Scheme Procedure: objfile-valid? objfile
      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.
 
  -- 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 for
      OBJFILE.  SeeGuile Pretty Printing API, for more information.
 
  -- Scheme Procedure: set-objfile-pretty-printers! objfile printer-list
      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.  SeeGuile Pretty Printing API,
      for more information.
 
  -- Scheme Procedure: current-objfile
      When auto-loading a Guile script (SeeGuile 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.