Return-Path: virtio-comment-return-1643-cohuck=redhat.com@lists.oasis-open.org Sender: List-Post: List-Help: List-Unsubscribe: List-Subscribe: Received: from lists.oasis-open.org (oasis-open.org [10.110.1.242]) by lists.oasis-open.org (Postfix) with ESMTP id 7B63C985D30 for ; Mon, 18 Jan 2021 16:38:14 +0000 (UTC) From: Cornelia Huck Date: Mon, 18 Jan 2021 17:38:04 +0100 Message-Id: <20210118163804.437098-1-cohuck@redhat.com> MIME-Version: 1.0 Subject: [virtio-comment] [PATCH RFC v2] clarify device reset Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: quoted-printable To: virtio-comment@lists.oasis-open.org Cc: Jason Wang , Cornelia Huck List-ID: Properly specify that the method for the driver to request a device reset is transport specific, and some action the device has to take. Signed-off-by: Cornelia Huck --- RFC -> RFC v2: - moved reset spec to basic facilities --- conformance.tex | 1 + content.tex | 13 +++++++++++++ 2 files changed, 14 insertions(+) diff --git a/conformance.tex b/conformance.tex index eb3324053080..3be499ae3c5e 100644 --- a/conformance.tex +++ b/conformance.tex @@ -271,6 +271,7 @@ \section{Conformance Targets}\label{sec:Conformance / C= onformance Targets} \begin{itemize} \item \ref{devicenormative:Basic Facilities of a Virtio Device / Device St= atus Field} \item \ref{devicenormative:Basic Facilities of a Virtio Device / Feature B= its} +\item \ref{devicenormative:Basic Facilities of a Virtio Device / Device Re= set} \item \ref{devicenormative:Basic Facilities of a Virtio Device / Device Co= nfiguration Space} \item \ref{devicenormative:Basic Facilities of a Virtio Device / Message F= raming} \item \ref{devicenormative:Basic Facilities of a Virtio Device / Virtqueue= s / The Virtqueue Descriptor Table} diff --git a/content.tex b/content.tex index 620c0e28c9a7..782ddf3ed78d 100644 --- a/content.tex +++ b/content.tex @@ -193,6 +193,19 @@ \section{Notifications}\label{sec:Basic Facilities of = a Virtio Device terminology. Occasionally, the term event is used to refer to a notification or a receipt of a notification. =20 +\section{Device Reset}\label{sec:Basic Facilities of a Virtio Device / Dev= ice Reset} + +The driver may initiate a device reset at various times; notably, during +device initialization and device cleanup. + +The mechanism used by the driver to initiate the reset is transport specif= ic. + +\devicenormative{\subsection}{Device Reset}{Basic Facilities of a Virtio D= evice / Device Reset} + +A device MUST reinitialize device status to 0 after receiving a reset. + +A device MUST NOT send notifications after receiving a reset. + \section{Device Configuration Space}\label{sec:Basic Facilities of a Virti= o Device / Device Configuration Space} =20 Device configuration space is generally used for rarely-changing or --=20 2.26.2 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-subscribe@lists.oasis-open.org Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org List help: virtio-comment-help@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-lis= ts Committee: https://www.oasis-open.org/committees/virtio/ Join OASIS: https://www.oasis-open.org/join/