From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: virtio-return-2850-cohuck=redhat.com@lists.oasis-open.org Sender: List-Post: List-Help: List-Unsubscribe: List-Subscribe: Date: Tue, 30 Jan 2018 11:45:35 +0100 From: Cornelia Huck Message-ID: <20180130114535.2de59238.cohuck@redhat.com> In-Reply-To: <1516665617-30748-7-git-send-email-mst@redhat.com> References: <1515577653-9336-1-git-send-email-mst@redhat.com> <1516665617-30748-7-git-send-email-mst@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: [virtio] [PATCH v7 07/11] split-ring: generalize text To: "Michael S. Tsirkin" Cc: virtio@lists.oasis-open.org, virtio-dev@lists.oasis-open.org List-ID: On Tue, 23 Jan 2018 02:01:06 +0200 "Michael S. Tsirkin" wrote: > Update generic text to talk about available/used buffers, not rings. > Move some split-ring specific text to the correct section. > > Signed-off-by: Michael S. Tsirkin > --- > content.tex | 12 +++++------- > split-ring.tex | 4 ++++ > 2 files changed, 9 insertions(+), 7 deletions(-) > > diff --git a/content.tex b/content.tex > index 5634c7d..0f7c2b9 100644 > --- a/content.tex > +++ b/content.tex > @@ -4652,7 +4650,7 @@ Interface: Device Operation} > When using the legacy interface, the driver SHOULD ignore the > used length values. > \begin{note} > -Historically, devices put the total descriptor length, > +Historically, devices put the total length, > or the total length of device-writable buffers there, > even when only part of the buffers were actually written. This sentence reads a bit weirdly now. Total length of what? > \end{note} > diff --git a/split-ring.tex b/split-ring.tex > index acdee7d..f976e45 100644 > --- a/split-ring.tex > +++ b/split-ring.tex > @@ -296,6 +296,10 @@ referred to this structure as vring_avail, and the constant as > VRING_AVAIL_F_NO_INTERRUPT, but the layout and value were identical. > \end{note} > > +\drivernormative{\subsubsection}{The Virtqueue Available Ring}{Basic Facilities of a Virtio Device / Virtqueues / The Virtqueue Available Ring} > +A driver MUST NOT decrement the available \field{idx} on a virtqueue (ie. > +there is no way to ``unexpose'' buffers). Don't you need to reference that drivernormative section? (It is a bit confusing with all those interim changes; maybe I should only review the end result...) > + > \subsection{Virtqueue Interrupt Suppression}\label{sec:Basic Facilities of a Virtio Device / Virtqueues / Virtqueue Interrupt Suppression} > > If the VIRTIO_F_EVENT_IDX feature bit is not negotiated, --------------------------------------------------------------------- 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