gdb/mi/mi-parse.h

   1 /* MI Command Set - MI Command Parser.
   2    Copyright (C) 2000, 2007 Free Software Foundation, Inc.
   3    Contributed by Cygnus Solutions (a Red Hat company).
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef MI_PARSE_H
  21 #define MI_PARSE_H
  22
  23 #include <sys/time.h>
  24
  25 /* MI parser */
  26
  27 /* Timestamps for current command and last asynchronous command.  */
  28 struct mi_timestamp {
  29   struct timeval wallclock;
  30   struct timeval utime;
  31   struct timeval stime;
  32 };
  33
  34 enum mi_command_type
  35   {
  36     MI_COMMAND, CLI_COMMAND
  37   };
  38
  39 struct mi_parse
  40   {
  41     enum mi_command_type op;
  42     char *command;
  43     char *token;
  44     const struct mi_cmd *cmd;
  45     struct mi_timestamp *cmd_start;
  46     char *args;
  47     char **argv;
  48     int argc;
  49   };
  50
  51 /* Attempts to parse CMD returning a ``struct mi_command''.  If CMD is
  52    invalid, an error mesage is reported (MI format) and NULL is
  53    returned. For a CLI_COMMAND, COMMAND, TOKEN and OP are initialized.
  54    For an MI_COMMAND COMMAND, TOKEN, ARGS and OP are
  55    initialized. Un-initialized fields are zero. */
  56
  57 extern struct mi_parse *mi_parse (char *cmd);
  58
  59 /* Free a command returned by mi_parse_command. */
  60
  61 extern void mi_parse_free (struct mi_parse *cmd);
  62
  63 #endif