[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [PATCH RFC 1/3] rng: move to a file of its own
Will make it easier to edit. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> --- content.tex | 43 +------------------------------------------ virtio-rng.tex | 42 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 43 insertions(+), 42 deletions(-) create mode 100644 virtio-rng.tex diff --git a/content.tex b/content.tex index 7111929..332c257 100644 --- a/content.tex +++ b/content.tex @@ -5540,48 +5540,7 @@ \subsubsection{Legacy Interface: Framing Requirements}\label{sec:Device negotiated VIRTIO_F_ANY_LAYOUT MUST use only a single descriptor for all buffers in the control receiveq and control transmitq. -\section{Entropy Device}\label{sec:Device Types / Entropy Device} - -The virtio entropy device supplies high-quality randomness for -guest use. - -\subsection{Device ID}\label{sec:Device Types / Entropy Device / Device ID} - 4 - -\subsection{Virtqueues}\label{sec:Device Types / Entropy Device / Virtqueues} -\begin{description} -\item[0] requestq -\end{description} - -\subsection{Feature bits}\label{sec:Device Types / Entropy Device / Feature bits} - None currently defined - -\subsection{Device configuration layout}\label{sec:Device Types / Entropy Device / Device configuration layout} - None currently defined. - -\subsection{Device Initialization}\label{sec:Device Types / Entropy Device / Device Initialization} - -\begin{enumerate} -\item The virtqueue is initialized -\end{enumerate} - -\subsection{Device Operation}\label{sec:Device Types / Entropy Device / Device Operation} - -When the driver requires random bytes, it places the descriptor -of one or more buffers in the queue. It will be completely filled -by random data by the device. - -\drivernormative{\subsubsection}{Device Operation}{Device Types / Entropy Device / Device Operation} - -The driver MUST NOT place device-readable buffers into the queue. - -The driver MUST examine the length written by the device to determine -how many random bytes were received. - -\devicenormative{\subsubsection}{Device Operation}{Device Types / Entropy Device / Device Operation} - -The device MUST place one or more random bytes into the buffer, but it -MAY use less than the entire buffer length. +\input{virtio-rng.tex} \section{Traditional Memory Balloon Device}\label{sec:Device Types / Memory Balloon Device} diff --git a/virtio-rng.tex b/virtio-rng.tex new file mode 100644 index 0000000..c26f589 --- /dev/null +++ b/virtio-rng.tex @@ -0,0 +1,42 @@ +\section{Entropy Device}\label{sec:Device Types / Entropy Device} + +The virtio entropy device supplies high-quality randomness for +guest use. + +\subsection{Device ID}\label{sec:Device Types / Entropy Device / Device ID} + 4 + +\subsection{Virtqueues}\label{sec:Device Types / Entropy Device / Virtqueues} +\begin{description} +\item[0] requestq +\end{description} + +\subsection{Feature bits}\label{sec:Device Types / Entropy Device / Feature bits} + None currently defined + +\subsection{Device configuration layout}\label{sec:Device Types / Entropy Device / Device configuration layout} + None currently defined. + +\subsection{Device Initialization}\label{sec:Device Types / Entropy Device / Device Initialization} + +\begin{enumerate} +\item The virtqueue is initialized +\end{enumerate} + +\subsection{Device Operation}\label{sec:Device Types / Entropy Device / Device Operation} + +When the driver requires random bytes, it places the descriptor +of one or more buffers in the queue. It will be completely filled +by random data by the device. + +\drivernormative{\subsubsection}{Device Operation}{Device Types / Entropy Device / Device Operation} + +The driver MUST NOT place device-readable buffers into the queue. + +The driver MUST examine the length written by the device to determine +how many random bytes were received. + +\devicenormative{\subsubsection}{Device Operation}{Device Types / Entropy Device / Device Operation} + +The device MUST place one or more random bytes into the buffer, but it +MAY use less than the entire buffer length. -- MST
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]