35 The QAPI schema defines the Client JSON Protocol's commands and
40 by any commands or events, for the side effect of generated C code
182 Pragma 'command-name-exceptions' takes a list of commands whose names
185 Pragma 'command-returns-exceptions' takes a list of commands that may
188 Pragma 'documentation-exceptions' takes a list of types, commands, and
450 Commands  section in The QAPI schema language
485 in pragma 'commands-returns-exceptions'.  If you do this, extending
487 the pragma for new commands is strongly discouraged.
497 Some example commands::
515 section `Code generated for commands`_ for examples.
538 Please try to avoid adding new commands that rely on this, and instead
558 Commands supporting out-of-band execution can still be executed
578 requires synchronization, but OOB commands can't take the BQL or any
615 In particular, HMP commands calling such a QMP command handler must be
616 marked ``.coroutine = true`` in hmp-commands.hx.
743 Types, commands, and events share a common namespace.  Therefore,
752 existing older commands and complex types use underscore; when
974 commands and events), member (for structs and unions), branch (for
1012 "Returns" and "Errors" sections are only valid for commands.  They
1226 SchemaInfo for commands and events have the same name as in the QAPI
1408 Clients send commands with argument data, and receive command
1412 compatible: adding commands, optional arguments, enumeration values,
1417 Incompatible changes include removing commands, command arguments,
1466 provides everything required to take JSON commands read in by a Client
1470 introspect the commands.
1748 Code generated for commands
1751 These are the marshaling/dispatch functions for the commands defined
1757  ``$(prefix)qapi-commands.c``
1761  ``$(prefix)qapi-commands.h``
1762      Function prototypes for the QMP commands specified in the schema
1764  ``$(prefix)qapi-commands.trace-events``
1767  ``$(prefix)qapi-init-commands.h``
1770  ``$(prefix)qapi-init-commands.c``
1775     $ cat qapi-generated/example-qapi-commands.h
1788     $ cat qapi-generated/example-qapi-commands.trace-events
1794     $ cat qapi-generated/example-qapi-commands.c
1863     $ cat qapi-generated/example-qapi-init-commands.h
1873     $ cat qapi-generated/example-qapi-init-commands.c
1887  SUBDIR/$(prefix)qapi-commands-SUBMODULE.h
1888  SUBDIR/$(prefix)qapi-commands-SUBMODULE.c