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-comment@lists.oasis-open.org"
	<virtio-comment@lists.oasis-open.org>,
	"cohuck@redhat.com" <cohuck@redhat.com>,
	"david.edmondson@oracle.com" <david.edmondson@oracle.com>,
	"virtio-dev@lists.oasis-open.org"
	<virtio-dev@lists.oasis-open.org>,
	"sburla@marvell.com" <sburla@marvell.com>,
	"jasowang@redhat.com" <jasowang@redhat.com>,
	Yishai Hadas <yishaih@nvidia.com>,
	Maor Gottlieb <maorg@nvidia.com>,
	Shahaf Shuler <shahafs@nvidia.com>
Subject: Re: [virtio-comment] Re: [PATCH v10 4/4] transport-pci: Introduce group legacy group member config region access
Date: Thu, 6 Jul 2023 15:59:17 -0400	[thread overview]
Message-ID: <20230706154426-mutt-send-email-mst@kernel.org> (raw)
In-Reply-To: <PH0PR12MB5481071FC01163C48E4CA674DC2CA@PH0PR12MB5481.namprd12.prod.outlook.com>

On Thu, Jul 06, 2023 at 07:07:42PM +0000, Parav Pandit wrote:
> > From: virtio-comment@lists.oasis-open.org <virtio-comment@lists.oasis-
> > open.org> On Behalf Of Michael S. Tsirkin
> > Sent: Thursday, July 6, 2023 3:01 PM
> 
> > > +\begin{lstlisting}
> > > +struct virtio_pci_legacy_notify_region {
> > > +        u8 owner;  /* When set to 1, notification region is of the
> > > +owner device */
> > 
> > I propose we rename this to flags:
> > 	0x0 - end of list (driver should ignore following values until end of list)
> > 	0x1 - owner
> > 	0x2 - member
> > other values - reserved
> >
> 
> > and prescribe that driver ignores any reserved values.
> > 
> > basically we are following how the virtio capabilities work.
> >
> Looks good. Will change it.
> 
> > > +The group owner device hardwires VF BAR0 to zero in the SR-IOV
> > > +Extended capability.
> > > +
> > > +The group member device does not use PCI BAR0 in all the Virtio PCI
> > > +capabilities listed in section \ref{sec:Virtio Transport Options / Virtio Over
> > PCI Bus / Virtio Structure PCI Capabilities}.
> > 
> > Just drop this last one. How can they use it if there's no VF BAR0?
> >
> Hardwaring BAR0 is in BAR area of the VF.
> But virtio pci capabilities without this can still report bar 0 and virtio capabilities.

How do they do this?

> Ofcourse, it is a broken device.
> But skipping this line imply that "because VF BAR0 is hardwired", this metadata in pci capability must not expose it.
> 
> Why not write it extra thing instead of implying it?
> We already wrote few duplicate things to make reader life easier.

If you really want to go ahead, but prefix it with "In consequence" and
do not start a new paragraph, so reader knows it's not an extra
requirement.

So I started writing it using correct grammar and spec terminology:

	In consequence, non of the group member devices has BAR0, and
	in particular none of the virtio structure capabilities
	of a member device has \field{bar} with the value of 0.


However, this actually is kind of wrong (and so is your text).  Not all
caps have a RO bar value.  virtio_pci_cfg_cap has bar that is RW by
driver.  So if we are going this route we also need to explain that it's
true for all caps except virtio_pci_cfg_cap.  And for virtio_pci_cfg_cap
driver is not allowed to write 0 there.

Frankly too much trouble but if you want to, keep trying.


-- 
MST


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-comment@lists.oasis-open.org"
	<virtio-comment@lists.oasis-open.org>,
	"cohuck@redhat.com" <cohuck@redhat.com>,
	"david.edmondson@oracle.com" <david.edmondson@oracle.com>,
	"virtio-dev@lists.oasis-open.org"
	<virtio-dev@lists.oasis-open.org>,
	"sburla@marvell.com" <sburla@marvell.com>,
	"jasowang@redhat.com" <jasowang@redhat.com>,
	Yishai Hadas <yishaih@nvidia.com>,
	Maor Gottlieb <maorg@nvidia.com>,
	Shahaf Shuler <shahafs@nvidia.com>
Subject: [virtio-dev] Re: [virtio-comment] Re: [PATCH v10 4/4] transport-pci: Introduce group legacy group member config region access
Date: Thu, 6 Jul 2023 15:59:17 -0400	[thread overview]
Message-ID: <20230706154426-mutt-send-email-mst@kernel.org> (raw)
In-Reply-To: <PH0PR12MB5481071FC01163C48E4CA674DC2CA@PH0PR12MB5481.namprd12.prod.outlook.com>

On Thu, Jul 06, 2023 at 07:07:42PM +0000, Parav Pandit wrote:
> > From: virtio-comment@lists.oasis-open.org <virtio-comment@lists.oasis-
> > open.org> On Behalf Of Michael S. Tsirkin
> > Sent: Thursday, July 6, 2023 3:01 PM
> 
> > > +\begin{lstlisting}
> > > +struct virtio_pci_legacy_notify_region {
> > > +        u8 owner;  /* When set to 1, notification region is of the
> > > +owner device */
> > 
> > I propose we rename this to flags:
> > 	0x0 - end of list (driver should ignore following values until end of list)
> > 	0x1 - owner
> > 	0x2 - member
> > other values - reserved
> >
> 
> > and prescribe that driver ignores any reserved values.
> > 
> > basically we are following how the virtio capabilities work.
> >
> Looks good. Will change it.
> 
> > > +The group owner device hardwires VF BAR0 to zero in the SR-IOV
> > > +Extended capability.
> > > +
> > > +The group member device does not use PCI BAR0 in all the Virtio PCI
> > > +capabilities listed in section \ref{sec:Virtio Transport Options / Virtio Over
> > PCI Bus / Virtio Structure PCI Capabilities}.
> > 
> > Just drop this last one. How can they use it if there's no VF BAR0?
> >
> Hardwaring BAR0 is in BAR area of the VF.
> But virtio pci capabilities without this can still report bar 0 and virtio capabilities.

How do they do this?

> Ofcourse, it is a broken device.
> But skipping this line imply that "because VF BAR0 is hardwired", this metadata in pci capability must not expose it.
> 
> Why not write it extra thing instead of implying it?
> We already wrote few duplicate things to make reader life easier.

If you really want to go ahead, but prefix it with "In consequence" and
do not start a new paragraph, so reader knows it's not an extra
requirement.

So I started writing it using correct grammar and spec terminology:

	In consequence, non of the group member devices has BAR0, and
	in particular none of the virtio structure capabilities
	of a member device has \field{bar} with the value of 0.


However, this actually is kind of wrong (and so is your text).  Not all
caps have a RO bar value.  virtio_pci_cfg_cap has bar that is RW by
driver.  So if we are going this route we also need to explain that it's
true for all caps except virtio_pci_cfg_cap.  And for virtio_pci_cfg_cap
driver is not allowed to write 0 there.

Frankly too much trouble but if you want to, keep trying.


-- 
MST


---------------------------------------------------------------------
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-07-06 19:59 UTC|newest]

Thread overview: 78+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-07-06  4:17 [virtio-comment] [PATCH v10 0/4] admin: Access legacy registers using admin commands Parav Pandit
2023-07-06  4:17 ` [virtio-dev] " Parav Pandit
2023-07-06  4:17 ` [virtio-comment] [PATCH v10 1/4] admin: Split opcode table rows with a line Parav Pandit
2023-07-06  4:17   ` [virtio-dev] " Parav Pandit
2023-07-06  4:17 ` [virtio-comment] [PATCH v10 2/4] admin: Fix section numbering Parav Pandit
2023-07-06  4:17   ` [virtio-dev] " Parav Pandit
2023-07-06 13:39   ` [virtio-comment] " Cornelia Huck
2023-07-06 13:39     ` [virtio-dev] " Cornelia Huck
2023-07-06  4:17 ` [virtio-comment] [PATCH v10 3/4] admin: Add group member legacy register access commands Parav Pandit
2023-07-06  4:17   ` [virtio-dev] " Parav Pandit
2023-07-06 16:12   ` [virtio-comment] " Cornelia Huck
2023-07-06 16:12     ` [virtio-dev] " Cornelia Huck
2023-07-06 16:16     ` [virtio-comment] " Parav Pandit
2023-07-06 16:16       ` [virtio-dev] " Parav Pandit
2023-07-06  4:17 ` [virtio-comment] [PATCH v10 4/4] transport-pci: Introduce group legacy group member config region access Parav Pandit
2023-07-06  4:17   ` [virtio-dev] " Parav Pandit
2023-07-06 16:28   ` [virtio-comment] " Cornelia Huck
2023-07-06 16:28     ` [virtio-dev] " Cornelia Huck
2023-07-06 16:33     ` [virtio-comment] " Parav Pandit
2023-07-06 16:33       ` [virtio-dev] " Parav Pandit
2023-07-06 16:42       ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 16:42         ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 16:58         ` [virtio-comment] " Parav Pandit
2023-07-06 16:58           ` [virtio-dev] " Parav Pandit
2023-07-06 17:33           ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 17:33             ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 17:47             ` [virtio-comment] " Parav Pandit
2023-07-06 17:47               ` [virtio-dev] " Parav Pandit
2023-07-06 18:06               ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 18:06                 ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 18:16                 ` [virtio-comment] " Parav Pandit
2023-07-06 18:16                   ` [virtio-dev] " Parav Pandit
2023-07-06 18:48                   ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 18:48                     ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 18:53                     ` [virtio-comment] " Parav Pandit
2023-07-06 18:53                       ` [virtio-dev] " Parav Pandit
2023-07-06 18:56                       ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 18:56                         ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 19:00                         ` [virtio-comment] " Parav Pandit
2023-07-06 19:00                           ` [virtio-dev] " Parav Pandit
2023-07-06 19:42                           ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 19:42                             ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 20:21                             ` [virtio-comment] " Parav Pandit
2023-07-06 20:21                               ` [virtio-dev] " Parav Pandit
2023-07-06 20:28                               ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 20:28                                 ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 20:35                                 ` [virtio-comment] " Parav Pandit
2023-07-06 20:35                                   ` [virtio-dev] " Parav Pandit
2023-07-06 20:41                                   ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 20:41                                     ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 20:43                                     ` [virtio-comment] " Parav Pandit
2023-07-06 20:43                                       ` [virtio-dev] " Parav Pandit
2023-07-07  8:12                                       ` [virtio-comment] " Cornelia Huck
2023-07-07  8:12                                         ` [virtio-dev] " Cornelia Huck
2023-07-07  8:32                                         ` Michael S. Tsirkin
2023-07-07  8:32                                           ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 17:38           ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 17:38             ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 16:47       ` [virtio-comment] " Cornelia Huck
2023-07-06 16:47         ` [virtio-dev] " Cornelia Huck
2023-07-06 16:52         ` [virtio-comment] " Parav Pandit
2023-07-06 16:52           ` [virtio-dev] " Parav Pandit
2023-07-06 16:39     ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 16:39       ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 16:45       ` [virtio-comment] " Parav Pandit
2023-07-06 16:45         ` [virtio-dev] " Parav Pandit
2023-07-06 16:50         ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 16:50           ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 16:54           ` [virtio-comment] " Parav Pandit
2023-07-06 16:54             ` [virtio-dev] " Parav Pandit
2023-07-06 19:00   ` [virtio-comment] " Michael S. Tsirkin
2023-07-06 19:00     ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 19:07     ` [virtio-comment] " Parav Pandit
2023-07-06 19:07       ` [virtio-dev] " Parav Pandit
2023-07-06 19:59       ` Michael S. Tsirkin [this message]
2023-07-06 19:59         ` [virtio-dev] " Michael S. Tsirkin
2023-07-06 20:28         ` Parav Pandit
2023-07-06 20:28           ` [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=20230706154426-mutt-send-email-mst@kernel.org \
    --to=mst@redhat.com \
    --cc=cohuck@redhat.com \
    --cc=david.edmondson@oracle.com \
    --cc=jasowang@redhat.com \
    --cc=maorg@nvidia.com \
    --cc=parav@nvidia.com \
    --cc=sburla@marvell.com \
    --cc=shahafs@nvidia.com \
    --cc=virtio-comment@lists.oasis-open.org \
    --cc=virtio-dev@lists.oasis-open.org \
    --cc=yishaih@nvidia.com \
    /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.