The Virtio Over Messages transport is added by this series, so the transport-neutral parts of the specification need to refer to it alongside the existing PCI, MMIO, and Channel I/O transports.
Update the basic device facilities chapter to include Virtio Over Messages in the list of bus-specific transport sections. Extend the VIRTIO_F_ADMIN_VQ text to describe how message-based devices expose administration virtqueues through transport-provided device information.
Update the introduction to describe message-based transports as one of the virtio transport classes.
Signed-off-by: Bertrand Marquis bertrand.marquis@arm.com Signed-off-by: Bill Mills bill.mills@linaro.org --- content.tex | 17 ++++++++++++----- introduction.tex | 2 +- 2 files changed, 13 insertions(+), 6 deletions(-)
diff --git a/content.tex b/content.tex index 79e99a5801b9..0bcbeb50c965 100644 --- a/content.tex +++ b/content.tex @@ -2,7 +2,9 @@ \chapter{Basic Facilities of a Virtio Device}\label{sec:Basic Facilities of a Vi
A virtio device is discovered and identified by a bus-specific method (see the bus specific sections: \ref{sec:Virtio Transport Options / Virtio Over PCI Bus}~\nameref{sec:Virtio Transport Options / Virtio Over PCI Bus}, -\ref{sec:Virtio Transport Options / Virtio Over MMIO}~\nameref{sec:Virtio Transport Options / Virtio Over MMIO} and \ref{sec:Virtio Transport Options / Virtio Over Channel I/O}~\nameref{sec:Virtio Transport Options / Virtio Over Channel I/O}). Each +\ref{sec:Virtio Transport Options / Virtio Over MMIO}~\nameref{sec:Virtio Transport Options / Virtio Over MMIO}, +\ref{sec:Virtio Transport Options / Virtio Over Channel I/O}~\nameref{sec:Virtio Transport Options / Virtio Over Channel I/O} +and \ref{sec:Virtio Transport Options / Virtio Over Messages}~\nameref{sec:Virtio Transport Options / Virtio Over Messages}). Each device consists of the following parts:
\begin{itemize} @@ -933,11 +935,16 @@ \chapter{Reserved Feature Bits}\label{sec:Reserved Feature Bits}
\item[VIRTIO_F_ADMIN_VQ(41)] This feature indicates that the device exposes one or more administration virtqueues. - At the moment this feature is only supported for devices using - \ref{sec:Virtio Transport Options / Virtio Over PCI + Devices using \ref{sec:Virtio Transport Options / Virtio Over PCI Bus}~\nameref{sec:Virtio Transport Options / Virtio Over PCI Bus} - as the transport and is reserved for future use for - devices using other transports (see + expose administration virtqueues using the transport-specific + fields defined by that transport. Devices using + \ref{sec:Virtio Transport Options / Virtio Over Messages}~\nameref{sec:Virtio Transport Options / Virtio Over Messages} + expose administration virtqueues through the device information + reported by that transport. + + For devices using other transports, this feature is reserved for + future use (see \ref{drivernormative:Basic Facilities of a Virtio Device / Feature Bits} and \ref{devicenormative:Basic Facilities of a Virtio Device / Feature Bits} for diff --git a/introduction.tex b/introduction.tex index 635e267cee04..8795cf389477 100644 --- a/introduction.tex +++ b/introduction.tex @@ -20,7 +20,7 @@ \chapter{Introduction} \item[Standard:] Virtio makes no assumptions about the environment in which it operates, beyond supporting the bus to which device is attached. In this specification, virtio - devices are implemented over MMIO, Channel I/O and PCI bus transports + devices are implemented over MMIO, Channel I/O, PCI bus, and message-based transports \footnote{The Linux implementation further separates the virtio transport code from the specific virtio drivers: these drivers are shared between different transports.