From: Joel Brobecker Date: Fri, 8 Nov 2013 10:21:14 +0000 (+0400) Subject: Document "info exceptions" and "-info-ada-exception" new commands. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=58d065288c2f5910fdf09afa3d2a86825964c8d0;p=binutils-gdb.git Document "info exceptions" and "-info-ada-exception" new commands. gdb/doc/ChangeLog: * gdb.texinfo (Ada): Add entry in menu for new "Ada Exceptions" node. (Ada Exceptions): New node. (GDB/MI): Add entry in menu for new "GDB/MI Ada Exceptions Commands" node. (GDB/MI Ada Exceptions Commands): New node. (GDB/MI Miscellaneous Commands): Document new "info-ada-exceptions" field in the output of the "-list-features" command. * NEWS: Add entry for the new "info exceptions" CLI command, and for the new "-info-ada-exceptions" GDB/MI command. --- diff --git a/gdb/NEWS b/gdb/NEWS index f36ee657e73..38209e84166 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -82,6 +82,12 @@ remove-symbol-file -a ADDRESS can be identified by its filename or by an address that lies within the boundaries of this symbol file in memory. +info exceptions +info exceptions REGEXP + Display the list of Ada exceptions defined in the program being + debugged. If provided, only the exceptions whose names match REGEXP + are listed. + * New options set debug symfile off|on @@ -169,6 +175,9 @@ show startup-with-shell ** The new commands -catch-assert and -catch-exceptions insert catchpoints stopping the program when Ada exceptions are raised. + ** The new command -info-ada-exceptions provides the equivalent of + the new "info exceptions" command. + * New system-wide configuration scripts A GDB installation now provides scripts suitable for use as system-wide configuration scripts for the following systems: diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 3089685c683..49ac7947c81 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,15 @@ +2013-11-12 Joel Brobecker + + * gdb.texinfo (Ada): Add entry in menu for new "Ada Exceptions" node. + (Ada Exceptions): New node. + (GDB/MI): Add entry in menu for new "GDB/MI Ada Exceptions + Commands" node. + (GDB/MI Ada Exceptions Commands): New node. + (GDB/MI Miscellaneous Commands): Document new "info-ada-exceptions" + field in the output of the "-list-features" command. + * NEWS: Add entry for the new "info exceptions" CLI command, + and for the new "-info-ada-exceptions" GDB/MI command. + 2013-11-11 Phil Muldoon * gdb.texinfo (Symbol Tables In Python): Add linetable method entry. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index c6974d79ef8..dc79ca1fd92 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -14965,6 +14965,7 @@ to be difficult. * Omissions from Ada:: Restrictions on the Ada expression syntax. * Additions to Ada:: Extensions of the Ada expression syntax. * Stopping Before Main Program:: Debugging the program during elaboration. +* Ada Exceptions:: Ada Exceptions * Ada Tasks:: Listing and setting breakpoints in tasks. * Ada Tasks and Core Files:: Tasking Support when Debugging Core Files * Ravenscar Profile:: Tasking Support when using the Ravenscar @@ -15289,6 +15290,42 @@ Manual, the elaboration code is invoked from a procedure called elaboration, simply use the following two commands: @code{tbreak adainit} and @code{run}. +@node Ada Exceptions +@subsubsection Ada Exceptions + +A command is provided to list all Ada exceptions: + +@table @code +@kindex info exceptions +@item info exceptions +@itemx info exceptions @var{regexp} +The @code{info exceptions} command allows you to list all Ada exceptions +defined within the program being debugged, as well as their addresses. +With a regular expression, @var{regexp}, as argument, only those exceptions +whose names match @var{regexp} are listed. +@end table + +Below is a small example, showing how the command can be used, first +without argument, and next with a regular expression passed as an +argument. + +@smallexample +(@value{GDBP}) info exceptions +All defined Ada exceptions: +constraint_error: 0x613da0 +program_error: 0x613d20 +storage_error: 0x613ce0 +tasking_error: 0x613ca0 +const.aint_global_e: 0x613b00 +(@value{GDBP}) info exceptions const.aint +All Ada exceptions matching regular expression "const.aint": +constraint_error: 0x613da0 +const.aint_global_e: 0x613b00 +@end smallexample + +It is also possible to ask @value{GDBN} to stop your program's execution +when an exception is raised. For more details, see @ref{Set Catchpoints}. + @node Ada Tasks @subsubsection Extensions for Ada Tasks @cindex Ada, tasking @@ -28713,6 +28750,7 @@ may repeat one or more times. @end ignore * GDB/MI Target Manipulation:: * GDB/MI File Transfer Commands:: +* GDB/MI Ada Exceptions Commands:: * GDB/MI Miscellaneous Commands:: @end menu @@ -34802,6 +34840,59 @@ The corresponding @value{GDBN} command is @samp{remote delete}. @end smallexample +@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +@node GDB/MI Ada Exceptions Commands +@section Ada Exceptions @sc{gdb/mi} Commands + +@subheading The @code{-info-ada-exceptions} Command +@findex -info-ada-exceptions + +@subsubheading Synopsis + +@smallexample + -info-ada-exceptions [ @var{regexp}] +@end smallexample + +List all Ada exceptions defined within the program being debugged. +With a regular expression @var{regexp}, only those exceptions whose +names match @var{regexp} are listed. + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{info exceptions}. + +@subsubheading Result + +The result is a table of Ada exceptions. The following columns are +defined for each exception: + +@table @samp +@item name +The name of the exception. + +@item address +The address of the exception. + +@end table + +@subsubheading Example + +@smallexample +-info-ada-exceptions aint +^done,ada-exceptions=@{nr_rows="2",nr_cols="2", +hdr=[@{width="1",alignment="-1",col_name="name",colhdr="Name"@}, +@{width="1",alignment="-1",col_name="address",colhdr="Address"@}], +body=[@{name="constraint_error",address="0x0000000000613da0"@}, +@{name="const.aint_global_e",address="0x0000000000613b00"@}]@} +@end smallexample + +@subheading Catching Ada Exceptions + +The commands describing how to ask @value{GDBN} to stop when a program +raises an exception are described at @ref{Ada Exception GDB/MI +Catchpoint Commands}. + + @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @node GDB/MI Miscellaneous Commands @section Miscellaneous @sc{gdb/mi} Commands @@ -34988,7 +35079,9 @@ Indicates support for the @code{-data-read-memory-bytes} and the Indicates that changes to breakpoints and breakpoints created via the CLI will be announced via async records. @item ada-task-info -Indicates support for the @code{-ada-task-info} command. +indicates support for the @code{-ada-task-info} command. +@item info-ada-exceptions +indicates support for the @code{-info-ada-exceptions} command. @end table @subheading The @code{-list-target-features} Command