[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [PATCH v1 1/5] virtio: Introduce virtio subsystem
A virtio subsystem may contain one or more virtio devices. All of the devices that make up a virtio subsystem share the same virtio subsystem unique identifier. This identifier is the virtio qualified name (VQN). Each device within a virtio subsystem has a unique identifier. This identifier is the virtio device id (vdev_id). The combination of these identifiers forms a globally unique value identifies a virtio device. Reviewed-by: Parav Pandit <parav@nvidia.com> Signed-off-by: Max Gurtovoy <mgurtovoy@nvidia.com> --- introduction.tex | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/introduction.tex b/introduction.tex index 6d52717..8e6611e 100644 --- a/introduction.tex +++ b/introduction.tex @@ -240,5 +240,23 @@ \section{Constant Specifications} refer to values 1 and 2 of Fld respectively. Further, VIRTIO_FLD_XXX refers to either VIRTIO_FLD_A or VIRTIO_FLD_B. +\section{Definitions}\label{sec:Introduction / Definitions} + +\subsection{virtio device}\label{sec:Introduction / Definitions / virtio device} + +An entity that implements virtio specification. + +\subsection{virtio subsystem}\label{sec:Introduction / Definitions / virtio subsystem} + +A virtio subsystem includes one or more virtio devices. +Each virtio subsystem has a unique virtio qualified name (VQN) that is permanent for the lifetime of the virtio subsystem. +The VQN is a 128-bit UUID. It is RECOMMENDED to use UUIDs as specified by \hyperref[intro:rfc4122]{[RFC4122]}. +Virtio devices within one virtio subsystem share the same VQN. Each virtio device has a unique virtio +device id (vdev_id) within a virtio subsystem. A valid vdev_id is a 64-bit field in the range of +0x0 - 0xFFFFFFFFFFFFFFF0. Vdev_id 0xFFFFFFFFFFFFFFFF is a broadcast value that is used to specify all the +virtio devices in a virtio subsystem and isn't a valid vdev_id. + +The vdev_id value when combined with the VQN forms a globally unique value that identifies the virtio device. + \newpage -- 2.21.0
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]