[PATCH v5 1/7] Introduce device group

Each device group has a type. For now, define initial type of device
groups: Type 1 - A virtio PCI SR-IOV physical function (PF) and its PCI
SR-IOV virtual functions (VFs). This group may contain one or more
virtio devices.

Each device within a device group has a unique identifier. This
identifier is the virtio device id (vdev_id).

Reviewed-by: Parav Pandit <>
Signed-off-by: Max Gurtovoy <>
---
 introduction.tex | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/introduction.tex b/introduction.tex
index 4dc7085..4358ab1 100644
--- a/introduction.tex
+++ b/introduction.tex
@@ -155,6 +155,18 @@ \subsection{Transition from earlier specification drafts}\label{sec:Transition f
 sections tagged "Legacy Interface" in the section title.
 These highlight the changes made since the earlier drafts.
 
+\subsection{Device group}\label{sec:Introduction / Terminology / Device group}
+
+A device group includes one or more virtio devices.
+Each virtio device has a unique virtio device id (vdev_id) within a device group. A valid vdev_id is a 64-bit field in the range of
+0x0 - 0xFFFFFFFFFFFFFFF0. Vdev_id 0xFFFFFFFFFFFFFFFF is a value that refers to all devices in a device group and isn't a valid vdev_id.
+
+For now, the supported device groups are:
+\begin{enumerate}
+\item Type 1 - A virtio PCI SR-IOV physical function (PF) and its PCI SR-IOV virtual functions (VFs). For this group type, the PF device has vdev_id that is equal to 0
+and the VF devices have vdev_id's that are equal to their vf_number (according to the PCI SR-IOV specification).
+\end{enumerate}
+
 \section{Structure Specifications}\label{sec:Structure Specifications}
 
 Many device and driver in-memory structure layouts are documented using
-- 
2.21.0