gdb: GDB/MI Input Syntax

 
 27.2.1 GDB/MI Input Syntax
 --------------------------
 
 'COMMAND ==>'
      'CLI-COMMAND | MI-COMMAND'
 
 'CLI-COMMAND ==>'
      '[ TOKEN ] CLI-COMMAND NL', where CLI-COMMAND is any existing GDB
      CLI command.
 
 'MI-COMMAND ==>'
      '[ TOKEN ] "-" OPERATION ( " " OPTION )* [ " --" ] ( " " PARAMETER
      )* NL'
 
 'TOKEN ==>'
      "any sequence of digits"
 
 'OPTION ==>'
      '"-" PARAMETER [ " " PARAMETER ]'
 
 'PARAMETER ==>'
      'NON-BLANK-SEQUENCE | C-STRING'
 
 'OPERATION ==>'
      _any of the operations described in this chapter_
 
 'NON-BLANK-SEQUENCE ==>'
      _anything, provided it doesn't contain special characters such as
      "-", NL, """ and of course " "_
 
 'C-STRING ==>'
      '""" SEVEN-BIT-ISO-C-STRING-CONTENT """'
 
 'NL ==>'
      'CR | CR-LF'
 
 Notes:
 
    * The CLI commands are still handled by the MI interpreter; their
      output is described below.
 
    * The 'TOKEN', when present, is passed back when the command
      finishes.
 
    * Some MI commands accept optional arguments as part of the parameter
      list.  Each option is identified by a leading '-' (dash) and may be
      followed by an optional argument parameter.  Options occur first in
      the parameter list and can be delimited from normal parameters
      using '--' (this is useful when some parameters begin with a dash).
 
    Pragmatics:
 
    * We want easy access to the existing CLI syntax (for debugging).
 
    * We want it to be easy to spot a MI operation.