[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [PATCH 5/6] VIRTIO-63: Make sure examples are marked clearly.
Signed-off-by: Rusty Russell <rusty@au1.ibm.com> --- content.tex | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/content.tex b/content.tex index f3899b6..a11525b 100644 --- a/content.tex +++ b/content.tex @@ -212,8 +212,8 @@ result. The mechanism for bulk data transport on virtio devices is pretentiously called a virtqueue. Each device can have zero or more -virtqueues: for example, the simplest network device has one for -transmit and one for receive. Each queue has a 16-bit queue size +virtqueues\footnote{For example, the simplest network device has one for +transmit and one for receive}. Each queue has a 16-bit queue size parameter, which sets the number of entries and implies the total size of the queue. @@ -250,8 +250,8 @@ The Size column gives the total number of bytes for each part of the virtqueue. Queue Size corresponds to the maximum number of buffers in the -virtqueue. For example, if Queue Size is 4 then at most 4 buffers -can be queued at any given time. Queue Size value is always a +virtqueue.\footnote{For example, if Queue Size is 4 then at most 4 buffers +can be queued at any given time.} Queue Size value is always a power of 2. The maximum Queue Size value is 32768. This value is specified in a bus-specific way. @@ -712,13 +712,16 @@ And Device Operation / Device Initialization / Set DRIVER-OK}. \section{Device Operation}\label{sec:General Initialization And Device Operation / Device Operation} There are two parts to device operation: supplying new buffers to -the device, and processing used buffers from the device. As an +the device, and processing used buffers from the device. + +\begin{note} As an example, the simplest virtio network device has two virtqueues: the transmit virtqueue and the receive virtqueue. The driver adds outgoing (device-readable) packets to the transmit virtqueue, and then frees them after they are used. Similarly, incoming (device-writable) buffers are added to the receive virtqueue, and processed after they are used. +\end{note} \subsection{Supplying Buffers to The Device}\label{sec:General Initialization And Device Operation / Device Operation / Supplying Buffers to The Device} @@ -1621,7 +1624,7 @@ or report device failure. \paragraph{Virtqueue Configuration}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / PCI-specific Initialization And Device Operation / Device Initialization / Virtqueue Configuration} As a device can have zero or more virtqueues for bulk data -transport (for example, the simplest network device has two), the driver +transport,\footnote{For example, the simplest network device has two} the driver needs to configure them as part of the device-specific configuration. @@ -4809,7 +4812,7 @@ contents of \field{event}. The following events are defined: \end{lstlisting} By sending this event, the device signals that the configuration parameters - (for example the capacity) of a logical unit have changed. + \footnote{for example the capacity} of a logical unit have changed. \field{event} is set to VIRTIO_SCSI_T_PARAM_CHANGE. \field{lun} addresses a logical unit in the SCSI host. -- 1.8.3.2
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]