Hi

On Thu, Feb 18, 2021 at 8:40 PM Markus Armbruster <arm...@redhat.com> wrote:

> marcandre.lur...@redhat.com writes:
>
> > From: Marc-André Lureau <marcandre.lur...@redhat.com>
> >
> > qmp_disable_command() now takes an enum for the reason, to be able
> > to give more explicit error messages.
> >
> > Fixes:
> > https://bugzilla.redhat.com/show_bug.cgi?id=1928806
> >
> > Signed-off-by: Marc-André Lureau <marcandre.lur...@redhat.com>
> > ---
> >
> > v2:
> >  - replace string with an enum for disabling reason
> >  - remove trailing dot
> >
> >  include/qapi/qmp/dispatch.h | 12 ++++++++++--
> >  monitor/qmp-cmds-control.c  |  2 +-
> >  qapi/qmp-dispatch.c         | 10 +++++++++-
> >  qapi/qmp-registry.c         | 16 +++++++++-------
> >  qga/main.c                  |  4 ++--
> >  5 files changed, 31 insertions(+), 13 deletions(-)
> >
> > diff --git a/include/qapi/qmp/dispatch.h b/include/qapi/qmp/dispatch.h
> > index 1486cac3ef..fda9ffad73 100644
> > --- a/include/qapi/qmp/dispatch.h
> > +++ b/include/qapi/qmp/dispatch.h
> > @@ -28,6 +28,13 @@ typedef enum QmpCommandOptions
> >      QCO_COROUTINE             =  (1U << 3),
> >  } QmpCommandOptions;
> >
> > +typedef enum QmpDisabled
> > +{
> > +    QMP_DISABLED_NONE,
> > +    QMP_DISABLED_GENERIC,
> > +    QMP_DISABLED_FROZEN,
> > +} QmpDisabled;
> > +
>
> I strongly dislike baking QGA-specific things into the generic
> dispatcher.  I believe it's easy enough to avoid; see below.
>
> >  typedef struct QmpCommand
> >  {
> >      const char *name;
> > @@ -35,7 +42,7 @@ typedef struct QmpCommand
> >      QmpCommandFunc *fn;
> >      QmpCommandOptions options;
> >      QTAILQ_ENTRY(QmpCommand) node;
> > -    bool enabled;
> > +    QmpDisabled disabled;
> >  } QmpCommand;
> >
> >  typedef QTAILQ_HEAD(QmpCommandList, QmpCommand) QmpCommandList;
> > @@ -44,7 +51,8 @@ void qmp_register_command(QmpCommandList *cmds, const
> char *name,
> >                            QmpCommandFunc *fn, QmpCommandOptions
> options);
> >  const QmpCommand *qmp_find_command(const QmpCommandList *cmds,
> >                                     const char *name);
> > -void qmp_disable_command(QmpCommandList *cmds, const char *name);
> > +void qmp_disable_command(QmpCommandList *cmds, const char *name,
> > +                         QmpDisabled disabled);
> >  void qmp_enable_command(QmpCommandList *cmds, const char *name);
> >
> >  bool qmp_command_is_enabled(const QmpCommand *cmd);
> > diff --git a/monitor/qmp-cmds-control.c b/monitor/qmp-cmds-control.c
> > index 509ae870bd..94a8e133b6 100644
> > --- a/monitor/qmp-cmds-control.c
> > +++ b/monitor/qmp-cmds-control.c
> > @@ -107,7 +107,7 @@ static void query_commands_cb(const QmpCommand *cmd,
> void *opaque)
> >      CommandInfo *info;
> >      CommandInfoList **list = opaque;
> >
> > -    if (!cmd->enabled) {
> > +    if (!qmp_command_is_enabled(cmd)) {
> >          return;
> >      }
> >
> > diff --git a/qapi/qmp-dispatch.c b/qapi/qmp-dispatch.c
> > index 0a2b20a4e4..b65f670152 100644
> > --- a/qapi/qmp-dispatch.c
> > +++ b/qapi/qmp-dispatch.c
> > @@ -155,11 +155,19 @@ QDict *qmp_dispatch(const QmpCommandList *cmds,
> QObject *request,
> >                    "The command %s has not been found", command);
> >          goto out;
> >      }
> > -    if (!cmd->enabled) {
> > +    switch (cmd->disabled) {
> > +    case QMP_DISABLED_FROZEN:
> > +        error_set(&err, ERROR_CLASS_COMMAND_NOT_FOUND,
> > +                  "The command %s has been disabled after fsfreeze",
> > +                  command);
> > +        goto out;
> > +    case QMP_DISABLED_GENERIC:
> >          error_set(&err, ERROR_CLASS_COMMAND_NOT_FOUND,
> >                    "The command %s has been disabled for this instance",
> >                    command);
> >          goto out;
> > +    case QMP_DISABLED_NONE:
> > +        break;
> >      }
> >      if (oob && !(cmd->options & QCO_ALLOW_OOB)) {
>
> v1 put an optional error message template into struct QmpCommand, and
> set the error with
>
>          error_set(&err, ERROR_CLASS_COMMAND_NOT_FOUND,
>                    cmd->err_msg ?: "The command %s has been disabled for
> this instance",
>                    command);
>
> Peter Krempa pointed out that this defeats the compiler's format string
> checking.
>
> I feel the proper way to avoid this is to keep an optional string in
> QmpCommand that explains the disablement, and use it like this:
>
>     if (!cmd->enabled) {
>         error_set(&err, ERROR_CLASS_COMMAND_NOT_FOUND,
>                   "Command %s has been disabled%s%s",
>                   command,
>                   cmd->disable_reason ? ": ", "",
>                   cmd->disable_reason ?: "");
>         goto out;
>     }
>
>
Works for me, I'll send a v3.
thanks

If we make the string mandatory, we can ditch cmd->enabled, and say
>
>     if (cmd->disabled) {
>         error_set(&err, ERROR_CLASS_COMMAND_NOT_FOUND,
>                   "Command %s has been disabled: %s",
>                   command, cmd->disabled);
>         goto out;
>     }
>
> [...]
>
>

Reply via email to