gdb: Progspaces In Guile
23.3.3.13 Program Spaces In Guile
.................................
A program space, or "progspace", represents a symbolic view of an
address space. It consists of all of the objfiles of the program.
DONTPRINTYET Objfiles In Guile. *Noteprogram spaces: Inferiors and
DONTPRINTYET Objfiles In Guile. program spaces Inferiors and
Programs, for more details about program spaces.
Each progspace is represented by an instance of the '<gdb:progspace>'
smob. GDB Scheme Data Types.
The following progspace-related functions are available in the
'(gdb)' module:
-- Scheme Procedure: progspace? object
Return '#t' if OBJECT is a '<gdb:progspace>' object. Otherwise
return '#f'.
-- Scheme Procedure: progspace-valid? progspace
Return '#t' if PROGSPACE is valid, '#f' if not. A
'<gdb:progspace>' object can become invalid if the program it
refers to is not loaded in GDB any longer.
-- Scheme Procedure: current-progspace
This function returns the program space of the currently selected
inferior. There is always a current progspace, this never returns
'#f'. Inferiors and Programs.
-- Scheme Procedure: progspaces
Return a list of all the progspaces currently known to GDB.
-- Scheme Procedure: progspace-filename progspace
Return the absolute file name of PROGSPACE as a string. This is
the name of the file passed as the argument to the 'file' or
'symbol-file' commands. If the program space does not have an
associated file name, then '#f' is returned. This occurs, for
example, when GDB is started without a program to debug.
A 'gdb:invalid-object-error' exception is thrown if PROGSPACE is
invalid.
-- Scheme Procedure: progspace-objfiles progspace
Return the list of objfiles of PROGSPACE. The order of objfiles in
the result is arbitrary. Each element is an object of type
'<gdb:objfile>'. Objfiles In Guile.
A 'gdb:invalid-object-error' exception is thrown if PROGSPACE is
invalid.
-- Scheme Procedure: progspace-pretty-printers progspace
Return the list of pretty-printers of PROGSPACE. Each element is
an object of type '<gdb:pretty-printer>'. Guile Pretty
Printing API, for more information.
-- Scheme Procedure: set-progspace-pretty-printers! progspace
printer-list
Set the list of registered '<gdb:pretty-printer>' objects for
PROGSPACE to PRINTER-LIST. Guile Pretty Printing API, for
more information.