From 159a2f57e8f275ad93fed65d0441f2da924b5ea8 Mon Sep 17 00:00:00 2001 From: rusty Date: Wed, 26 Feb 2014 03:18:51 +0000 Subject: Feedback: use proper list in introduction (VIRTIO-82) Also avoid extra spacing before footnote markers. Reported-by: Patrick Durusau Signed-off-by: Rusty Russell git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@260 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652 --- introduction.tex | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/introduction.tex b/introduction.tex index ba57419..146042d 100644 --- a/introduction.tex +++ b/introduction.tex @@ -2,22 +2,22 @@ \input{abstract.tex} - Straightforward: Virtio devices use normal bus mechanisms of +\begin{description} +\item[Straightforward:] Virtio devices use normal bus mechanisms of interrupts and DMA which should be familiar to any device driver author. There is no exotic page-flipping or COW mechanism: it's just - a normal device. -\footnote{This lack of page-sharing implies that the implementation of the + a normal device.\footnote{This lack of page-sharing implies that the implementation of the device (e.g. the hypervisor or host) needs full access to the guest memory. Communication with untrusted parties (i.e. inter-guest communication) requires copying. } - Efficient: Virtio devices consist of rings of descriptors +\item[Efficient:] Virtio devices consist of rings of descriptors for both input and output, which are neatly laid out to avoid cache effects from both driver and device writing to the same cache lines. - Standard: Virtio makes no assumptions about the environment in which +\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 @@ -27,11 +27,12 @@ between different transports. }, earlier drafts have been implemented on other buses not included here. - Extensible: Virtio devices contain feature bits which are +\item[Extensible:] Virtio devices contain feature bits which are acknowledged by the guest operating system during device setup. This allows forwards and backwards compatibility: the device offers all the features it knows about, and the driver acknowledges those it understands and wishes to use. +\end{description} \section{Terminology}\label{Terminology} -- cgit v1.2.3