[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH 3/4] doc: add item for "-M enforce-config-sectio
From: |
Eduardo Habkost |
Subject: |
Re: [Qemu-devel] [PATCH 3/4] doc: add item for "-M enforce-config-section" |
Date: |
Mon, 3 Jul 2017 14:07:12 -0300 |
User-agent: |
Mutt/1.8.0 (2017-02-23) |
On Mon, Jul 03, 2017 at 10:44:07AM +0800, Peter Xu wrote:
> It's never documented, and now we have one more parameter for it (which
> means this one can be obsolete in the future). Document it properly.
>
> Although now when enforce-config-section is set, it'll override the
> other "-global" parameter, that is not necessarily a rule. Forbid that
> usage in the document.
>
> Suggested-by: Eduardo Habkost <address@hidden>
> Signed-off-by: Peter Xu <address@hidden>
> ---
> qemu-options.hx | 8 ++++++++
> 1 file changed, 8 insertions(+)
>
> diff --git a/qemu-options.hx b/qemu-options.hx
> index 297bd8a..927c51f 100644
> --- a/qemu-options.hx
> +++ b/qemu-options.hx
> @@ -85,6 +85,14 @@ Enables or disables NVDIMM support. The default is off.
> @item s390-squash-mcss=on|off
> Enables or disables squashing subchannels into the default css.
> The default is off.
> address@hidden enforce-config-section=on|off
> +Decides whether we will send the configuration section when doing
> +migration. By default, it is turned on. We can set this to off to
> +explicitly disable it.
[...]
Wait, isn't it off by default?
This seems to imply that "-machine enforce-config-section=on" would have
no effect at all, as the option would be already on by default. This is
not the case.
I suggest rewriting this as:
If set to "on, force migration code to send configuration section even
if the machine-type sets the "migration.send-configuration" property
to "off".
Note: this parameter is obsolete, please use "-global
migration.send-configuration=on|off" instead.
Behavior is undefined if "enforce-config-section" and "-global
migration.send-configuration" are used together.
(Note: we probably should use proper markup (@option/@var/@samp?)
instead of quotes above, to format the option names properly in the
generated documentation.)
--
Eduardo
[Qemu-devel] [PATCH 4/4] doc: update TYPE_MIGRATION documents, Peter Xu, 2017/07/02