/* MI Command Set - MI parser. Copyright (C) 2000-2024 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 "mi-cmds.h" #include "mi-parse.h" #include "charset.h" #include #include "cli/cli-utils.h" #include "language.h" static const char mi_no_values[] = "--no-values"; static const char mi_simple_values[] = "--simple-values"; static const char mi_all_values[] = "--all-values"; /* Like parse_escape, but leave the results as a host char, not a target char. */ static int mi_parse_escape (const char **string_ptr) { int c = *(*string_ptr)++; switch (c) { case '\n': return -2; case 0: (*string_ptr)--; return 0; case '0': case '1': case '2': case '3': case '4': case '5': case '6': case '7': { int i = fromhex (c); int count = 0; while (++count < 3) { c = (**string_ptr); if (isdigit (c) && c != '8' && c != '9') { (*string_ptr)++; i *= 8; i += fromhex (c); } else { break; } } return i; } case 'a': c = '\a'; break; case 'b': c = '\b'; break; case 'f': c = '\f'; break; case 'n': c = '\n'; break; case 'r': c = '\r'; break; case 't': c = '\t'; break; case 'v': c = '\v'; break; default: break; } return c; } void mi_parse::parse_argv () { /* If arguments were already computed (or were supplied at construction), then there's no need to re-compute them. */ if (argv != nullptr) return; const char *chp = m_args.c_str (); int argc = 0; char **argv = XNEWVEC (char *, argc + 1); argv[argc] = NULL; while (1) { char *arg; /* Skip leading white space. */ chp = skip_spaces (chp); /* Three possibilities: EOF, quoted string, or other text. */ switch (*chp) { case '\0': this->argv = argv; this->argc = argc; return; case '"': { /* A quoted string. */ int len; const char *start = chp + 1; /* Determine the buffer size. */ chp = start; len = 0; while (*chp != '\0' && *chp != '"') { if (*chp == '\\') { chp++; if (mi_parse_escape (&chp) <= 0) { /* Do not allow split lines or "\000". */ freeargv (argv); return; } } else chp++; len++; } /* Insist on a closing quote. */ if (*chp != '"') { freeargv (argv); return; } /* Insist on trailing white space. */ if (chp[1] != '\0' && !isspace (chp[1])) { freeargv (argv); return; } /* Create the buffer and copy characters in. */ arg = XNEWVEC (char, len + 1); chp = start; len = 0; while (*chp != '\0' && *chp != '"') { if (*chp == '\\') { chp++; arg[len] = mi_parse_escape (&chp); } else arg[len] = *chp++; len++; } arg[len] = '\0'; chp++; /* That closing quote. */ break; } default: { /* An unquoted string. Accumulate all non-blank characters into a buffer. */ int len; const char *start = chp; while (*chp != '\0' && !isspace (*chp)) { chp++; } len = chp - start; arg = XNEWVEC (char, len + 1); strncpy (arg, start, len); arg[len] = '\0'; break; } } /* Append arg to argv. */ argv = XRESIZEVEC (char *, argv, argc + 2); argv[argc++] = arg; argv[argc] = NULL; } } mi_parse::~mi_parse () { freeargv (argv); } /* See mi-parse.h. */ const char * mi_parse::args () { /* If args were already computed, or if there is no pre-computed argv, just return the args. */ if (!m_args.empty () || argv == nullptr) return m_args.c_str (); /* Compute args from argv. */ for (int i = 0; i < argc; ++i) { if (!m_args.empty ()) m_args += " "; m_args += argv[i]; } return m_args.c_str (); } /* See mi-parse.h. */ void mi_parse::set_thread_group (const char *arg, char **endp) { if (thread_group != -1) error (_("Duplicate '--thread-group' option")); if (*arg != 'i') error (_("Invalid thread group id")); arg += 1; thread_group = strtol (arg, endp, 10); } /* See mi-parse.h. */ void mi_parse::set_thread (const char *arg, char **endp) { if (thread != -1) error (_("Duplicate '--thread' option")); thread = strtol (arg, endp, 10); } /* See mi-parse.h. */ void mi_parse::set_frame (const char *arg, char **endp) { if (frame != -1) error (_("Duplicate '--frame' option")); frame = strtol (arg, endp, 10); } /* See mi-parse.h. */ void mi_parse::set_language (const char *arg, const char **endp) { std::string lang_name = extract_arg (&arg); language = language_enum (lang_name.c_str ()); if (language == language_unknown) error (_("Invalid --language argument: %s"), lang_name.c_str ()); if (endp != nullptr) *endp = arg; } /* See mi-parse.h. */ mi_parse::mi_parse (const char *cmd, std::string *token) { const char *chp; /* Before starting, skip leading white space. */ cmd = skip_spaces (cmd); /* Find/skip any token and then extract it. */ for (chp = cmd; *chp >= '0' && *chp <= '9'; chp++) ; *token = std::string (cmd, chp - cmd); /* This wasn't a real MI command. Return it as a CLI_COMMAND. */ if (*chp != '-') { chp = skip_spaces (chp); this->command = make_unique_xstrdup (chp); this->op = CLI_COMMAND; return; } /* Extract the command. */ { const char *tmp = chp + 1; /* discard ``-'' */ for (; *chp && !isspace (*chp); chp++) ; this->command = make_unique_xstrndup (tmp, chp - tmp); } /* Find the command in the MI table. */ this->cmd = mi_cmd_lookup (this->command.get ()); if (this->cmd == NULL) throw_error (UNDEFINED_COMMAND_ERROR, _("Undefined MI command: %s"), this->command.get ()); /* Skip white space following the command. */ chp = skip_spaces (chp); /* Parse the --thread and --frame options, if present. At present, some important commands, like '-break-*' are implemented by forwarding to the CLI layer directly. We want to parse --thread and --frame here, so as not to leave those option in the string that will be passed to CLI. Same for the --language option. */ for (;;) { const char *option; size_t as = sizeof ("--all ") - 1; size_t tgs = sizeof ("--thread-group ") - 1; size_t ts = sizeof ("--thread ") - 1; size_t fs = sizeof ("--frame ") - 1; size_t ls = sizeof ("--language ") - 1; if (strncmp (chp, "--all ", as) == 0) { this->all = 1; chp += as; } /* See if --all is the last token in the input. */ if (strcmp (chp, "--all") == 0) { this->all = 1; chp += strlen (chp); } if (strncmp (chp, "--thread-group ", tgs) == 0) { char *endp; option = "--thread-group"; chp += tgs; this->set_thread_group (chp, &endp); chp = endp; } else if (strncmp (chp, "--thread ", ts) == 0) { char *endp; option = "--thread"; chp += ts; this->set_thread (chp, &endp); chp = endp; } else if (strncmp (chp, "--frame ", fs) == 0) { char *endp; option = "--frame"; chp += fs; this->set_frame (chp, &endp); chp = endp; } else if (strncmp (chp, "--language ", ls) == 0) { option = "--language"; chp += ls; this->set_language (chp, &chp); } else break; if (*chp != '\0' && !isspace (*chp)) error (_("Invalid value for the '%s' option"), option); chp = skip_spaces (chp); } /* Save the rest of the arguments for the command. */ this->m_args = chp; /* Fully parsed, flag as an MI command. */ this->op = MI_COMMAND; } /* See mi-parse.h. */ mi_parse::mi_parse (gdb::unique_xmalloc_ptr command, std::vector> args) { this->command = std::move (command); this->token = ""; if (this->command.get ()[0] != '-') throw_error (UNDEFINED_COMMAND_ERROR, _("MI command '%s' does not start with '-'"), this->command.get ()); /* Find the command in the MI table. */ this->cmd = mi_cmd_lookup (this->command.get () + 1); if (this->cmd == NULL) throw_error (UNDEFINED_COMMAND_ERROR, _("Undefined MI command: %s"), this->command.get ()); /* This over-allocates slightly, but it seems unimportant. */ this->argv = XCNEWVEC (char *, args.size () + 1); for (size_t i = 0; i < args.size (); ++i) { const char *chp = args[i].get (); /* See if --all is the last token in the input. */ if (strcmp (chp, "--all") == 0) { this->all = 1; } else if (strcmp (chp, "--thread-group") == 0) { ++i; if (i == args.size ()) error ("No argument to '--thread-group'"); this->set_thread_group (args[i].get (), nullptr); } else if (strcmp (chp, "--thread") == 0) { ++i; if (i == args.size ()) error ("No argument to '--thread'"); this->set_thread (args[i].get (), nullptr); } else if (strcmp (chp, "--frame") == 0) { ++i; if (i == args.size ()) error ("No argument to '--frame'"); this->set_frame (args[i].get (), nullptr); } else if (strcmp (chp, "--language") == 0) { ++i; if (i == args.size ()) error ("No argument to '--language'"); this->set_language (args[i].get (), nullptr); } else this->argv[this->argc++] = args[i].release (); } /* Fully parsed, flag as an MI command. */ this->op = MI_COMMAND; } enum print_values mi_parse_print_values (const char *name) { if (strcmp (name, "0") == 0 || strcmp (name, mi_no_values) == 0) return PRINT_NO_VALUES; else if (strcmp (name, "1") == 0 || strcmp (name, mi_all_values) == 0) return PRINT_ALL_VALUES; else if (strcmp (name, "2") == 0 || strcmp (name, mi_simple_values) == 0) return PRINT_SIMPLE_VALUES; else error (_("Unknown value for PRINT_VALUES: must be: \ 0 or \"%s\", 1 or \"%s\", 2 or \"%s\""), mi_no_values, mi_all_values, mi_simple_values); }