From: Venu Busireddy <venu.busireddy@oracle.com> To: venu.busireddy@oracle.com, "Michael S . Tsirkin" <mst@redhat.com>, Marcel Apfelbaum <marcel@redhat.com> Cc: virtio-dev@lists.oasis-open.org, qemu-devel@nongnu.org Subject: [Qemu-devel] [PATCH v3 virtio 1/1] Add "Group Identifier" to virtio PCI capabilities. Date: Fri, 29 Jun 2018 17:19:07 -0500 [thread overview] Message-ID: <20180629221907.3662-5-venu.busireddy@oracle.com> (raw) In-Reply-To: <20180629221907.3662-1-venu.busireddy@oracle.com> Add VIRTIO_PCI_CAP_GROUP_ID_CFG (Group Identifier) capability to the virtio PCI capabilities to allow for the grouping of devices. Signed-off-by: Venu Busireddy <venu.busireddy@oracle.com> --- content.tex | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/content.tex b/content.tex index be18234..34627e5 100644 --- a/content.tex +++ b/content.tex @@ -599,6 +599,8 @@ The fields are interpreted as follows: #define VIRTIO_PCI_CAP_DEVICE_CFG 4 /* PCI configuration access */ #define VIRTIO_PCI_CAP_PCI_CFG 5 +/* Group Identifier */ +#define VIRTIO_PCI_CAP_GROUP_ID_CFG 6 \end{lstlisting} Any other value is reserved for future use. @@ -997,6 +999,34 @@ address \field{cap.length} bytes within a BAR range specified by some other Virtio Structure PCI Capability of type other than \field{VIRTIO_PCI_CAP_PCI_CFG}. +\subsubsection{Group Identifier capability}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Group Identifier capability} + +The VIRTIO_PCI_CAP_GROUP_ID_CFG capability provides means for grouping +devices together. + +The capability is immediately followed by an identifier of type u64 +as below: + +\begin{lstlisting} +struct virtio_pci_group_id_cap { + struct virtio_pci_cap cap; + u64 group_id; /* Group Identifier */ +}; +\end{lstlisting} + +\devicenormative{\paragraph}{Group Identifier capability}{Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Group Identifier capability} + +The device MAY present the VIRTIO_PCI_CAP_GROUP_ID_CFG capability. + +When this capability is present, the device must set the fields +\field{cap.bar}, \field{cap.offset} and \field{cap.length} to 0, and +set the group_id to a unique identifier. + +\drivernormative{\paragraph}{Group Identifier capability}{Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Group Identifier capability} + +The fields \field{cap.bar}, \field{cap.offset}, \field{cap.length} +and \field{group_id} are read-only for the driver. + \subsubsection{Legacy Interfaces: A Note on PCI Device Layout}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Legacy Interfaces: A Note on PCI Device Layout} Transitional devices MUST present part of configuration
WARNING: multiple messages have this Message-ID (diff)
From: Venu Busireddy <venu.busireddy@oracle.com> To: venu.busireddy@oracle.com, "Michael S . Tsirkin" <mst@redhat.com>, Marcel Apfelbaum <marcel@redhat.com> Cc: virtio-dev@lists.oasis-open.org, qemu-devel@nongnu.org Subject: [virtio-dev] [PATCH v3 virtio 1/1] Add "Group Identifier" to virtio PCI capabilities. Date: Fri, 29 Jun 2018 17:19:07 -0500 [thread overview] Message-ID: <20180629221907.3662-5-venu.busireddy@oracle.com> (raw) In-Reply-To: <20180629221907.3662-1-venu.busireddy@oracle.com> Add VIRTIO_PCI_CAP_GROUP_ID_CFG (Group Identifier) capability to the virtio PCI capabilities to allow for the grouping of devices. Signed-off-by: Venu Busireddy <venu.busireddy@oracle.com> --- content.tex | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/content.tex b/content.tex index be18234..34627e5 100644 --- a/content.tex +++ b/content.tex @@ -599,6 +599,8 @@ The fields are interpreted as follows: #define VIRTIO_PCI_CAP_DEVICE_CFG 4 /* PCI configuration access */ #define VIRTIO_PCI_CAP_PCI_CFG 5 +/* Group Identifier */ +#define VIRTIO_PCI_CAP_GROUP_ID_CFG 6 \end{lstlisting} Any other value is reserved for future use. @@ -997,6 +999,34 @@ address \field{cap.length} bytes within a BAR range specified by some other Virtio Structure PCI Capability of type other than \field{VIRTIO_PCI_CAP_PCI_CFG}. +\subsubsection{Group Identifier capability}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Group Identifier capability} + +The VIRTIO_PCI_CAP_GROUP_ID_CFG capability provides means for grouping +devices together. + +The capability is immediately followed by an identifier of type u64 +as below: + +\begin{lstlisting} +struct virtio_pci_group_id_cap { + struct virtio_pci_cap cap; + u64 group_id; /* Group Identifier */ +}; +\end{lstlisting} + +\devicenormative{\paragraph}{Group Identifier capability}{Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Group Identifier capability} + +The device MAY present the VIRTIO_PCI_CAP_GROUP_ID_CFG capability. + +When this capability is present, the device must set the fields +\field{cap.bar}, \field{cap.offset} and \field{cap.length} to 0, and +set the group_id to a unique identifier. + +\drivernormative{\paragraph}{Group Identifier capability}{Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Group Identifier capability} + +The fields \field{cap.bar}, \field{cap.offset}, \field{cap.length} +and \field{group_id} are read-only for the driver. + \subsubsection{Legacy Interfaces: A Note on PCI Device Layout}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / PCI Device Layout / Legacy Interfaces: A Note on PCI Device Layout} Transitional devices MUST present part of configuration --------------------------------------------------------------------- To unsubscribe, e-mail: virtio-dev-unsubscribe@lists.oasis-open.org For additional commands, e-mail: virtio-dev-help@lists.oasis-open.org
next prev parent reply other threads:[~2018-06-29 22:19 UTC|newest] Thread overview: 106+ messages / expand[flat|nested] mbox.gz Atom feed top 2018-06-29 22:19 [Qemu-devel] [PATCH v3 0/3] Use of unique identifier for pairing virtio and passthrough devices Venu Busireddy 2018-06-29 22:19 ` [virtio-dev] " Venu Busireddy 2018-06-29 22:19 ` [Qemu-devel] [PATCH v3 1/3] Add "Group Identifier" support to virtio devices Venu Busireddy 2018-06-29 22:19 ` [virtio-dev] " Venu Busireddy 2018-06-29 22:19 ` [Qemu-devel] [PATCH v3 2/3] Add "Group Identifier" support to Red Hat PCI bridge Venu Busireddy 2018-06-29 22:19 ` [virtio-dev] " Venu Busireddy 2018-07-03 3:13 ` [Qemu-devel] " Siwei Liu 2018-07-03 3:13 ` Siwei Liu 2018-06-29 22:19 ` [Qemu-devel] [PATCH v3 3/3] Add "Group Identifier" support to Red Hat PCI Express bridge Venu Busireddy 2018-06-29 22:19 ` [virtio-dev] " Venu Busireddy 2018-07-07 12:14 ` [Qemu-devel] " Marcel Apfelbaum 2018-07-07 12:14 ` Marcel Apfelbaum 2018-07-31 15:58 ` [Qemu-devel] " Venu Busireddy 2018-07-31 15:58 ` Venu Busireddy 2018-07-31 16:03 ` [Qemu-devel] " Michael S. Tsirkin 2018-07-31 16:03 ` Michael S. Tsirkin 2018-07-31 19:11 ` [Qemu-devel] " Marcel Apfelbaum 2018-07-31 19:11 ` Marcel Apfelbaum 2018-06-29 22:19 ` Venu Busireddy [this message] 2018-06-29 22:19 ` [virtio-dev] [PATCH v3 virtio 1/1] Add "Group Identifier" to virtio PCI capabilities Venu Busireddy 2018-07-02 16:14 ` [Qemu-devel] [PATCH v3 0/3] Use of unique identifier for pairing virtio and passthrough devices Roman Kagan 2018-07-02 21:14 ` si-wei liu 2018-07-02 21:14 ` [virtio-dev] " si-wei liu 2018-07-03 9:58 ` Roman Kagan 2018-07-03 14:28 ` Venu Busireddy 2018-07-03 14:28 ` [virtio-dev] " Venu Busireddy 2018-07-03 14:52 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-03 14:52 ` [virtio-dev] Re: [Qemu-devel] " Cornelia Huck 2018-07-03 23:31 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-03 23:31 ` [virtio-dev] Re: [Qemu-devel] " Siwei Liu 2018-07-04 12:15 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-04 12:15 ` [virtio-dev] Re: [Qemu-devel] " Cornelia Huck 2018-07-06 0:49 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-06 0:49 ` [virtio-dev] Re: [Qemu-devel] " Siwei Liu 2018-07-06 13:54 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-06 13:54 ` [virtio-dev] Re: [Qemu-devel] " Cornelia Huck 2018-07-06 15:07 ` [Qemu-devel] [virtio-dev] " Michael S. Tsirkin 2018-07-06 15:07 ` [virtio-dev] Re: [Qemu-devel] " Michael S. Tsirkin 2018-07-09 16:20 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-09 16:20 ` [virtio-dev] Re: [Qemu-devel] " Cornelia Huck 2018-07-06 23:37 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-06 23:37 ` [virtio-dev] Re: [Qemu-devel] " Siwei Liu 2018-07-09 16:27 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-09 16:27 ` [virtio-dev] Re: [Qemu-devel] " Cornelia Huck 2018-07-09 13:14 ` [Qemu-devel] [virtio-dev] " Roman Kagan 2018-07-09 13:14 ` [virtio-dev] Re: [Qemu-devel] " Roman Kagan 2018-07-09 16:10 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-09 16:10 ` [virtio-dev] Re: [Qemu-devel] " Cornelia Huck 2018-07-03 15:34 ` Roman Kagan 2018-07-03 22:27 ` si-wei liu 2018-07-03 22:27 ` [virtio-dev] " si-wei liu 2018-07-09 13:00 ` Roman Kagan 2018-07-09 18:35 ` Michael S. Tsirkin 2018-07-09 18:35 ` [virtio-dev] " Michael S. Tsirkin 2018-07-10 1:11 ` si-wei liu 2018-07-10 1:11 ` [virtio-dev] " si-wei liu 2018-07-10 1:54 ` Michael S. Tsirkin 2018-07-10 1:54 ` [virtio-dev] " Michael S. Tsirkin 2018-07-11 0:07 ` Siwei Liu 2018-07-11 0:07 ` [virtio-dev] " Siwei Liu 2018-07-11 0:07 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-11 9:53 ` Re: [Qemu-devel] " Cornelia Huck 2018-07-11 9:53 ` [virtio-dev] " Cornelia Huck 2018-07-11 9:53 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-12 9:37 ` Re: [Qemu-devel] " Siwei Liu 2018-07-12 9:37 ` [virtio-dev] " Siwei Liu 2018-07-12 9:37 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-12 11:31 ` Re: [Qemu-devel] " Cornelia Huck 2018-07-12 11:31 ` [virtio-dev] " Cornelia Huck 2018-07-12 11:31 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-12 20:52 ` Re: [Qemu-devel] " Siwei Liu 2018-07-12 20:52 ` [virtio-dev] " Siwei Liu 2018-07-12 20:52 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-12 21:00 ` Re: [Qemu-devel] " Michael S. Tsirkin 2018-07-12 21:00 ` [virtio-dev] " Michael S. Tsirkin 2018-07-12 21:00 ` [Qemu-devel] [virtio-dev] " Michael S. Tsirkin 2018-07-12 22:19 ` Re: [Qemu-devel] " Siwei Liu 2018-07-12 22:19 ` [virtio-dev] " Siwei Liu 2018-07-12 22:19 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-13 1:20 ` Re: [Qemu-devel] " Samudrala, Sridhar 2018-07-13 1:20 ` [virtio-dev] " Samudrala, Sridhar 2018-07-13 1:20 ` [Qemu-devel] [virtio-dev] " Samudrala, Sridhar 2018-07-13 3:28 ` Re: [Qemu-devel] " Michael S. Tsirkin 2018-07-13 3:28 ` [virtio-dev] " Michael S. Tsirkin 2018-07-13 3:28 ` [Qemu-devel] [virtio-dev] " Michael S. Tsirkin 2018-07-13 9:15 ` Re: [Qemu-devel] " Cornelia Huck 2018-07-13 9:15 ` [virtio-dev] " Cornelia Huck 2018-07-13 9:15 ` [Qemu-devel] [virtio-dev] " Cornelia Huck 2018-07-12 19:18 ` Re: [Qemu-devel] " Michael S. Tsirkin 2018-07-12 19:18 ` [virtio-dev] " Michael S. Tsirkin 2018-07-12 19:18 ` [Qemu-devel] [virtio-dev] " Michael S. Tsirkin 2018-07-10 1:58 ` [Qemu-devel] " Michael S. Tsirkin 2018-07-10 1:58 ` [virtio-dev] " Michael S. Tsirkin 2018-07-10 18:56 ` Siwei Liu 2018-07-10 18:56 ` [virtio-dev] " Siwei Liu 2018-07-10 18:56 ` [Qemu-devel] [virtio-dev] " Siwei Liu 2018-07-10 2:05 ` [Qemu-devel] " Michael S. Tsirkin 2018-07-10 2:05 ` [virtio-dev] " Michael S. Tsirkin 2018-07-04 5:43 ` Michael S. Tsirkin 2018-07-04 5:43 ` [virtio-dev] " Michael S. Tsirkin 2018-07-10 2:11 ` Michael S. Tsirkin 2018-07-10 2:11 ` [virtio-dev] " Michael S. Tsirkin 2018-07-10 14:28 ` [Qemu-devel] " Venu Busireddy 2018-07-10 14:28 ` [virtio-dev] " Venu Busireddy 2018-07-12 21:01 ` [Qemu-devel] " Michael S. Tsirkin 2018-07-12 21:01 ` [virtio-dev] " Michael S. Tsirkin
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=20180629221907.3662-5-venu.busireddy@oracle.com \ --to=venu.busireddy@oracle.com \ --cc=marcel@redhat.com \ --cc=mst@redhat.com \ --cc=qemu-devel@nongnu.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: linkBe 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.