diff options
author | Halil Pasic <pasic@linux.ibm.com> | 2018-06-25 14:21:32 +0200 |
---|---|---|
committer | Michael S. Tsirkin <mst@redhat.com> | 2018-10-19 17:29:28 -0400 |
commit | a2e22e211817c24be1ffaba0ea04bf7f7e893a50 (patch) | |
tree | 3c27b5f309b2bec76f839ce57a48630cdca4a2c3 /content.tex | |
parent | 0ec888d8c4572db97ce2fb3f47ba5abd9c0681a8 (diff) | |
download | virtio-spec-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>
Diffstat (limited to 'content.tex')
-rw-r--r-- | content.tex | 22 |
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. |