All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Michael S. Tsirkin" <mst@redhat.com>
To: Parav Pandit <parav@nvidia.com>
Cc: virtio-dev@lists.oasis-open.org, pasic@linux.ibm.com,
	cohuck@redhat.com, virtio-comment@lists.oasis-open.org,
	shahafs@nvidia.com, Max Gurtovoy <mgurtovoy@nvidia.com>
Subject: [virtio-comment] Re: [PATCH 1/2] transport-pci: Improve config msix vector description
Date: Wed, 19 Apr 2023 03:09:27 -0400	[thread overview]
Message-ID: <20230419030906-mutt-send-email-mst@kernel.org> (raw)
In-Reply-To: <20230419030057-mutt-send-email-mst@kernel.org>

On Wed, Apr 19, 2023 at 03:05:11AM -0400, Michael S. Tsirkin wrote:
> On Tue, Apr 11, 2023 at 10:42:19PM +0300, Parav Pandit wrote:
> > config_msix_vector is the register that holds the MSI-X vector number
> > for receiving configuration change related interrupts.
> > 
> > It is not "for MSI-X".
> > 
> > Hence, replace the confusing text with appropriate one.
> > 
> > Reviewed-by: Max Gurtovoy <mgurtovoy@nvidia.com>
> > Signed-off-by: Parav Pandit <parav@nvidia.com>
> > 
> > ---
> > changelog:
> > v0->v1:
> > - added 'here'
> > - dropped 'receiving'
> > ---
> >  transport-pci.tex | 3 ++-
> >  1 file changed, 2 insertions(+), 1 deletion(-)
> > 
> > diff --git a/transport-pci.tex b/transport-pci.tex
> > index 42be072..cb9fadd 100644
> > --- a/transport-pci.tex
> > +++ b/transport-pci.tex
> > @@ -343,7 +343,8 @@ \subsubsection{Common configuration structure layout}\label{sec:Virtio Transport
> >          Driver Feature Bits selected by \field{driver_feature_select}.
> >  
> >  \item[\field{config_msix_vector}]
> > -        The driver sets the Configuration Vector for MSI-X.
> > +        The driver writes an MSI-X vector number here for Configuration change
> > +        interrupts.
> 
> Hmm I think it's "the vector", not an. And the order of words
> is unusual. We also don't normally use "writes here". Would
> 
> 	Used by the driver to set the MSI-X vector number for Configuration change interrupts.

or even Configuration change notification interrupts

this is what we call them elsewhere

> be equally acceptable?
> 
> 
> >  \item[\field{num_queues}]
> >          The device specifies the maximum number of virtqueues supported here.
> > -- 
> > 2.26.2


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/


WARNING: multiple messages have this Message-ID (diff)
From: "Michael S. Tsirkin" <mst@redhat.com>
To: Parav Pandit <parav@nvidia.com>
Cc: virtio-dev@lists.oasis-open.org, pasic@linux.ibm.com,
	cohuck@redhat.com, virtio-comment@lists.oasis-open.org,
	shahafs@nvidia.com, Max Gurtovoy <mgurtovoy@nvidia.com>
Subject: [virtio-dev] Re: [PATCH 1/2] transport-pci: Improve config msix vector description
Date: Wed, 19 Apr 2023 03:09:27 -0400	[thread overview]
Message-ID: <20230419030906-mutt-send-email-mst@kernel.org> (raw)
In-Reply-To: <20230419030057-mutt-send-email-mst@kernel.org>

On Wed, Apr 19, 2023 at 03:05:11AM -0400, Michael S. Tsirkin wrote:
> On Tue, Apr 11, 2023 at 10:42:19PM +0300, Parav Pandit wrote:
> > config_msix_vector is the register that holds the MSI-X vector number
> > for receiving configuration change related interrupts.
> > 
> > It is not "for MSI-X".
> > 
> > Hence, replace the confusing text with appropriate one.
> > 
> > Reviewed-by: Max Gurtovoy <mgurtovoy@nvidia.com>
> > Signed-off-by: Parav Pandit <parav@nvidia.com>
> > 
> > ---
> > changelog:
> > v0->v1:
> > - added 'here'
> > - dropped 'receiving'
> > ---
> >  transport-pci.tex | 3 ++-
> >  1 file changed, 2 insertions(+), 1 deletion(-)
> > 
> > diff --git a/transport-pci.tex b/transport-pci.tex
> > index 42be072..cb9fadd 100644
> > --- a/transport-pci.tex
> > +++ b/transport-pci.tex
> > @@ -343,7 +343,8 @@ \subsubsection{Common configuration structure layout}\label{sec:Virtio Transport
> >          Driver Feature Bits selected by \field{driver_feature_select}.
> >  
> >  \item[\field{config_msix_vector}]
> > -        The driver sets the Configuration Vector for MSI-X.
> > +        The driver writes an MSI-X vector number here for Configuration change
> > +        interrupts.
> 
> Hmm I think it's "the vector", not an. And the order of words
> is unusual. We also don't normally use "writes here". Would
> 
> 	Used by the driver to set the MSI-X vector number for Configuration change interrupts.

or even Configuration change notification interrupts

this is what we call them elsewhere

> be equally acceptable?
> 
> 
> >  \item[\field{num_queues}]
> >          The device specifies the maximum number of virtqueues supported here.
> > -- 
> > 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


  reply	other threads:[~2023-04-19  7:09 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-04-11 19:42 [virtio-comment] [PATCH 0/2] transport-pci: msix register desc improve Parav Pandit
2023-04-11 19:42 ` [virtio-dev] " Parav Pandit
2023-04-11 19:42 ` [virtio-comment] [PATCH 1/2] transport-pci: Improve config msix vector description Parav Pandit
2023-04-11 19:42   ` [virtio-dev] " Parav Pandit
2023-04-19  7:05   ` [virtio-comment] " Michael S. Tsirkin
2023-04-19  7:05     ` [virtio-dev] " Michael S. Tsirkin
2023-04-19  7:09     ` Michael S. Tsirkin [this message]
2023-04-19  7:09       ` Michael S. Tsirkin
2023-04-19  8:25     ` [virtio-comment] " Zhu, Lingshan
2023-04-19  8:25       ` Zhu, Lingshan
2023-04-19 11:27       ` [virtio-comment] " Michael S. Tsirkin
2023-04-19 11:27         ` Michael S. Tsirkin
2023-04-19 19:02         ` [virtio-comment] " Parav Pandit
2023-04-19 19:02           ` Parav Pandit
2023-04-11 19:42 ` [virtio-comment] [PATCH 2/2] transport-pci: Improve queue msix vector register desc Parav Pandit
2023-04-11 19:42   ` [virtio-dev] " Parav Pandit
2023-04-19  7:08   ` [virtio-comment] " Michael S. Tsirkin
2023-04-19  7:08     ` [virtio-dev] " Michael S. Tsirkin
2023-04-19  7:08     ` [virtio-comment] " Michael S. Tsirkin
2023-04-19  7:08       ` [virtio-dev] " Michael S. Tsirkin
2023-04-19  1:53 ` [virtio-comment] RE: [PATCH 0/2] transport-pci: msix register desc improve Parav Pandit
2023-04-19  1:53   ` [virtio-dev] " Parav Pandit

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20230419030906-mutt-send-email-mst@kernel.org \
    --to=mst@redhat.com \
    --cc=cohuck@redhat.com \
    --cc=mgurtovoy@nvidia.com \
    --cc=parav@nvidia.com \
    --cc=pasic@linux.ibm.com \
    --cc=shahafs@nvidia.com \
    --cc=virtio-comment@lists.oasis-open.org \
    --cc=virtio-dev@lists.oasis-open.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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.