[RFA/doco] set varsize-limit: New GDB setting for maximum dynamic object size

[Joel Brobecker <brobecker at adacore dot com>]

[Hi Eli, doco and NEWS changes in this patch; could you review them?  Thanks!]

Hello,

This is a command we somehow forgot to contribute at the time the Ada
language was first contributed to the FSF. This command allows
the user to change the maximum size we allow when reading memory
from dynamic objects (the default is 65536 bytes).

At the moment, this limit is only used by Ada, and so the implementation
is kept inside ada-lang.c. However, it is conceivable that other language
might want to use it also to handle the same kind of issues; for instance,
this might be useful when handling dynamic types in C. So the name
of the setting was made language-neutral, to allow for this.

Note that an alias for "set var" needs to be introduced as well.
We are not adding a test for that, since this is a feature that is
already exercized by numerous existing tests.

gdb/ChangeLog

        * NEWS: Add entry describing new "set|show varsize-limit" command.
        * ada-lang.c (_initialize_ada_language): Add "set/show varsize-limit"
        command.
        * printcmd.c (_initialize_printcmd): Add "set var" alias of
        "set variable".

gdb/doc/ChangeLog:

        * gdb.texinfo (Ada Settings): New subsubsection.

gdb/testsuite/ChangeLog:

        * gdb.ada/varsize_limit: New testcase.

Tested on x86_64-linux. OK to commit?

Normally, because this is purely Ada, one might think that I would
self-approve, but since this is adding a new command, not prefixed,
it was fairly clear to me that approval is needed. In terms of
the command name, this is a name which is entrenched in for at least
18 years, so it would be very beneficial for the Ada users if we could
keep that name...

Thank you!
-- 
Joel


---
 gdb/NEWS                                         |  7 +++++
 gdb/ada-lang.c                                   |  7 +++++
 gdb/doc/gdb.texinfo                              | 29 ++++++++++++++++++
 gdb/printcmd.c                                   |  1 +
 gdb/testsuite/gdb.ada/varsize_limit.exp          | 38 ++++++++++++++++++++++++
 gdb/testsuite/gdb.ada/varsize_limit/pck.adb      | 25 ++++++++++++++++
 gdb/testsuite/gdb.ada/varsize_limit/pck.ads      | 20 +++++++++++++
 gdb/testsuite/gdb.ada/varsize_limit/vsizelim.adb | 23 ++++++++++++++
 8 files changed, 150 insertions(+)
 create mode 100644 gdb/testsuite/gdb.ada/varsize_limit.exp
 create mode 100644 gdb/testsuite/gdb.ada/varsize_limit/pck.adb
 create mode 100644 gdb/testsuite/gdb.ada/varsize_limit/pck.ads
 create mode 100644 gdb/testsuite/gdb.ada/varsize_limit/vsizelim.adb

diff --git a/gdb/NEWS b/gdb/NEWS
index 1767cef..0fe06a2 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -6,6 +6,13 @@
 * 'info proc' now works on running processes on FreeBSD systems and core
   files created on FreeBSD systems.
 
+* New commands
+
+set|show varsize-limit
+  This new setting allows the user to control the maximum size of Ada
+  objects being printing when those objects have a dynamic type,
+  instead of that maximum size being hardcoded to 65536 bytes.
+
 *** Changes in GDB 8.1
 
 * GDB now supports dynamically creating arbitrary register groups specified
diff --git a/gdb/ada-lang.c b/gdb/ada-lang.c
index 3de9f14..d0aec80 100644
--- a/gdb/ada-lang.c
+++ b/gdb/ada-lang.c
@@ -14689,6 +14689,13 @@ With an argument, catch only exceptions with the given name."),
 		     CATCH_TEMPORARY);
 
   varsize_limit = 65536;
+  add_setshow_uinteger_cmd ("varsize-limit", class_support,
+			    &varsize_limit, _("\
+Set the maximum number of bytes allowed in a dynamic-sized object."), _("\
+Show the maximum number of bytes allowed in a dynamic-sized object."), _("\
+Attempts to access an object whose size is not a compile-time constant\n\
+and exceeds this limit will cause an error."),
+			    NULL, NULL, &setlist, &showlist);
 
   add_info ("exceptions", info_exceptions_command,
 	    _("\
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index ee7adc8..d7d9c26 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -16268,6 +16268,7 @@ to be difficult.
 * Ada Tasks and Core Files::    Tasking Support when Debugging Core Files
 * Ravenscar Profile::           Tasking Support when using the Ravenscar
                                    Profile
+* Ada Settings::                New settable GDB parameters for Ada.
 * Ada Glitches::                Known peculiarities of Ada mode.
 @end menu
 
@@ -16923,6 +16924,34 @@ using the Ravenscar Profile.
 
 @end table
 
+@node Ada Settings
+@subsubsection Ada Settings
+@cindex Ada settings
+
+@table @code
+@kindex set varsize-limit
+@item set varsize-limit @var{size}
+Limit the size of the types of objects to @var{size} bytes when those
+sizes are computed from run-time quantities.  When this limit is set
+to @code{unlimited}, there is no limit.  By default, it is about 65K.
+
+The purpose of having such a limit is to prevent @value{GDBN} from
+trying to grab enormous chunks of virtual memory when asked to evaluate
+a quantity whose bounds have been corrupted or have not yet been fully
+initialized.  The limit applies to the results of some subexpressions
+as well as to complete expressions.  For example, an expression denoting
+a simple integer component, such as @code{x.y.z}, may fail if the size of
+@var{x.y} is dynamic and exceeds @var{size}.  On the other hand,
+@value{GDBN} is sometimes clever; the expression @code{A(i)}, where
+@var{A} is an array variable with non-constant size, will generally
+succeed regardless of the bounds on @var{A}, as long as the component
+size is less than @var{size}.
+
+@kindex show varsize-limit
+@item show varsize-limit
+Show the limit on types whose size is determined by run-time quantities.
+@end table
+
 @node Ada Glitches
 @subsubsection Known Peculiarities of Ada Mode
 @cindex Ada, problems
diff --git a/gdb/printcmd.c b/gdb/printcmd.c
index fc9d7e4..6d671de 100644
--- a/gdb/printcmd.c
+++ b/gdb/printcmd.c
@@ -2725,6 +2725,7 @@ with $), a register (a few standard names starting with $), or an actual\n\
 variable in the program being debugged.  EXP is any valid expression.\n\
 This may usually be abbreviated to simply \"set\"."),
 	   &setlist);
+  add_alias_cmd ("var", "variable", class_vars, 0, &setlist);
 
   c = add_com ("print", class_vars, print_command, _("\
 Print value of expression EXP.\n\
diff --git a/gdb/testsuite/gdb.ada/varsize_limit.exp b/gdb/testsuite/gdb.ada/varsize_limit.exp
new file mode 100644
index 0000000..b201755
--- /dev/null
+++ b/gdb/testsuite/gdb.ada/varsize_limit.exp
@@ -0,0 +1,38 @@
+# Copyright 2018 Free Software Foundation, Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+load_lib "ada.exp"
+
+standard_ada_testfile vsizelim
+
+if {[gdb_compile_ada "${srcfile}" "${binfile}" executable [list debug ]] != "" } {
+  return -1
+}
+
+clean_restart ${testfile}
+
+set bp_location [gdb_get_line_number "STOP" ${testdir}/vsizelim.adb]
+if ![runto "vsizelim.adb:$bp_location" ] then {
+  perror "Couldn't run ${testfile}"
+  return
+}
+
+gdb_test_no_output "set varsize-limit 16"
+
+gdb_test "print small" " = \"1234567890\""
+
+gdb_test "print larger" "object size is larger than varsize-limit.*"
+
+
diff --git a/gdb/testsuite/gdb.ada/varsize_limit/pck.adb b/gdb/testsuite/gdb.ada/varsize_limit/pck.adb
new file mode 100644
index 0000000..d4acf86
--- /dev/null
+++ b/gdb/testsuite/gdb.ada/varsize_limit/pck.adb
@@ -0,0 +1,25 @@
+--  Copyright 2018 Free Software Foundation, Inc.
+--
+--  This program is free software; you can redistribute it and/or modify
+--  it under the terms of the GNU General Public License as published by
+--  the Free Software Foundation; either version 3 of the License, or
+--  (at your option) any later version.
+--
+--  This program is distributed in the hope that it will be useful,
+--  but WITHOUT ANY WARRANTY; without even the implied warranty of
+--  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+--  GNU General Public License for more details.
+--
+--  You should have received a copy of the GNU General Public License
+--  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+package body Pck is
+   procedure Do_Nothing (A : System.Address) is
+   begin
+      null;
+   end Do_Nothing;
+   function Ident (S : String) return String is
+   begin
+      return S;
+   end Ident;
+end Pck;
diff --git a/gdb/testsuite/gdb.ada/varsize_limit/pck.ads b/gdb/testsuite/gdb.ada/varsize_limit/pck.ads
new file mode 100644
index 0000000..b0043fa
--- /dev/null
+++ b/gdb/testsuite/gdb.ada/varsize_limit/pck.ads
@@ -0,0 +1,20 @@
+--  Copyright 2018 Free Software Foundation, Inc.
+--
+--  This program is free software; you can redistribute it and/or modify
+--  it under the terms of the GNU General Public License as published by
+--  the Free Software Foundation; either version 3 of the License, or
+--  (at your option) any later version.
+--
+--  This program is distributed in the hope that it will be useful,
+--  but WITHOUT ANY WARRANTY; without even the implied warranty of
+--  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+--  GNU General Public License for more details.
+--
+--  You should have received a copy of the GNU General Public License
+--  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+with System;
+package Pck is
+   procedure Do_Nothing (A : System.Address);
+   function Ident (S : String) return String;
+end Pck;
diff --git a/gdb/testsuite/gdb.ada/varsize_limit/vsizelim.adb b/gdb/testsuite/gdb.ada/varsize_limit/vsizelim.adb
new file mode 100644
index 0000000..e65ebfd
--- /dev/null
+++ b/gdb/testsuite/gdb.ada/varsize_limit/vsizelim.adb
@@ -0,0 +1,23 @@
+--  Copyright 2018 Free Software Foundation, Inc.
+--
+--  This program is free software; you can redistribute it and/or modify
+--  it under the terms of the GNU General Public License as published by
+--  the Free Software Foundation; either version 3 of the License, or
+--  (at your option) any later version.
+--
+--  This program is distributed in the hope that it will be useful,
+--  but WITHOUT ANY WARRANTY; without even the implied warranty of
+--  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+--  GNU General Public License for more details.
+--
+--  You should have received a copy of the GNU General Public License
+--  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+with Pck; use Pck;
+procedure VsizeLim is
+   Small : String := Ident ("1234567890");
+   Larger : String := Ident ("1234567890|1234567890|1234567890");
+begin
+   Do_Nothing (Small'Address); -- STOP
+   Do_Nothing (Larger'Address);
+end VsizeLim;
-- 
2.1.4