diff options
author | Marc-Andre Laperle <marc-andre.laperle@ericsson.com> | 2017-03-20 14:57:51 -0400 |
---|---|---|
committer | Marc-Andre Laperle <marc-andre.laperle@ericsson.com> | 2017-03-20 14:57:51 -0400 |
commit | 51457a05780da82b5321a1574caed95ac0e6923e (patch) | |
tree | 99ed97a890a2c02782516153d7c2a82f9718bc04 /gdb/doc | |
parent | 5b291c049658614196197e4ea4bb42bcc176b876 (diff) | |
download | gdb-51457a05780da82b5321a1574caed95ac0e6923e.zip gdb-51457a05780da82b5321a1574caed95ac0e6923e.tar.gz gdb-51457a05780da82b5321a1574caed95ac0e6923e.tar.bz2 |
Add -file-list-shared-libraries MI command
This change adds the MI equivalent for the "info sharedlibrary"
command. The command was already partially documented but ignored as
it was not implemented. The new MI command works similarly to the CLI
command, taking an optional regular expression as an argument and
outputting the library information.
I included a test for the new command in mi-solib.exp.
gdb/doc/ChangeLog:
* gdb.texinfo (gdb/mi Symbol Query Commands): Document new MI
command file-list-shared-libraries
(GDB/MI Async Records): Update documentation of library-loaded with new
field.
gdb/ChangeLog:
* NEWS: Add an entry about new '-file-list-shared-libraries' command.
* mi/mi-cmd-file.c (mi_cmd_file_list_shared_libraries):
New function definition.
* mi/mi-cmds.c (mi_cmds): Add -file-list-shared-libraries command.
* mi/mi-cmds.h (mi_cmd_file_list_shared_libraries):
New function declaration.
* mi/mi-interp.c (mi_output_solib_attribs): New Function.
* mi/mi-interp.h: New file.
* solib.c (info_sharedlibrary_command): Replace for loop with
ALL_SO_LIBS macro
* solib.h (update_solib_list): New function declaration.
(so_list_head): Move macro.
* solist.h (ALL_SO_LIBS): New macro.
gdb/testsuite/ChangeLog:
* gdb.mi/mi-solib.exp (test_file_list_shared_libraries):
New procedure.
Signed-off-by: Marc-Andre Laperle <marc-andre.laperle@ericsson.com>
Diffstat (limited to 'gdb/doc')
-rw-r--r-- | gdb/doc/ChangeLog | 7 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 34 |
2 files changed, 34 insertions, 7 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 8b8820e..1657ab8 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,10 @@ +2017-03-20 Marc-Andre Laperle <marc-andre.laperle@ericsson.com> + + * gdb.texinfo (gdb/mi Symbol Query Commands): Document new MI + command file-list-shared-libraries + (GDB/MI Async Records): Update documentation of library-loaded with new + field. + 2017-03-16 Doug Evans <dje@google.com> * guile.texi (Lazy Strings In Guile): Mention arrays. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 5cf0f97..c1dfdeb 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -26603,8 +26603,8 @@ that thread. @item =library-loaded,... Reports that a new library file was loaded by the program. This -notification has 4 fields---@var{id}, @var{target-name}, -@var{host-name}, and @var{symbols-loaded}. The @var{id} field is an +notification has 5 fields---@var{id}, @var{target-name}, +@var{host-name}, @var{symbols-loaded} and @var{ranges}. The @var{id} field is an opaque identifier of the library. For remote debugging case, @var{target-name} and @var{host-name} fields give the name of the library file on the target, and on the host respectively. For native @@ -26614,7 +26614,8 @@ and should not be relied on to convey any useful information. The @var{thread-group} field, if present, specifies the id of the thread group in whose context the library was loaded. If the field is absent, it means the library was loaded in the context of all present -thread groups. +thread groups. The @var{ranges} field specifies the ranges of addresses belonging +to this library. @item =library-unloaded,... Reports that a library was unloaded by the program. This notification @@ -31535,26 +31536,45 @@ The @value{GDBN} equivalent is @samp{info sources}. (gdb) @end smallexample -@ignore @subheading The @code{-file-list-shared-libraries} Command @findex -file-list-shared-libraries @subsubheading Synopsis @smallexample - -file-list-shared-libraries + -file-list-shared-libraries [ @var{regexp} ] @end smallexample List the shared libraries in the program. +With a regular expression @var{regexp}, only those libraries whose +names match @var{regexp} are listed. @subsubheading @value{GDBN} Command -The corresponding @value{GDBN} command is @samp{info shared}. +The corresponding @value{GDBN} command is @samp{info shared}. The fields +have a similar meaning to the @code{=library-loaded} notification. +The @code{ranges} field specifies the multiple segments belonging to this +library. Each range has the following fields: + +@table @samp +@item from +The address defining the inclusive lower bound of the segment. +@item to +The address defining the exclusive upper bound of the segment. +@end table @subsubheading Example -N.A. +@smallexample +(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) +@end smallexample +@ignore @subheading The @code{-file-list-symbol-files} Command @findex -file-list-symbol-files |