[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [virtio-dev] [PATCH 13/14] conformance: document two types of devices
"Michael S. Tsirkin" <mst@redhat.com> writes: > document that there are two conformance levels This needs merging with my rewritten conformance text, since I reworked it all. The introductory part looks good, it's the specific requirements which are now separated into driver & device, then per transport, then per-type. The most work was separating all the SHALL and MUST requirements into their own subsections, for easy reference. Perhaps that'll be easier for the legacy sections since there's less explanation. Perhaps we don't need to go that far, or we can clean them up later. Then I referred to device requirements (core requirements + one of the transport requirements + one of the device requirements), and similar for driver requirements. > --- > conformance.tex | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++--- > 1 file changed, 55 insertions(+), 3 deletions(-) > > diff --git a/conformance.tex b/conformance.tex > index 0e8b321..1577bdb 100644 > --- a/conformance.tex > +++ b/conformance.tex > @@ -3,6 +3,58 @@ > %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% > \chapter{Conformance} > > -An implementation conforms to this specification if it satisfies > -all of the MUST or REQUIRED level requirements defined within > -this specification. > +A conformant implementation MUST be either transitional or > +non-transitional, see \ref{sec:Basic Facilities of a Virtio > +Device / Feature Bits / Legacy Interface: A Note on transitions > +from earlier drafts}. > + > +A non-transitional implementation conforms to this specification > +if it satisfies all of the MUST or REQUIRED level requirements > +defined within this specification. > + > +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. BTW, I think we should get rid of REQUIRED and OPTIONAL in the few places we use them, sticking with MUST and MAY. But that's an easy patch later. Cheers, Rusty.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]