* [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types
@ 2017-07-25 14:10 Daniel P. Berrange
2017-07-25 17:46 ` John Snow
0 siblings, 1 reply; 5+ messages in thread
From: Daniel P. Berrange @ 2017-07-25 14:10 UTC (permalink / raw)
To: qemu-devel; +Cc: Paolo Bonzini, Daniel P. Berrange
The -machine docs did not explain what the versioned machine
types are for, nor that they'll be maintained across
releases.
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
---
qemu-options.hx | 15 ++++++++++++++-
1 file changed, 14 insertions(+), 1 deletion(-)
diff --git a/qemu-options.hx b/qemu-options.hx
index 746b5fa75d..9f6e2adfff 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -49,7 +49,20 @@ STEXI
@item -machine [type=]@var{name}[,prop=@var{value}[,...]]
@findex -machine
Select the emulated machine by @var{name}. Use @code{-machine help} to list
-available machines. Supported machine properties are:
+available machines.
+
+For architectures which aim to support live migration compatibility
+across releases, each release will introduce a new versioned machine
+type. For example, the 2.8.0 release introduced machine types
+``pc-i440fx-2.8'' and ``pc-q35-2.8'' for the x86_64/i686 architectures.
+
+To allow live migration of guests from QEMU version 2.8.0, to QEMU
+version 2.9.0, the 2.9.0 version must support the ``pc-i440fx-2.8''
+and ``pc-q35-2.8'' machines too. To allow users live migrating VMs
+to skip multiple intermediate releases when upgrading, new releases
+of QEMU will support machine types from many previous versions.
+
+Supported machine properties are:
@table @option
@item accel=@var{accels1}[:@var{accels2}[:...]]
This is used to enable an accelerator. Depending on the target architecture,
--
2.13.3
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types
2017-07-25 14:10 [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types Daniel P. Berrange
@ 2017-07-25 17:46 ` John Snow
2017-07-25 17:49 ` Paolo Bonzini
2017-07-26 8:07 ` Daniel P. Berrange
0 siblings, 2 replies; 5+ messages in thread
From: John Snow @ 2017-07-25 17:46 UTC (permalink / raw)
To: Daniel P. Berrange, qemu-devel; +Cc: Paolo Bonzini
On 07/25/2017 10:10 AM, Daniel P. Berrange wrote:
> The -machine docs did not explain what the versioned machine
> types are for, nor that they'll be maintained across
> releases.
>
> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
> ---
> qemu-options.hx | 15 ++++++++++++++-
> 1 file changed, 14 insertions(+), 1 deletion(-)
>
> diff --git a/qemu-options.hx b/qemu-options.hx
> index 746b5fa75d..9f6e2adfff 100644
> --- a/qemu-options.hx
> +++ b/qemu-options.hx
> @@ -49,7 +49,20 @@ STEXI
> @item -machine [type=]@var{name}[,prop=@var{value}[,...]]
> @findex -machine
> Select the emulated machine by @var{name}. Use @code{-machine help} to list
> -available machines. Supported machine properties are:
> +available machines.
> +
> +For architectures which aim to support live migration compatibility
> +across releases, each release will introduce a new versioned machine
> +type. For example, the 2.8.0 release introduced machine types
> +``pc-i440fx-2.8'' and ``pc-q35-2.8'' for the x86_64/i686 architectures.
> +
> +To allow live migration of guests from QEMU version 2.8.0, to QEMU
> +version 2.9.0, the 2.9.0 version must support the ``pc-i440fx-2.8''
> +and ``pc-q35-2.8'' machines too. To allow users live migrating VMs
> +to skip multiple intermediate releases when upgrading, new releases
> +of QEMU will support machine types from many previous versions.
> +
> +Supported machine properties are:
> @table @option
> @item accel=@var{accels1}[:@var{accels2}[:...]]
> This is used to enable an accelerator. Depending on the target architecture,
>
Seems like an improvement to me, but do we have any formal policy on how
long we support said machine types? The new wording prompts that question.
Reviewed-by: John Snow <jsnow@redhat.com>
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types
2017-07-25 17:46 ` John Snow
@ 2017-07-25 17:49 ` Paolo Bonzini
2017-07-26 8:07 ` Daniel P. Berrange
1 sibling, 0 replies; 5+ messages in thread
From: Paolo Bonzini @ 2017-07-25 17:49 UTC (permalink / raw)
To: John Snow; +Cc: Daniel P. Berrange, qemu-devel
>
> On 07/25/2017 10:10 AM, Daniel P. Berrange wrote:
> > The -machine docs did not explain what the versioned machine
> > types are for, nor that they'll be maintained across
> > releases.
> >
> > Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
> > ---
> > qemu-options.hx | 15 ++++++++++++++-
> > 1 file changed, 14 insertions(+), 1 deletion(-)
> >
> > diff --git a/qemu-options.hx b/qemu-options.hx
> > index 746b5fa75d..9f6e2adfff 100644
> > --- a/qemu-options.hx
> > +++ b/qemu-options.hx
> > @@ -49,7 +49,20 @@ STEXI
> > @item -machine [type=]@var{name}[,prop=@var{value}[,...]]
> > @findex -machine
> > Select the emulated machine by @var{name}. Use @code{-machine help} to
> > list
> > -available machines. Supported machine properties are:
> > +available machines.
> > +
> > +For architectures which aim to support live migration compatibility
> > +across releases, each release will introduce a new versioned machine
> > +type. For example, the 2.8.0 release introduced machine types
> > +``pc-i440fx-2.8'' and ``pc-q35-2.8'' for the x86_64/i686 architectures.
>
> Seems like an improvement to me, but do we have any formal policy on how
> long we support said machine types? The new wording prompts that question.
Forever, and ever...
Paolo
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types
2017-07-25 17:46 ` John Snow
2017-07-25 17:49 ` Paolo Bonzini
@ 2017-07-26 8:07 ` Daniel P. Berrange
2017-07-26 18:50 ` John Snow
1 sibling, 1 reply; 5+ messages in thread
From: Daniel P. Berrange @ 2017-07-26 8:07 UTC (permalink / raw)
To: John Snow; +Cc: qemu-devel, Paolo Bonzini
On Tue, Jul 25, 2017 at 01:46:23PM -0400, John Snow wrote:
>
>
> On 07/25/2017 10:10 AM, Daniel P. Berrange wrote:
> > The -machine docs did not explain what the versioned machine
> > types are for, nor that they'll be maintained across
> > releases.
> >
> > Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
> > ---
> > qemu-options.hx | 15 ++++++++++++++-
> > 1 file changed, 14 insertions(+), 1 deletion(-)
> >
> > diff --git a/qemu-options.hx b/qemu-options.hx
> > index 746b5fa75d..9f6e2adfff 100644
> > --- a/qemu-options.hx
> > +++ b/qemu-options.hx
> > @@ -49,7 +49,20 @@ STEXI
> > @item -machine [type=]@var{name}[,prop=@var{value}[,...]]
> > @findex -machine
> > Select the emulated machine by @var{name}. Use @code{-machine help} to list
> > -available machines. Supported machine properties are:
> > +available machines.
> > +
> > +For architectures which aim to support live migration compatibility
> > +across releases, each release will introduce a new versioned machine
> > +type. For example, the 2.8.0 release introduced machine types
> > +``pc-i440fx-2.8'' and ``pc-q35-2.8'' for the x86_64/i686 architectures.
> > +
> > +To allow live migration of guests from QEMU version 2.8.0, to QEMU
> > +version 2.9.0, the 2.9.0 version must support the ``pc-i440fx-2.8''
> > +and ``pc-q35-2.8'' machines too. To allow users live migrating VMs
> > +to skip multiple intermediate releases when upgrading, new releases
> > +of QEMU will support machine types from many previous versions.
> > +
> > +Supported machine properties are:
> > @table @option
> > @item accel=@var{accels1}[:@var{accels2}[:...]]
> > This is used to enable an accelerator. Depending on the target architecture,
> >
>
> Seems like an improvement to me, but do we have any formal policy on how
> long we support said machine types? The new wording prompts that question.
I wasn't going to mention that in this patch, to avoid delay on getting it
merged. I was going to send a further patch that makes it explicit that we
will never delete machine types for as long as any active QEMU contributor
has need for them in downstream version they maintain
> Reviewed-by: John Snow <jsnow@redhat.com>
Regards,
Daniel
--
|: https://berrange.com -o- https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org -o- https://fstop138.berrange.com :|
|: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types
2017-07-26 8:07 ` Daniel P. Berrange
@ 2017-07-26 18:50 ` John Snow
0 siblings, 0 replies; 5+ messages in thread
From: John Snow @ 2017-07-26 18:50 UTC (permalink / raw)
To: Daniel P. Berrange; +Cc: qemu-devel, Paolo Bonzini
On 07/26/2017 04:07 AM, Daniel P. Berrange wrote:
> On Tue, Jul 25, 2017 at 01:46:23PM -0400, John Snow wrote:
>>
>>
>> On 07/25/2017 10:10 AM, Daniel P. Berrange wrote:
>>> The -machine docs did not explain what the versioned machine
>>> types are for, nor that they'll be maintained across
>>> releases.
>>>
>>> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
>>> ---
>>> qemu-options.hx | 15 ++++++++++++++-
>>> 1 file changed, 14 insertions(+), 1 deletion(-)
>>>
>>> diff --git a/qemu-options.hx b/qemu-options.hx
>>> index 746b5fa75d..9f6e2adfff 100644
>>> --- a/qemu-options.hx
>>> +++ b/qemu-options.hx
>>> @@ -49,7 +49,20 @@ STEXI
>>> @item -machine [type=]@var{name}[,prop=@var{value}[,...]]
>>> @findex -machine
>>> Select the emulated machine by @var{name}. Use @code{-machine help} to list
>>> -available machines. Supported machine properties are:
>>> +available machines.
>>> +
>>> +For architectures which aim to support live migration compatibility
>>> +across releases, each release will introduce a new versioned machine
>>> +type. For example, the 2.8.0 release introduced machine types
>>> +``pc-i440fx-2.8'' and ``pc-q35-2.8'' for the x86_64/i686 architectures.
>>> +
>>> +To allow live migration of guests from QEMU version 2.8.0, to QEMU
>>> +version 2.9.0, the 2.9.0 version must support the ``pc-i440fx-2.8''
>>> +and ``pc-q35-2.8'' machines too. To allow users live migrating VMs
>>> +to skip multiple intermediate releases when upgrading, new releases
>>> +of QEMU will support machine types from many previous versions.
>>> +
>>> +Supported machine properties are:
>>> @table @option
>>> @item accel=@var{accels1}[:@var{accels2}[:...]]
>>> This is used to enable an accelerator. Depending on the target architecture,
>>>
>>
>> Seems like an improvement to me, but do we have any formal policy on how
>> long we support said machine types? The new wording prompts that question.
>
> I wasn't going to mention that in this patch, to avoid delay on getting it
> merged. I was going to send a further patch that makes it explicit that we
> will never delete machine types for as long as any active QEMU contributor
> has need for them in downstream version they maintain
>
>> Reviewed-by: John Snow <jsnow@redhat.com>
>
> Regards,
> Daniel
>
OK, just asking. I agree we don't need to delay this patch if you want
it in for 2.10, which is a worthwhile and good thing.
Thanks!
--js
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2017-07-26 18:50 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-07-25 14:10 [Qemu-devel] [PATCH] qemu-options: document existance of versioned machine types Daniel P. Berrange
2017-07-25 17:46 ` John Snow
2017-07-25 17:49 ` Paolo Bonzini
2017-07-26 8:07 ` Daniel P. Berrange
2017-07-26 18:50 ` John Snow
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.