From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: virtio-dev-return-4304-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 [66.179.20.138]) by lists.oasis-open.org (Postfix) with ESMTP id 3931B5818F2F for ; Thu, 7 Jun 2018 19:07:06 -0700 (PDT) From: Tiwei Bie Date: Fri, 8 Jun 2018 10:07:01 +0800 Message-Id: <20180608020701.12297-1-tiwei.bie@intel.com> Subject: [virtio-dev] [PATCH v2] content: document SR-IOV driver requirements To: mst@redhat.com, cohuck@redhat.com, stefanha@redhat.com, pbonzini@redhat.com, virtio-dev@lists.oasis-open.org Cc: dan.daly@intel.com, alexander.h.duyck@intel.com, mark.d.rustad@intel.com, cunming.liang@intel.com, zhihong.wang@intel.com List-ID: Document the driver requirements for the VIRTIO_F_SR_IOV feature bit. Suggested-by: Michael S. Tsirkin Signed-off-by: Tiwei Bie Fixes: https://github.com/oasis-tcs/virtio-spec/issues/13 --- v2: - Fix the commit message (MST); - Improve the wording (MST); - Drop unnecessary parts (MST); content.tex | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/content.tex b/content.tex index be18234..f996fad 100644 --- a/content.tex +++ b/content.tex @@ -5387,6 +5387,21 @@ A driver SHOULD accept VIRTIO_F_IO_BARRIER if it is offered. If VIRTIO_F_IO_BARRIER has been negotiated, a driver MUST use the barriers suitable for hardware devices. +If VIRTIO_F_SR_IOV has been negotiated, a driver MAY enable +virtual functions through the device's PCI SR-IOV capability +structure. A driver MUST NOT negotiate VIRTIO_F_SR_IOV if +the device does not have a PCI SR-IOV capability structure +or is not a PCI device. A driver MUST negotiate +VIRTIO_F_SR_IOV and complete the feature negotiation +(including checking the FEATURES_OK \field{status} bit) +before enabling virtual functions through the device's +PCI SR-IOV capability structure. After once successfully +negotiating VIRTIO_F_SR_IOV, the driver MAY enable virtual +functions through the device's PCI SR-IOV capability +structure even if the device or the system has been fully +or partially reset, and even without re-negotiating +VIRTIO_F_SR_IOV after the reset. + \devicenormative{\section}{Reserved Feature Bits}{Reserved Feature Bits} A device MUST offer VIRTIO_F_VERSION_1. A device MAY fail to operate further -- 2.17.0 --------------------------------------------------------------------- To unsubscribe, e-mail: virtio-dev-unsubscribe@lists.oasis-open.org For additional commands, e-mail: virtio-dev-help@lists.oasis-open.org