gdb: Improve output from "info types" commad
authorAndrew Burgess <andrew.burgess@embecosm.com>
Tue, 9 Jul 2019 17:05:59 +0000 (18:05 +0100)
committerAndrew Burgess <andrew.burgess@embecosm.com>
Mon, 22 Jul 2019 09:43:02 +0000 (10:43 +0100)
This commit makes two changes to the "info types" command:

First, only use typedef_print for printing typedefs, and use
type_print for printing non-typedef scalar (non-struct) types.  The
result of this is the output for builtin types goes from this:

    typedef double;
    typedef float;
    typedef int;

to this:

    double;
    float;
    int;

which seems to make more sense.

Next GDB no longer matches msymbols as possible type names.  When
looking for function symbols it makes sense to report matching
msymbols from the text sections, and for variables msymbols from the
data/bss sections, but when reporting types GDB would match msymbols
of type absolute.  But I don't see why these are likely to indicate
type names.  As such I've updated the msymbol matching lists in
symtab.c:search_symbols so that when searching in the TYPES_DOMAIN, we
never match any msymbols.

gdb/ChangeLog:

* symtab.c (search_symbols): Adjust msymbol matching type arrays
so that GDB doesn't match any msymbols when searching in the
TYPES_DOMAIN.
(print_symbol_info): Print using typedef_print or type_print based
on the type of the symbol.  Add updated FIXME comment moved from...
(_initialize_symtab): ... move and update FIXME comment to above.

gdb/testsuite/ChangeLog:

* gdb.base/info-types.c: New file.
* gdb.base/info-types.exp: New file.

gdb/ChangeLog
gdb/symtab.c
gdb/testsuite/ChangeLog
gdb/testsuite/gdb.base/info-types.c [new file with mode: 0644]
gdb/testsuite/gdb.base/info-types.exp [new file with mode: 0644]

index 18987b0de405c04af3fa5b79b3f7d0ceb4dbb8a3..f4e067bb7b4cc79953023e855786f7491cd1475d 100644 (file)
@@ -1,3 +1,12 @@
+2019-07-22  Andrew Burgess  <andrew.burgess@embecosm.com>
+
+       * symtab.c (search_symbols): Adjust msymbol matching type arrays
+       so that GDB doesn't match any msymbols when searching in the
+       TYPES_DOMAIN.
+       (print_symbol_info): Print using typedef_print or type_print based
+       on the type of the symbol.  Add updated FIXME comment moved from...
+       (_initialize_symtab): ... move and update FIXME comment to above.
+
 2019-07-22  Andrew Burgess  <andrew.burgess@embecosm.com>
 
        * NEWS: Mention adding -q option to "info types".
index ea2b813f293ad5851f0d862477b213861456f4c9..5b8bfc1df7e44bcc8d04900748dec6466beabce1 100644 (file)
@@ -4343,13 +4343,13 @@ search_symbols (const char *regexp, enum search_domain kind,
   struct symbol *sym;
   int found_misc = 0;
   static const enum minimal_symbol_type types[]
-    = {mst_data, mst_text, mst_abs};
+    = {mst_data, mst_text, mst_unknown};
   static const enum minimal_symbol_type types2[]
-    = {mst_bss, mst_file_text, mst_abs};
+    = {mst_bss, mst_file_text, mst_unknown};
   static const enum minimal_symbol_type types3[]
-    = {mst_file_data, mst_solib_trampoline, mst_abs};
+    = {mst_file_data, mst_solib_trampoline, mst_unknown};
   static const enum minimal_symbol_type types4[]
-    = {mst_file_bss, mst_text_gnu_ifunc, mst_abs};
+    = {mst_file_bss, mst_text_gnu_ifunc, mst_unknown};
   enum minimal_symbol_type ourtype;
   enum minimal_symbol_type ourtype2;
   enum minimal_symbol_type ourtype3;
@@ -4632,7 +4632,23 @@ print_symbol_info (enum search_domain kind,
   /* Typedef that is not a C++ class.  */
   if (kind == TYPES_DOMAIN
       && SYMBOL_DOMAIN (sym) != STRUCT_DOMAIN)
-    typedef_print (SYMBOL_TYPE (sym), sym, gdb_stdout);
+    {
+      /* FIXME: For C (and C++) we end up with a difference in output here
+        between how a typedef is printed, and non-typedefs are printed.
+        The TYPEDEF_PRINT code places a ";" at the end in an attempt to
+        appear C-like, while TYPE_PRINT doesn't.
+
+        For the struct printing case below, things are worse, we force
+        printing of the ";" in this function, which is going to be wrong
+        for languages that don't require a ";" between statements.  */
+      if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_TYPEDEF)
+       typedef_print (SYMBOL_TYPE (sym), sym, gdb_stdout);
+      else
+       {
+         type_print (SYMBOL_TYPE (sym), "", gdb_stdout, -1);
+         printf_filtered ("\n");
+       }
+    }
   /* variable, func, or typedef-that-is-c++-class.  */
   else if (kind < TYPES_DOMAIN
           || (kind == TYPES_DOMAIN
@@ -6084,14 +6100,6 @@ Prints the functions.\n"),
                                  _("functions")));
   set_cmd_completer_handle_brkchars (c, info_print_command_completer);
 
-  /* FIXME:  This command has at least the following problems:
-     1.  It prints builtin types (in a very strange and confusing fashion).
-     2.  It doesn't print right, e.g. with
-     typedef struct foo *FOO
-     type_print prints "FOO" when we want to make it (in this situation)
-     print "struct foo *".
-     I also think "ptype" or "whatis" is more likely to be useful (but if
-     there is much disagreement "info types" can be fixed).  */
   c = add_info ("types", info_types_command, _("\
 All type names, or those matching REGEXP.\n\
 Usage: info types [-q] [REGEXP]\n\
index 53134701507f71e43c72bef9172414555af3a423..864da179d9e86ef55f06fcbfda9c0af4d5261a4d 100644 (file)
@@ -1,3 +1,8 @@
+2019-07-22  Andrew Burgess  <andrew.burgess@embecosm.com>
+
+       * gdb.base/info-types.c: New file.
+       * gdb.base/info-types.exp: New file.
+
 2019-07-19  Andrew Burgess  <andrew.burgess@embecosm.com>
 
        * gdb.arch/riscv-bp-infcall.c: New file.
diff --git a/gdb/testsuite/gdb.base/info-types.c b/gdb/testsuite/gdb.base/info-types.c
new file mode 100644 (file)
index 0000000..6746238
--- /dev/null
@@ -0,0 +1,78 @@
+/* Copyright 2019 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/>.  */
+
+typedef int my_int_t;
+typedef float my_float_t;
+typedef my_int_t nested_int_t;
+typedef my_float_t nested_float_t;
+
+struct baz_t
+{
+  float f;
+  double d;
+};
+
+typedef struct baz_t baz_t;
+typedef struct baz_t baz;
+typedef baz_t nested_baz_t;
+typedef baz nested_baz;
+typedef struct baz_t *baz_ptr;
+
+enum enum_t
+{
+ AA, BB, CC
+};
+
+typedef enum enum_t my_enum_t;
+typedef my_enum_t nested_enum_t;
+
+volatile int var_a;
+volatile float var_b;
+volatile my_int_t var_c;
+volatile my_float_t var_d;
+volatile nested_int_t var_e;
+volatile nested_float_t var_f;
+volatile struct baz_t var_g;
+volatile baz_t var_h;
+volatile baz var_i;
+volatile nested_baz_t var_j;
+volatile nested_baz var_k;
+volatile baz_ptr var_l;
+volatile enum enum_t var_m;
+volatile my_enum_t var_n;
+volatile nested_enum_t var_o;
+
+#ifdef __cplusplus
+
+class CL
+{
+  int a;
+};
+
+typedef CL my_cl;
+typedef CL *my_ptr;
+
+volatile CL var_cpp_a;
+volatile my_cl var_cpp_b;
+volatile my_ptr var_cpp_c;
+
+#endif /* __cplusplus */
+
+int
+main ()
+{
+  asm ("" ::: "memory");
+  return 0;
+}
diff --git a/gdb/testsuite/gdb.base/info-types.exp b/gdb/testsuite/gdb.base/info-types.exp
new file mode 100644 (file)
index 0000000..a580842
--- /dev/null
@@ -0,0 +1,109 @@
+# Copyright 2019 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/>.
+
+# Check that 'info types' produces the expected output for an inferior
+# containing a number of different types.
+
+# Only test C++ if we are able.  Always use C.
+if { [skip_cplus_tests] || [get_compiler_info "c++"] } {
+    set lang {c}
+} else {
+    set lang {c c++}
+}
+
+foreach l $lang {
+    set dir "$l"
+    remote_exec host "rm -rf [standard_output_file ${dir}]"
+    remote_exec host "mkdir -p [standard_output_file ${dir}]"
+}
+
+# Run 'info types' test, compiling the test file for language LANG,
+# which should be either 'c' or 'c++'.
+proc run_test { lang } {
+    global testfile
+    global srcfile
+    global binfile
+    global subdir
+    global srcdir
+    global compile_flags
+
+    standard_testfile .c
+
+    if {[prepare_for_testing "failed to prepare" \
+            "${lang}/${testfile}" $srcfile "debug $lang"]} {
+       return -1
+    }
+
+    if ![runto_main] then {
+       fail "can't run to main"
+       return 0
+    }
+
+    if { $lang == "c++" } {
+       set output_re \
+           [multi_line \
+                "All defined types:" \
+                "" \
+                "File .*:" \
+                "59:\[\t \]+CL;" \
+                "21:\[\t \]+baz_t;" \
+                "33:\[\t \]+enum_t;" \
+                "28:\[\t \]+typedef baz_t baz;" \
+                "31:\[\t \]+typedef baz_t \\* baz_ptr;" \
+                "27:\[\t \]+typedef baz_t baz_t;" \
+                "\[\t \]+double" \
+                "\[\t \]+float" \
+                "\[\t \]+int" \
+                "64:\[\t \]+typedef CL my_cl;" \
+                "38:\[\t \]+typedef enum_t my_enum_t;" \
+                "17:\[\t \]+typedef float my_float_t;" \
+                "16:\[\t \]+typedef int my_int_t;" \
+                "65:\[\t \]+typedef CL \\* my_ptr;" \
+                "30:\[\t \]+typedef baz_t nested_baz;" \
+                "29:\[\t \]+typedef baz_t nested_baz_t;" \
+                "39:\[\t \]+typedef enum_t nested_enum_t;" \
+                "19:\[\t \]+typedef float nested_float_t;" \
+                "18:\[\t \]+typedef int nested_int_t;" \
+                "\[\t \]+unsigned int"]
+    } else {
+       set output_re \
+           [multi_line \
+                "All defined types:" \
+                "" \
+                "File .*:" \
+                "28:\[\t \]+typedef struct baz_t baz;" \
+                "31:\[\t \]+typedef struct baz_t \\* baz_ptr;" \
+                "21:\[\t \]+struct baz_t;" \
+                "\[\t \]+double" \
+                "33:\[\t \]+enum enum_t;" \
+                "\[\t \]+float" \
+                "\[\t \]+int" \
+                "38:\[\t \]+typedef enum enum_t my_enum_t;" \
+                "17:\[\t \]+typedef float my_float_t;" \
+                "16:\[\t \]+typedef int my_int_t;" \
+                "30:\[\t \]+typedef struct baz_t nested_baz;" \
+                "29:\[\t \]+typedef struct baz_t nested_baz_t;" \
+                "39:\[\t \]+typedef enum enum_t nested_enum_t;" \
+                "19:\[\t \]+typedef float nested_float_t;" \
+                "18:\[\t \]+typedef int nested_int_t;" \
+                "\[\t \]+unsigned int" ]
+    }
+
+    gdb_test "info types" $output_re
+}
+
+foreach_with_prefix l $lang {
+    run_test $l
+}
This page took 0.033851 seconds and 4 git commands to generate.