* mi/mi-cmds.c (mi_cmds): Register -list-features.
authorVladimir Prus <vladimir@codesourcery.com>
Sun, 16 Sep 2007 14:59:31 +0000 (14:59 +0000)
committerVladimir Prus <vladimir@codesourcery.com>
Sun, 16 Sep 2007 14:59:31 +0000 (14:59 +0000)
* mi/mi-cmds.h (mi_cmd_list_features): New.
* mi/mi-main.c (mi_cmd_list_features): New.

gdb/ChangeLog
gdb/doc/ChangeLog
gdb/doc/gdb.texinfo
gdb/mi/mi-cmds.c
gdb/mi/mi-cmds.h
gdb/mi/mi-main.c

index 4d8e5b0e458cd3c7dc7d862bbdd41d111da20b5d..c70570dcbf2f8b81989f542a7d5da8eed726513b 100644 (file)
@@ -1,3 +1,9 @@
+2007-09-16  Vladimir Prus  <vladimir@codesourcery.com>
+
+       * mi/mi-cmds.c (mi_cmds): Register -list-features.
+       * mi/mi-cmds.h (mi_cmd_list_features): New.
+       * mi/mi-main.c (mi_cmd_list_features): New.
+       
 2007-09-11  Joel Brobecker  <brobecker@adacore.com>
 
        GDB 6.7 branch created (branch timestamp: 2007-09-07 14:00 UTC)
index 6be80d6674e80a771efcdace8cae98ab791d1408..67f74b9e3a1b7d38d527985b16b67aed39e1fb9b 100644 (file)
@@ -1,3 +1,8 @@
+2007-09-19  Vladimir Prus  <vladimir@codesourcery.com>
+
+       * gdb.texinfo (Miscellaneous gdb/mi Commands):
+       Document -list-features.
+       
 2007-09-15  Eli Zaretskii  <eliz@gnu.org>
 
        * gdb.texinfo (Output): Spell out which features of C's printf are
index 9a743697ae7008e8b814046b6c31f9dbb82bab0a..4378e0c3f55dbdf1c8dbe10abb237dd08f19cf45 100644 (file)
@@ -21277,6 +21277,37 @@ default shows this information when you start an interactive session.
 (gdb)
 @end smallexample
 
+@subheading The @code{-list-features} Command
+@findex -list-features
+
+Returns a list of particular features of the MI protocol that
+this version of gdb implements.  A feature can be a command,
+or a new field in an output of some command, or even an
+important bugfix.  While a frontend can sometimes detect presence
+of a feature at runtime, it is easier to perform detection at debugger
+startup. 
+
+The command returns a list of strings, with each string naming an
+available feature.  Each returned string is just a name, it does not
+have any internal structure.  The list of possible feature names 
+is given below.
+
+Example output:
+
+@smallexample
+(gdb) -list-features
+^done,result=["feature1","feature2"]
+@end smallexample
+
+The current list of features is:
+
+@itemize @minus
+@item
+@samp{frozen-varobjs}---indicates presence of the
+@code{-var-set-frozen} command, as well as possible presense of the
+@code{frozen} field in the output of @code{-varobj-create}.
+@end itemize
+
 @subheading The @code{-interpreter-exec} Command
 @findex -interpreter-exec
 
index 48ba2087fa1261603ed0a89f84310f81972eebd4..5bd8725e9c22a1107cbef5f55fe1ce41b70ce3af 100644 (file)
@@ -88,6 +88,7 @@ struct mi_cmd mi_cmds[] =
   { "inferior-tty-set", { NULL, 0 }, NULL, mi_cmd_inferior_tty_set},
   { "inferior-tty-show", { NULL, 0 }, NULL, mi_cmd_inferior_tty_show},
   { "interpreter-exec", { NULL, 0 }, 0, mi_cmd_interpreter_exec},
+  { "list-features", { NULL, 0 }, 0, mi_cmd_list_features},
   { "overlay-auto", { NULL, 0 }, NULL, NULL },
   { "overlay-list-mapping-state", { NULL, 0 }, NULL, NULL },
   { "overlay-list-overlays", { NULL, 0 }, NULL, NULL },
index 7b3eb0e3bae54a8bdd91ae4d98e7a1b108b4b7f4..9888c85fb82128a03ad7adfd73ce0a693ed5d2c9 100644 (file)
@@ -91,6 +91,7 @@ extern mi_cmd_argv_ftype mi_cmd_gdb_exit;
 extern mi_cmd_argv_ftype mi_cmd_inferior_tty_set;
 extern mi_cmd_argv_ftype mi_cmd_inferior_tty_show;
 extern mi_cmd_argv_ftype mi_cmd_interpreter_exec;
+extern mi_cmd_argv_ftype mi_cmd_list_features;
 extern mi_cmd_argv_ftype mi_cmd_stack_info_depth;
 extern mi_cmd_argv_ftype mi_cmd_stack_info_frame;
 extern mi_cmd_argv_ftype mi_cmd_stack_list_args;
index 0c4b904470c80f579ab93df4dd048ac736a06987..93e28bf50495f0241b4a2635e84a2e336430f8bc 100644 (file)
@@ -1075,6 +1075,25 @@ mi_cmd_enable_timings (char *command, char **argv, int argc)
   return MI_CMD_ERROR;
 }
 
+enum mi_cmd_result
+mi_cmd_list_features (char *command, char **argv, int argc)
+{
+  if (argc == 0)
+    {
+      struct cleanup *cleanup = NULL;
+      cleanup = make_cleanup_ui_out_list_begin_end (uiout, "features");      
+
+      ui_out_field_string (uiout, NULL, "frozen-varobjs");
+      
+      do_cleanups (cleanup);
+
+      return MI_CMD_DONE;
+    }
+
+  error ("-list-features should be passed no arguments");
+  return MI_CMD_ERROR;
+}
 /* Execute a command within a safe environment.
    Return <0 for error; >=0 for ok.