RE: [virtio-comment] Re: [virtio-dev] [PATCH v8 1/8] content: Add vq number text

[Parav Pandit <parav@nvidia.com>]

> From: virtio-comment@lists.oasis-open.org <virtio-comment@lists.oasis-
> open.org> On Behalf Of David Edmondson
> 
> Parav Pandit <parav@nvidia.com> writes:
> 
> > Introduce vq number and its range so that subsequent patches can refer
> > to it.
> >
> > Fixes: https://github.com/oasis-tcs/virtio-spec/issues/163
> > Signed-off-by: Parav Pandit <parav@nvidia.com>
> > ---
> > changelog:
> > v5->v6:
> > - moved description close to introduction, it was in middle of
> >   queue data transfer description
> > v2->v3:
> > - new patch
> > ---
> >  content.tex | 3 +++
> >  1 file changed, 3 insertions(+)
> >
> > diff --git a/content.tex b/content.tex index cff548a..5171c12 100644
> > --- a/content.tex
> > +++ b/content.tex
> > @@ -298,6 +298,9 @@ \section{Virtqueues}\label{sec:Basic Facilities of
> > a Virtio Device / Virtqueues}  virtqueues\footnote{For example, the
> > simplest network device has one virtqueue for  transmit and one for receive.}.
> >
> > +Each virtqueue is identified by a vq number or also referred to as a
> > +virtqueue number; vq number range is from 0 to 65535.
> > +
> 
> It would be nice to use the unabbreviated version first, and we could also
> include "vqn", as it's in use during discussions:
> 
I prefer vq number first, as reader can pick that first when using somewhere else.

>   Each virtqueue is identified by a virtqueue number, also referred to
>   as a vq number or vqn. The range of virtqueue numbers is 0 to 65535
>   inclusive.
"inclusive" is important to add.
Will add to v9.

> 
> >  Driver makes requests available to device by adding  an available
> > buffer to the queue, i.e., adding a buffer  describing the request to
> > a virtqueue, and optionally triggering
> > --
> > 2.26.2
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: virtio-dev-unsubscribe@lists.oasis-open.org
> > For additional commands, e-mail: virtio-dev-help@lists.oasis-open.org
> --
> The sound of a barking dog on a loop, a plane rises in the crystal blue.
> 
> This publicly archived list offers a means to provide input to the OASIS Virtual
> I/O Device (VIRTIO) TC.
> 
> In order to verify user consent to the Feedback License terms and to minimize
> spam in the list archive, subscription is required before posting.
> 
> Subscribe: virtio-comment-subscribe@lists.oasis-open.org
> Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
> List help: virtio-comment-help@lists.oasis-open.org
> List archive: https://lists.oasis-open.org/archives/virtio-comment/
> Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
> List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
> Committee: https://www.oasis-open.org/committees/virtio/
> Join OASIS: https://www.oasis-open.org/join/