* [virtio] [PATCH v2] conformance: clarify transitional/non-transitional
@ 2019-03-12 16:01 Michael S. Tsirkin
2019-03-12 16:06 ` Cornelia Huck
2019-03-13 1:47 ` [virtio] " Michael S. Tsirkin
0 siblings, 2 replies; 5+ messages in thread
From: Michael S. Tsirkin @ 2019-03-12 16:01 UTC (permalink / raw)
To: virtio, virtio-dev
We already have a specification for conformance targets for
non-transitional devices.
Just add another clause that transitional devices satisfy.
VIRTIO-167
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
---
conformance.tex | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/conformance.tex b/conformance.tex
index 6df113b..8b69e39 100644
--- a/conformance.tex
+++ b/conformance.tex
@@ -341,13 +341,9 @@ A conformant implementation MUST be either transitional or
non-transitional, see \ref{intro:Legacy
Interface: Terminology}.
-A non-transitional implementation conforms to this specification
-if it satisfies all of the MUST or REQUIRED level requirements
-defined above.
-
-An implementation MAY choose to implement OPTIONAL support for the
+A transitional implementation MUST implement support for the
legacy interface, including support for legacy drivers
-or devices, by additionally conforming to all of the MUST or
+or devices, by conforming to all of the MUST or
REQUIRED level requirements for the legacy interface
for the transitional devices and drivers.
--
MST
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [virtio] [PATCH v2] conformance: clarify transitional/non-transitional
2019-03-12 16:01 [virtio] [PATCH v2] conformance: clarify transitional/non-transitional Michael S. Tsirkin
@ 2019-03-12 16:06 ` Cornelia Huck
2019-03-12 16:11 ` Michael S. Tsirkin
2019-03-13 1:47 ` [virtio] " Michael S. Tsirkin
1 sibling, 1 reply; 5+ messages in thread
From: Cornelia Huck @ 2019-03-12 16:06 UTC (permalink / raw)
To: Michael S. Tsirkin; +Cc: virtio, virtio-dev
On Tue, 12 Mar 2019 12:01:41 -0400
"Michael S. Tsirkin" <mst@redhat.com> wrote:
> We already have a specification for conformance targets for
> non-transitional devices.
> Just add another clause that transitional devices satisfy.
>
> VIRTIO-167
>
> Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
> ---
> conformance.tex | 8 ++------
> 1 file changed, 2 insertions(+), 6 deletions(-)
>
> diff --git a/conformance.tex b/conformance.tex
> index 6df113b..8b69e39 100644
> --- a/conformance.tex
> +++ b/conformance.tex
> @@ -341,13 +341,9 @@ A conformant implementation MUST be either transitional or
> non-transitional, see \ref{intro:Legacy
> Interface: Terminology}.
>
> -A non-transitional implementation conforms to this specification
> -if it satisfies all of the MUST or REQUIRED level requirements
> -defined above.
> -
> -An implementation MAY choose to implement OPTIONAL support for the
> +A transitional implementation MUST implement support for the
> legacy interface, including support for legacy drivers
> -or devices, by additionally conforming to all of the MUST or
> +or devices, by conforming to all of the MUST or
> REQUIRED level requirements for the legacy interface
> for the transitional devices and drivers.
>
Wouldn't that be v4?
I'm currently very confused by the avalanche of patches and which issues
they fix...
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [virtio] [PATCH v2] conformance: clarify transitional/non-transitional
2019-03-12 16:06 ` Cornelia Huck
@ 2019-03-12 16:11 ` Michael S. Tsirkin
0 siblings, 0 replies; 5+ messages in thread
From: Michael S. Tsirkin @ 2019-03-12 16:11 UTC (permalink / raw)
To: Cornelia Huck; +Cc: virtio, virtio-dev
On Tue, Mar 12, 2019 at 05:06:31PM +0100, Cornelia Huck wrote:
> On Tue, 12 Mar 2019 12:01:41 -0400
> "Michael S. Tsirkin" <mst@redhat.com> wrote:
>
> > We already have a specification for conformance targets for
> > non-transitional devices.
> > Just add another clause that transitional devices satisfy.
> >
> > VIRTIO-167
> >
> > Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
> > ---
> > conformance.tex | 8 ++------
> > 1 file changed, 2 insertions(+), 6 deletions(-)
> >
> > diff --git a/conformance.tex b/conformance.tex
> > index 6df113b..8b69e39 100644
> > --- a/conformance.tex
> > +++ b/conformance.tex
> > @@ -341,13 +341,9 @@ A conformant implementation MUST be either transitional or
> > non-transitional, see \ref{intro:Legacy
> > Interface: Terminology}.
> >
> > -A non-transitional implementation conforms to this specification
> > -if it satisfies all of the MUST or REQUIRED level requirements
> > -defined above.
> > -
> > -An implementation MAY choose to implement OPTIONAL support for the
> > +A transitional implementation MUST implement support for the
> > legacy interface, including support for legacy drivers
> > -or devices, by additionally conforming to all of the MUST or
> > +or devices, by conforming to all of the MUST or
> > REQUIRED level requirements for the legacy interface
> > for the transitional devices and drivers.
> >
>
> Wouldn't that be v4?
Donnu :(
> I'm currently very confused by the avalanche of patches and which issues
> they fix...
It could be easiest to follow links under ballots.
Each ballot is linked to the patch.
--
MST
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
^ permalink raw reply [flat|nested] 5+ messages in thread
* [virtio] Re: [PATCH v2] conformance: clarify transitional/non-transitional
2019-03-12 16:01 [virtio] [PATCH v2] conformance: clarify transitional/non-transitional Michael S. Tsirkin
2019-03-12 16:06 ` Cornelia Huck
@ 2019-03-13 1:47 ` Michael S. Tsirkin
1 sibling, 0 replies; 5+ messages in thread
From: Michael S. Tsirkin @ 2019-03-13 1:47 UTC (permalink / raw)
To: virtio, virtio-dev
On Tue, Mar 12, 2019 at 12:01:41PM -0400, Michael S. Tsirkin wrote:
> We already have a specification for conformance targets for
> non-transitional devices.
> Just add another clause that transitional devices satisfy.
>
> VIRTIO-167
>
> Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
Correction: this should be v4.
Will repost with the correct version #.
> ---
> conformance.tex | 8 ++------
> 1 file changed, 2 insertions(+), 6 deletions(-)
>
> diff --git a/conformance.tex b/conformance.tex
> index 6df113b..8b69e39 100644
> --- a/conformance.tex
> +++ b/conformance.tex
> @@ -341,13 +341,9 @@ A conformant implementation MUST be either transitional or
> non-transitional, see \ref{intro:Legacy
> Interface: Terminology}.
>
> -A non-transitional implementation conforms to this specification
> -if it satisfies all of the MUST or REQUIRED level requirements
> -defined above.
> -
> -An implementation MAY choose to implement OPTIONAL support for the
> +A transitional implementation MUST implement support for the
> legacy interface, including support for legacy drivers
> -or devices, by additionally conforming to all of the MUST or
> +or devices, by conforming to all of the MUST or
> REQUIRED level requirements for the legacy interface
> for the transitional devices and drivers.
>
> --
> MST
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
^ permalink raw reply [flat|nested] 5+ messages in thread
* [virtio] [PATCH v2] conformance: clarify transitional/non-transitional
@ 2019-03-11 15:10 Michael S. Tsirkin
0 siblings, 0 replies; 5+ messages in thread
From: Michael S. Tsirkin @ 2019-03-11 15:10 UTC (permalink / raw)
To: virtio, virtio-dev
Clarify that:
- non-transitional just satisfy 3 main clauses
- transitional also has a legacy interface:
however note that it's not an optional component
*for transitional devices* so MAY is inappropriate
- legacy device descriptions are non-normative.
In fact virtio 0.9 is non-normative as a whole
and always was by design: it was early days and
spec evolved to document bugs in implementations.
VIRTIO-167
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
---
Changes from v1:
Accept all changes proposed by Cornelia Huck <cohuck@redhat.com>
conformance.tex | 26 ++++++++++++++++++--------
1 file changed, 18 insertions(+), 8 deletions(-)
diff --git a/conformance.tex b/conformance.tex
index 1577c0c..518b9c7 100644
--- a/conformance.tex
+++ b/conformance.tex
@@ -344,16 +344,26 @@ Interface: Terminology}.
A non-transitional implementation conforms to this specification
if it satisfies all of the MUST or REQUIRED level requirements
-defined above.
+defined in section \ref{sec:Conformance / Conformance Targets} above.
-An implementation MAY choose to implement OPTIONAL support for the
-legacy interface, including support for legacy drivers
-or devices, by additionally conforming to all of the MUST or
-REQUIRED level requirements for the legacy interface
-for the transitional devices and drivers.
+A transitional implementation conforms to this specification
+if it satisfies all of the MUST or REQUIRED level requirements
+defined in section \ref{sec:Conformance / Conformance Targets} above
+and additionally implements the legacy interface
+for the transitional devices and drivers, described in
+\hyperref[intro:Virtio PCI Draft]{[Virtio PCI Draft]}.
-The requirements for the legacy interface for transitional implementations
-are located in sections named ``Legacy Interface'' listed below:
+\begin{note}
+No normative specification for the legacy interface exists,
+instead device and driver's ability to interoperate with
+the existing body of installed devices and drivers is a quality
+of implementation issue.
+\begin{note}
+
+To facilitate creating transitional implementations, as well as
+assist in converting legacy interfaces to conforming ones,
+the requirements for the legacy interface for transitional implementations
+are located in non-normative sections named ``Legacy Interface'' listed below:
\begin{itemize}
\item Section \ref{sec:Basic Facilities of a Virtio Device /
Feature Bits / Legacy Interface: A Note on Feature Bits}
--
MST
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
^ permalink raw reply related [flat|nested] 5+ messages in thread
end of thread, other threads:[~2019-03-13 1:47 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-03-12 16:01 [virtio] [PATCH v2] conformance: clarify transitional/non-transitional Michael S. Tsirkin
2019-03-12 16:06 ` Cornelia Huck
2019-03-12 16:11 ` Michael S. Tsirkin
2019-03-13 1:47 ` [virtio] " Michael S. Tsirkin
-- strict thread matches above, loose matches on Subject: below --
2019-03-11 15:10 [virtio] " Michael S. Tsirkin
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.