1 /* 2 * Core Definitions for QAPI/QMP Dispatch 3 * 4 * Copyright IBM, Corp. 2011 5 * 6 * Authors: 7 * Anthony Liguori <aliguori@us.ibm.com> 8 * 9 * This work is licensed under the terms of the GNU LGPL, version 2.1 or later. 10 * See the COPYING.LIB file in the top-level directory. 11 * 12 */ 13 14 #ifndef QAPI_QMP_DISPATCH_H 15 #define QAPI_QMP_DISPATCH_H 16 17 #include "monitor/monitor.h" 18 #include "qemu/queue.h" 19 20 typedef void (QmpCommandFunc)(QDict *, QObject **, Error **); 21 22 typedef enum QmpCommandOptions 23 { 24 QCO_NO_OPTIONS = 0x0, 25 QCO_NO_SUCCESS_RESP = (1U << 0), 26 QCO_ALLOW_OOB = (1U << 1), 27 QCO_ALLOW_PRECONFIG = (1U << 2), 28 QCO_COROUTINE = (1U << 3), 29 } QmpCommandOptions; 30 31 typedef struct QmpCommand 32 { 33 const char *name; 34 /* Runs in coroutine context if QCO_COROUTINE is set */ 35 QmpCommandFunc *fn; 36 QmpCommandOptions options; 37 QTAILQ_ENTRY(QmpCommand) node; 38 bool enabled; 39 } QmpCommand; 40 41 typedef QTAILQ_HEAD(QmpCommandList, QmpCommand) QmpCommandList; 42 43 void qmp_register_command(QmpCommandList *cmds, const char *name, 44 QmpCommandFunc *fn, QmpCommandOptions options); 45 const QmpCommand *qmp_find_command(const QmpCommandList *cmds, 46 const char *name); 47 void qmp_disable_command(QmpCommandList *cmds, const char *name); 48 void qmp_enable_command(QmpCommandList *cmds, const char *name); 49 50 bool qmp_command_is_enabled(const QmpCommand *cmd); 51 bool qmp_command_available(const QmpCommand *cmd, Error **errp); 52 const char *qmp_command_name(const QmpCommand *cmd); 53 bool qmp_has_success_response(const QmpCommand *cmd); 54 QDict *qmp_error_response(Error *err); 55 QDict *qmp_dispatch(const QmpCommandList *cmds, QObject *request, 56 bool allow_oob, Monitor *cur_mon); 57 bool qmp_is_oob(const QDict *dict); 58 59 typedef void (*qmp_cmd_callback_fn)(const QmpCommand *cmd, void *opaque); 60 61 void qmp_for_each_command(const QmpCommandList *cmds, qmp_cmd_callback_fn fn, 62 void *opaque); 63 64 #endif 65