Rusty Russell
2014-05-01 00:29:18 UTC
------------------------------------
Summary: Virtio General
Key: VIRTIO-101
URL: https://tools.oasis-open.org/issues/browse/VIRTIO-101
Project: OASIS Virtual I/O Device (VIRTIO) TC
Issue Type: Sub-task
Affects Versions: virtio 1.0 csprd01
Reporter: Rusty Russell
Assignee: Rusty Russell
A desc​ription of the shutdown process is missing. Specifically the driver must reset the device or disarm the virtio queues or bus mastering before allowing the memory backing the virtio queues to be reused. It would probably be good to specify a preferred mechanism.
The second draft contains the following text:Summary: Virtio General
Key: VIRTIO-101
URL: https://tools.oasis-open.org/issues/browse/VIRTIO-101
Project: OASIS Virtual I/O Device (VIRTIO) TC
Issue Type: Sub-task
Affects Versions: virtio 1.0 csprd01
Reporter: Rusty Russell
Assignee: Rusty Russell
A desc​ription of the shutdown process is missing. Specifically the driver must reset the device or disarm the virtio queues or bus mastering before allowing the memory backing the virtio queues to be reused. It would probably be good to specify a preferred mechanism.
\section{Device Cleanup}\label{sec:General Initialization And Device Operation / Device Cleanup}
Once the driver has set the DRIVER_OK status bit, all the configured
virtqueue of the device are considered live. None of the virtqueues
of a device are live once the device has been reset.
\drivernormative{\subsection}{Device Cleanup}{General Initialization And Device Operation / Device Cleanup}
A driver MUST NOT alter descriptor table entries which have been
exposed in the available ring (and not marked consumed by the device
in the used ring) of a live virtqueue.
A driver MUST NOT decrement the available \field{idx} on a live virtqueue (ie.
there is no way to ``unexpose'' buffers).
Thus a driver MUST ensure a virtqueue isn't live (by device reset) before removing exposed buffers.
This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.
In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.
Subscribe: virtio-comment-***@lists.oasis-open.org
Unsubscribe: virtio-comment-***@lists.oasis-open.org
List help: virtio-comment-***@lists.oasis-open.org
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/