aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHalil Pasic <pasic@linux.ibm.com>2018-06-25 14:21:32 +0200
committerMichael S. Tsirkin <mst@redhat.com>2018-10-19 17:29:28 -0400
commita2e22e211817c24be1ffaba0ea04bf7f7e893a50 (patch)
tree3c27b5f309b2bec76f839ce57a48630cdca4a2c3
parent0ec888d8c4572db97ce2fb3f47ba5abd9c0681a8 (diff)
downloadvirtio-text-a2e22e211817c24be1ffaba0ea04bf7f7e893a50.tar.gz
notifications: update notifications terminology for devices
The specifications of some virtio device types are still using the old terminology for used buffer notifications and configuration change notifications calling these interrupts. Let us fix that. Fixes: https://github.com/oasis-tcs/virtio-spec/issues/16 Signed-off-by: Halil Pasic <pasic@linux.ibm.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
-rw-r--r--content.tex22
1 files changed, 11 insertions, 11 deletions
diff --git a/content.tex b/content.tex
index e698ba4..d9af9b4 100644
--- a/content.tex
+++ b/content.tex
@@ -3051,9 +3051,9 @@ if VIRTIO_NET_F_MRG_RXBUF is not negotiated.}
\label{sec:Device Types / Network Device / Device Operation / Processing of Packets}%old label for latexdiff
When a packet is copied into a buffer in the receiveq, the
-optimal path is to disable further interrupts for the receiveq
-and process
-packets until no more are found, then re-enable them.
+optimal path is to disable further used buffer notifications for the
+receiveq and process packets until no more are found, then re-enable
+them.
Processing incoming packets involves:
@@ -3893,7 +3893,7 @@ The device SHOULD clear the \field{write_zeroes_may_unmap} field of the
virtio configuration space if and only if a write zeroes request cannot
result in deallocating one or more sectors. The device MAY change the
content of the field during operation of the device; when this happens,
-the device SHOULD trigger a configuration change interrupt.
+the device SHOULD trigger a configuration change notification.
A write is considered volatile when it is submitted; the contents of
sectors covered by a volatile write are undefined in persistent device
@@ -4185,20 +4185,20 @@ an appropriate log or output method.
\begin{enumerate}
\item For output, a buffer containing the characters is placed in
the port's transmitq\footnote{Because this is high importance and low bandwidth, the current
-Linux implementation polls for the buffer to be used, rather than
-waiting for an interrupt, simplifying the implementation
+Linux implementation polls for the buffer to become used, rather than
+waiting for a used buffer notification, simplifying the implementation
significantly. However, for generic serial ports with the
O_NONBLOCK flag set, the polling limitation is relaxed and the
consumed buffers are freed upon the next write or poll call or
when a port is closed or hot-unplugged.
}.
-\item When a buffer is used in the receiveq (signalled by an
- interrupt), the contents is the input to the port associated
+\item When a buffer is used in the receiveq (signalled by a
+ used buffer notification), the contents is the input to the port associated
with the virtqueue for which the notification was received.
\item If the driver negotiated the VIRTIO_CONSOLE_F_SIZE feature, a
- configuration change interrupt indicates that the updated size can
+ configuration change notification indicates that the updated size can
be read from the configuration fields. This size applies to port 0 only.
\item If the driver negotiated the VIRTIO_CONSOLE_F_MULTIPORT
@@ -4441,7 +4441,7 @@ The device initialization process is outlined below:
\subsection{Device Operation}\label{sec:Device Types / Memory Balloon Device / Device Operation}
The device is driven either by the receipt of a configuration
-change interrupt, or by changing guest memory needs, such as
+change notification, or by changing guest memory needs, such as
performing memory compaction or responding to out of memory
conditions.
@@ -4578,7 +4578,7 @@ and notifies the device. A request for memory statistics proceeds
as follows:
\begin{enumerate}
-\item The device uses the buffer and sends an interrupt.
+\item The device uses the buffer and sends a used buffer notification.
\item The driver pops the used buffer and discards it.