gdb: GDB/MI File Commands

 
 27.19 GDB/MI File Commands
 ==========================
 
 This section describes the GDB/MI commands to specify executable file
 names and to read in and obtain symbol table information.
 
 The '-file-exec-and-symbols' Command
 ------------------------------------
 
 Synopsis
 ........
 
       -file-exec-and-symbols FILE
 
    Specify the executable file to be debugged.  This file is the one
 from which the symbol table is also read.  If no file is specified, the
 command clears the executable and symbol information.  If breakpoints
 are set when using this command with no arguments, GDB will produce
 error messages.  Otherwise, no output is produced, except a completion
 notification.
 
 GDB Command
 ...........
 
 The corresponding GDB command is 'file'.
 
 Example
 .......
 
      (gdb)
      -file-exec-and-symbols /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx
      ^done
      (gdb)
 
 The '-file-exec-file' Command
 -----------------------------
 
 Synopsis
 ........
 
       -file-exec-file FILE
 
    Specify the executable file to be debugged.  Unlike
 '-file-exec-and-symbols', the symbol table is _not_ read from this file.
 If used without argument, GDB clears the information about the
 executable file.  No output is produced, except a completion
 notification.
 
 GDB Command
 ...........
 
 The corresponding GDB command is 'exec-file'.
 
 Example
 .......
 
      (gdb)
      -file-exec-file /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx
      ^done
      (gdb)
 
 The '-file-list-exec-source-file' Command
 -----------------------------------------
 
 Synopsis
 ........
 
       -file-list-exec-source-file
 
    List the line number, the current source file, and the absolute path
 to the current source file for the current executable.  The macro
 information field has a value of '1' or '0' depending on whether or not
 the file includes preprocessor macro information.
 
 GDB Command
 ...........
 
 The GDB equivalent is 'info source'
 
 Example
 .......
 
      (gdb)
      123-file-list-exec-source-file
      123^done,line="1",file="foo.c",fullname="/home/bar/foo.c,macro-info="1"
      (gdb)
 
 The '-file-list-exec-source-files' Command
 ------------------------------------------
 
 Synopsis
 ........
 
       -file-list-exec-source-files
 
    List the source files for the current executable.
 
    It will always output both the filename and fullname (absolute file
 name) of a source file.
 
 GDB Command
 ...........
 
 The GDB equivalent is 'info sources'.  'gdbtk' has an analogous command
 'gdb_listfiles'.
 
 Example
 .......
 
      (gdb)
      -file-list-exec-source-files
      ^done,files=[
      {file=foo.c,fullname=/home/foo.c},
      {file=/home/bar.c,fullname=/home/bar.c},
      {file=gdb_could_not_find_fullpath.c}]
      (gdb)
 
 The '-file-list-shared-libraries' Command
 -----------------------------------------
 
 Synopsis
 ........
 
       -file-list-shared-libraries [ REGEXP ]
 
    List the shared libraries in the program.  With a regular expression
 REGEXP, only those libraries whose names match REGEXP are listed.
 
 GDB Command
 ...........
 
 The corresponding GDB command is 'info shared'.  The fields have a
 similar meaning to the '=library-loaded' notification.  The 'ranges'
 field specifies the multiple segments belonging to this library.  Each
 range has the following fields:
 
 'from'
      The address defining the inclusive lower bound of the segment.
 'to'
      The address defining the exclusive upper bound of the segment.
 
 Example
 .......
 
      (gdb)
      -file-list-exec-source-files
      ^done,shared-libraries=[
      {id="/lib/libfoo.so",target-name="/lib/libfoo.so",host-name="/lib/libfoo.so",symbols-loaded="1",thread-group="i1",ranges=[{from="0x72815989",to="0x728162c0"}]},
      {id="/lib/libbar.so",target-name="/lib/libbar.so",host-name="/lib/libbar.so",symbols-loaded="1",thread-group="i1",ranges=[{from="0x76ee48c0",to="0x76ee9160"}]}]
      (gdb)
 
 The '-file-symbol-file' Command
 -------------------------------
 
 Synopsis
 ........
 
       -file-symbol-file FILE
 
    Read symbol table info from the specified FILE argument.  When used
 without arguments, clears GDB's symbol table info.  No output is
 produced, except for a completion notification.
 
 GDB Command
 ...........
 
 The corresponding GDB command is 'symbol-file'.
 
 Example
 .......
 
      (gdb)
      -file-symbol-file /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx
      ^done
      (gdb)