/* MI Command Set - varobj commands. Copyright (C) 2000, 2002, 2004, 2005, 2007, 2008, 2009 Free Software Foundation, Inc. Contributed by Cygnus Solutions (a Red Hat company). This file is part of GDB. 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 . */ #include "defs.h" #include "mi-cmds.h" #include "ui-out.h" #include "mi-out.h" #include "varobj.h" #include "value.h" #include #include "gdb_string.h" #include "mi-getopt.h" #include "gdbthread.h" const char mi_no_values[] = "--no-values"; const char mi_simple_values[] = "--simple-values"; const char mi_all_values[] = "--all-values"; extern int varobjdebug; /* defined in varobj.c. */ static void varobj_update_one (struct varobj *var, enum print_values print_values, int explicit); static int mi_print_value_p (struct type *type, enum print_values print_values); /* Print variable object VAR. The PRINT_VALUES parameter controls if the value should be printed. The PRINT_EXPRESSION parameter controls if the expression should be printed. */ static void print_varobj (struct varobj *var, enum print_values print_values, int print_expression) { struct type *gdb_type; char *type; int thread_id; ui_out_field_string (uiout, "name", varobj_get_objname (var)); if (print_expression) ui_out_field_string (uiout, "exp", varobj_get_expression (var)); ui_out_field_int (uiout, "numchild", varobj_get_num_children (var)); if (mi_print_value_p (varobj_get_gdb_type (var), print_values)) ui_out_field_string (uiout, "value", varobj_get_value (var)); type = varobj_get_type (var); if (type != NULL) { ui_out_field_string (uiout, "type", type); xfree (type); } thread_id = varobj_get_thread_id (var); if (thread_id > 0) ui_out_field_int (uiout, "thread-id", thread_id); if (varobj_get_frozen (var)) ui_out_field_int (uiout, "frozen", 1); } /* VAROBJ operations */ void mi_cmd_var_create (char *command, char **argv, int argc) { CORE_ADDR frameaddr = 0; struct varobj *var; char *name; char *frame; char *expr; struct cleanup *old_cleanups; enum varobj_type var_type; if (argc != 3) { /* mi_error_message = xstrprintf ("mi_cmd_var_create: Usage: ...."); return MI_CMD_ERROR; */ error (_("mi_cmd_var_create: Usage: NAME FRAME EXPRESSION.")); } name = xstrdup (argv[0]); /* Add cleanup for name. Must be free_current_contents as name can be reallocated */ old_cleanups = make_cleanup (free_current_contents, &name); frame = xstrdup (argv[1]); make_cleanup (xfree, frame); expr = xstrdup (argv[2]); make_cleanup (xfree, expr); if (strcmp (name, "-") == 0) { xfree (name); name = varobj_gen_name (); } else if (!isalpha (*name)) error (_("mi_cmd_var_create: name of object must begin with a letter")); if (strcmp (frame, "*") == 0) var_type = USE_CURRENT_FRAME; else if (strcmp (frame, "@") == 0) var_type = USE_SELECTED_FRAME; else { var_type = USE_SPECIFIED_FRAME; frameaddr = string_to_core_addr (frame); } if (varobjdebug) fprintf_unfiltered (gdb_stdlog, "Name=\"%s\", Frame=\"%s\" (%s), Expression=\"%s\"\n", name, frame, hex_string (frameaddr), expr); var = varobj_create (name, expr, frameaddr, var_type); if (var == NULL) error (_("mi_cmd_var_create: unable to create variable object")); print_varobj (var, PRINT_ALL_VALUES, 0 /* don't print expression */); do_cleanups (old_cleanups); } void mi_cmd_var_delete (char *command, char **argv, int argc) { char *name; struct varobj *var; int numdel; int children_only_p = 0; struct cleanup *old_cleanups; if (argc < 1 || argc > 2) error (_("mi_cmd_var_delete: Usage: [-c] EXPRESSION.")); name = xstrdup (argv[0]); /* Add cleanup for name. Must be free_current_contents as name can be reallocated */ old_cleanups = make_cleanup (free_current_contents, &name); /* If we have one single argument it cannot be '-c' or any string starting with '-'. */ if (argc == 1) { if (strcmp (name, "-c") == 0) error (_("mi_cmd_var_delete: Missing required argument after '-c': variable object name")); if (*name == '-') error (_("mi_cmd_var_delete: Illegal variable object name")); } /* If we have 2 arguments they must be '-c' followed by a string which would be the variable name. */ if (argc == 2) { if (strcmp (name, "-c") != 0) error (_("mi_cmd_var_delete: Invalid option.")); children_only_p = 1; do_cleanups (old_cleanups); name = xstrdup (argv[1]); make_cleanup (free_current_contents, &name); } /* If we didn't error out, now NAME contains the name of the variable. */ var = varobj_get_handle (name); numdel = varobj_delete (var, NULL, children_only_p); ui_out_field_int (uiout, "ndeleted", numdel); do_cleanups (old_cleanups); } /* Parse a string argument into a format value. */ static enum varobj_display_formats mi_parse_format (const char *arg) { if (arg != NULL) { int len; len = strlen (arg); if (strncmp (arg, "natural", len) == 0) return FORMAT_NATURAL; else if (strncmp (arg, "binary", len) == 0) return FORMAT_BINARY; else if (strncmp (arg, "decimal", len) == 0) return FORMAT_DECIMAL; else if (strncmp (arg, "hexadecimal", len) == 0) return FORMAT_HEXADECIMAL; else if (strncmp (arg, "octal", len) == 0) return FORMAT_OCTAL; } error (_("Must specify the format as: \"natural\", \"binary\", \"decimal\", \"hexadecimal\", or \"octal\"")); } void mi_cmd_var_set_format (char *command, char **argv, int argc) { enum varobj_display_formats format; struct varobj *var; if (argc != 2) error (_("mi_cmd_var_set_format: Usage: NAME FORMAT.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); format = mi_parse_format (argv[1]); /* Set the format of VAR to given format */ varobj_set_display_format (var, format); /* Report the new current format */ ui_out_field_string (uiout, "format", varobj_format_string[(int) format]); /* Report the value in the new format */ ui_out_field_string (uiout, "value", varobj_get_value (var)); } void mi_cmd_var_set_visualizer (char *command, char **argv, int argc) { struct varobj *var; if (argc != 2) error ("Usage: NAME VISUALIZER_FUNCTION."); var = varobj_get_handle (argv[0]); if (var == NULL) error ("Variable object not found"); varobj_set_visualizer (var, argv[1]); } void mi_cmd_var_set_frozen (char *command, char **argv, int argc) { struct varobj *var; int frozen; if (argc != 2) error (_("-var-set-format: Usage: NAME FROZEN_FLAG.")); var = varobj_get_handle (argv[0]); if (strcmp (argv[1], "0") == 0) frozen = 0; else if (strcmp (argv[1], "1") == 0) frozen = 1; else error (_("Invalid flag value")); varobj_set_frozen (var, frozen); /* We don't automatically return the new value, or what varobjs got new values during unfreezing. If this information is required, client should call -var-update explicitly. */ } void mi_cmd_var_show_format (char *command, char **argv, int argc) { enum varobj_display_formats format; struct varobj *var; if (argc != 1) error (_("mi_cmd_var_show_format: Usage: NAME.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); format = varobj_get_display_format (var); /* Report the current format */ ui_out_field_string (uiout, "format", varobj_format_string[(int) format]); } void mi_cmd_var_info_num_children (char *command, char **argv, int argc) { struct varobj *var; if (argc != 1) error (_("mi_cmd_var_info_num_children: Usage: NAME.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); ui_out_field_int (uiout, "numchild", varobj_get_num_children (var)); } /* Parse a string argument into a print_values value. */ static enum print_values mi_parse_values_option (const char *arg) { if (strcmp (arg, "0") == 0 || strcmp (arg, mi_no_values) == 0) return PRINT_NO_VALUES; else if (strcmp (arg, "1") == 0 || strcmp (arg, mi_all_values) == 0) return PRINT_ALL_VALUES; else if (strcmp (arg, "2") == 0 || strcmp (arg, mi_simple_values) == 0) return PRINT_SIMPLE_VALUES; else error (_("Unknown value for PRINT_VALUES\n\ Must be: 0 or \"%s\", 1 or \"%s\", 2 or \"%s\""), mi_no_values, mi_simple_values, mi_all_values); } /* Return 1 if given the argument PRINT_VALUES we should display a value of type TYPE. */ static int mi_print_value_p (struct type *type, enum print_values print_values) { if (print_values == PRINT_NO_VALUES) return 0; if (print_values == PRINT_ALL_VALUES) return 1; if (type == NULL) return 1; else { type = check_typedef (type); /* For PRINT_SIMPLE_VALUES, only print the value if it has a type and that type is not a compound type. */ return (TYPE_CODE (type) != TYPE_CODE_ARRAY && TYPE_CODE (type) != TYPE_CODE_STRUCT && TYPE_CODE (type) != TYPE_CODE_UNION); } } void mi_cmd_var_list_children (char *command, char **argv, int argc) { struct varobj *var; VEC(varobj_p) *children; struct varobj *child; struct cleanup *cleanup_children; int numchild; enum print_values print_values; int ix; char *display_hint; if (argc != 1 && argc != 2) error (_("mi_cmd_var_list_children: Usage: [PRINT_VALUES] NAME")); /* Get varobj handle, if a valid var obj name was specified */ if (argc == 1) var = varobj_get_handle (argv[0]); else var = varobj_get_handle (argv[1]); children = varobj_list_children (var); ui_out_field_int (uiout, "numchild", VEC_length (varobj_p, children)); if (argc == 2) print_values = mi_parse_values_option (argv[0]); else print_values = PRINT_NO_VALUES; display_hint = varobj_get_display_hint (var); if (display_hint) { ui_out_field_string (uiout, "displayhint", display_hint); xfree (display_hint); } if (VEC_length (varobj_p, children) == 0) return; if (mi_version (uiout) == 1) cleanup_children = make_cleanup_ui_out_tuple_begin_end (uiout, "children"); else cleanup_children = make_cleanup_ui_out_list_begin_end (uiout, "children"); for (ix = 0; VEC_iterate (varobj_p, children, ix, child); ++ix) { struct cleanup *cleanup_child; cleanup_child = make_cleanup_ui_out_tuple_begin_end (uiout, "child"); print_varobj (child, print_values, 1 /* print expression */); do_cleanups (cleanup_child); } do_cleanups (cleanup_children); } void mi_cmd_var_info_type (char *command, char **argv, int argc) { struct varobj *var; if (argc != 1) error (_("mi_cmd_var_info_type: Usage: NAME.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); ui_out_field_string (uiout, "type", varobj_get_type (var)); } void mi_cmd_var_info_path_expression (char *command, char **argv, int argc) { struct varobj *var; char *path_expr; if (argc != 1) error (_("Usage: NAME.")); /* Get varobj handle, if a valid var obj name was specified. */ var = varobj_get_handle (argv[0]); path_expr = varobj_get_path_expr (var); ui_out_field_string (uiout, "path_expr", path_expr); } void mi_cmd_var_info_expression (char *command, char **argv, int argc) { enum varobj_languages lang; struct varobj *var; if (argc != 1) error (_("mi_cmd_var_info_expression: Usage: NAME.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); lang = varobj_get_language (var); ui_out_field_string (uiout, "lang", varobj_language_string[(int) lang]); ui_out_field_string (uiout, "exp", varobj_get_expression (var)); } void mi_cmd_var_show_attributes (char *command, char **argv, int argc) { int attr; char *attstr; struct varobj *var; if (argc != 1) error (_("mi_cmd_var_show_attributes: Usage: NAME.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); attr = varobj_get_attributes (var); /* FIXME: define masks for attributes */ if (attr & 0x00000001) attstr = "editable"; else attstr = "noneditable"; ui_out_field_string (uiout, "attr", attstr); } void mi_cmd_var_evaluate_expression (char *command, char **argv, int argc) { struct varobj *var; enum varobj_display_formats format; int formatFound; int optind; char *optarg; enum opt { OP_FORMAT }; static struct mi_opt opts[] = { {"f", OP_FORMAT, 1}, { 0, 0, 0 } }; /* Parse arguments */ format = FORMAT_NATURAL; formatFound = 0; optind = 0; while (1) { int opt = mi_getopt ("-var-evaluate-expression", argc, argv, opts, &optind, &optarg); if (opt < 0) break; switch ((enum opt) opt) { case OP_FORMAT: if (formatFound) error (_("Cannot specify format more than once")); format = mi_parse_format (optarg); formatFound = 1; break; } } if (optind >= argc) error (_("Usage: [-f FORMAT] NAME")); if (optind < argc - 1) error (_("Garbage at end of command")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[optind]); if (formatFound) ui_out_field_string (uiout, "value", varobj_get_formatted_value (var, format)); else ui_out_field_string (uiout, "value", varobj_get_value (var)); } void mi_cmd_var_assign (char *command, char **argv, int argc) { struct varobj *var; char *expression; if (argc != 2) error (_("mi_cmd_var_assign: Usage: NAME EXPRESSION.")); /* Get varobj handle, if a valid var obj name was specified */ var = varobj_get_handle (argv[0]); if (!varobj_editable_p (var)) error (_("mi_cmd_var_assign: Variable object is not editable")); expression = xstrdup (argv[1]); if (!varobj_set_value (var, expression)) error (_("mi_cmd_var_assign: Could not assign expression to variable object")); ui_out_field_string (uiout, "value", varobj_get_value (var)); } void mi_cmd_var_update (char *command, char **argv, int argc) { struct cleanup *cleanup; char *name; enum print_values print_values; if (argc != 1 && argc != 2) error (_("mi_cmd_var_update: Usage: [PRINT_VALUES] NAME.")); if (argc == 1) name = argv[0]; else name = (argv[1]); if (argc == 2) print_values = mi_parse_values_option (argv[0]); else print_values = PRINT_NO_VALUES; if (mi_version (uiout) <= 1) cleanup = make_cleanup_ui_out_tuple_begin_end (uiout, "changelist"); else cleanup = make_cleanup_ui_out_list_begin_end (uiout, "changelist"); /* Check if the parameter is a "*" which means that we want to update all variables */ if ((*name == '*' || *name == '@') && (*(name + 1) == '\0')) { struct varobj **rootlist, **cr; varobj_list (&rootlist); make_cleanup (xfree, rootlist); for (cr = rootlist; *cr != NULL; cr++) { int thread_id = varobj_get_thread_id (*cr); int thread_stopped = 0; if (thread_id == -1 && is_stopped (inferior_ptid)) thread_stopped = 1; else { struct thread_info *tp = find_thread_id (thread_id); if (tp) thread_stopped = is_stopped (tp->ptid); else thread_stopped = 1; } if (thread_stopped) if (*name == '*' || varobj_floating_p (*cr)) varobj_update_one (*cr, print_values, 0 /* implicit */); } } else { /* Get varobj handle, if a valid var obj name was specified */ struct varobj *var = varobj_get_handle (name); varobj_update_one (var, print_values, 1 /* explicit */); } do_cleanups (cleanup); } /* Helper for mi_cmd_var_update(). */ static void varobj_update_one (struct varobj *var, enum print_values print_values, int explicit) { struct varobj **cc; struct cleanup *cleanup = NULL; VEC (varobj_update_result) *changes; varobj_update_result *r; int i; changes = varobj_update (&var, explicit); for (i = 0; VEC_iterate (varobj_update_result, changes, i, r); ++i) { char *display_hint; if (mi_version (uiout) > 1) cleanup = make_cleanup_ui_out_tuple_begin_end (uiout, NULL); ui_out_field_string (uiout, "name", varobj_get_objname (r->varobj)); switch (r->status) { case VAROBJ_IN_SCOPE: if (mi_print_value_p (varobj_get_gdb_type (r->varobj), print_values)) ui_out_field_string (uiout, "value", varobj_get_value (r->varobj)); ui_out_field_string (uiout, "in_scope", "true"); break; case VAROBJ_NOT_IN_SCOPE: ui_out_field_string (uiout, "in_scope", "false"); break; case VAROBJ_INVALID: ui_out_field_string (uiout, "in_scope", "invalid"); break; } if (r->status != VAROBJ_INVALID) { if (r->type_changed) ui_out_field_string (uiout, "type_changed", "true"); else ui_out_field_string (uiout, "type_changed", "false"); } if (r->type_changed) { ui_out_field_string (uiout, "new_type", varobj_get_type (r->varobj)); ui_out_field_int (uiout, "new_num_children", varobj_get_num_children (r->varobj)); } display_hint = varobj_get_display_hint (var); if (display_hint) { ui_out_field_string (uiout, "displayhint", display_hint); xfree (display_hint); } if (r->children_changed) { int ix; struct varobj *child; struct cleanup *cleanup = make_cleanup_ui_out_list_begin_end (uiout, "children"); VEC (varobj_p)* children = varobj_list_children (r->varobj); for (ix = 0; VEC_iterate (varobj_p, children, ix, child); ++ix) { struct cleanup *cleanup_child; cleanup_child = make_cleanup_ui_out_tuple_begin_end (uiout, NULL); print_varobj (child, print_values, 1 /* print expression */); do_cleanups (cleanup_child); } do_cleanups (cleanup); } if (mi_version (uiout) > 1) do_cleanups (cleanup); } VEC_free (varobj_update_result, changes); }