Gdb/GDB 002fMI-File-Commands
Next: GDB/MI Target Manipulation, Previous: GDB/MI Symbol Query, Up: GDB/MI [Contents][Index]
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)
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)
Next: GDB/MI Target Manipulation, Previous: GDB/MI Symbol Query, Up: GDB/MI [Contents][Index]