From nobody Sat May 18 12:12:27 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1692937399; cv=none; d=zohomail.com; s=zohoarc; b=cHlcdhxiCjAwmKDHkMOQmptOUoNxN8kwTdGJS9UJa501DApAMCTQIeQFtwz55k8xZejWWpN4dwZkfjHfL0GETIRxwn1squP3lpf5lAkOFC6PSAR+kSaUdzddKX2ANWvzFJGFUzD8FkXKH7HQMzKWV6rJF7mn0XuznERxoUpVSlE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1692937399; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=fqrBP1AI1PKlhadeFK0a482PhG6/RQL/7nzTUi4Jz30=; b=eZBFLSEX/wi5/G0nIoOameFAPWEModHPhN5tWinzQmcgqIQD9lxMdHzzIuqrv88pXhmvKJcQiMcKbj9f7Q/GRIgDAok48EJbXlztB1KSrJT56j1/Zu2EM44kuC3/2665j3r17+B6MTkKrfmgPffda856j5JkgjMn0FA4dgOU2OQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1692937399810331.6215947553011; Thu, 24 Aug 2023 21:23:19 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-443-WJj6PWrlNyy832NQryU8_g-1; Fri, 25 Aug 2023 00:23:13 -0400 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 4F5D4805597; Fri, 25 Aug 2023 04:23:11 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id E17A52026D68; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 6426719465A8; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 3B67F1946589 for ; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 0D1FB40C207A; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) Received: from vhost3.router.laine.org (unknown [10.22.8.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id E95DF40C2073 for ; Fri, 25 Aug 2023 04:23:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1692937398; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=fqrBP1AI1PKlhadeFK0a482PhG6/RQL/7nzTUi4Jz30=; b=Nz9wDUvy/W1HppDJLM3JEU4v8IEcdntypp6WeXH+2waeFpUpLQIXT1a9r8vfgM1aAtuEjb ucvv5cWHGGljueprXrmXltfojcn/2Psz0z76eFfdYdRjqGun4V0x1KWdraQWRSxLy7LYAd hQ6ePBrHq4AjkEwx4SCjdOR5xMOOJns= X-MC-Unique: WJj6PWrlNyy832NQryU8_g-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Laine Stump To: libvir-list@redhat.com Subject: [libvirt PATCH 1/2] docs: update description of virsh nodedev-detach --driver option Date: Fri, 25 Aug 2023 00:23:06 -0400 Message-ID: <20230825042307.645057-2-laine@redhat.com> In-Reply-To: <20230825042307.645057-1-laine@redhat.com> References: <20230825042307.645057-1-laine@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.4 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1692937400926100005 Content-Type: text/plain; charset="utf-8"; x-default="true" --driver can now be used to specify a specific driver to bind to the device being detached from the host driver (e.g. vfio-pci-igbvf), not just the *type* of driver (e.g. "vfio" or "xen", which are unnecessary anyway, since they are implicit in which hypervisor driver is in use) Signed-off-by: Laine Stump Reviewed-by: Michal Privoznik --- docs/manpages/virsh.rst | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index f4e5a0bd62..ec7c823602 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -5388,14 +5388,23 @@ nodedev-detach =20 nodedev-detach nodedev [--driver backend_driver] =20 -Detach *nodedev* from the host, so that it can safely be used by -guests via passthrough. This is reversed with -``nodedev-reattach``, and is done automatically for managed devices. - -Different backend drivers expect the device to be bound to different -dummy devices. For example, QEMU's "vfio" backend driver expects the -device to be bound to vfio-pci. The *--driver* parameter can be used -to specify the desired backend driver. +Detach *nodedev* from the host driver and bind it to a special driver +that provides the API needed by the hypervisor for assigning the +device to a virtual machine (using in the domain XML +definition). This is reversed with ``nodedev-reattach``, and is done +automatically by the hypervisor driver for managed devices (those +devices with "managed=3D'yes'" in their XML definition). + +Different hypervisors expect the device being assigned to be bound to +different drivers. For example, QEMU's "vfio" backend requires the +device to be bound to the driver "vfio-pci" or to a "VFIO variant" +driver (this is a driver that supports the full API provided by +vfio-pci, plus some other APIs to support things like live +migration). The *--driver* parameter can be used to specify a +particular driver (e.g. a device-specific VFIO variant driver) the +device should be bound to. When *--driver* is omitted, the default +driver for the hypervisor is used ("vfio-pci" for QEMU, "pciback" for +Xen). =20 =20 nodedev-dumpxml --=20 2.41.0 From nobody Sat May 18 12:12:27 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1692937400; cv=none; d=zohomail.com; s=zohoarc; b=aWMVaKuCVAF665dr2OFwW/Ky6D8ckxWPR1JEZQmKli+eNDbMu65xgoAvk0VinCdEBxCDA5ZOlMQANpgTmAK2bc7i8vN9LcA2mXxeTUQd/3Vt4n625NTzTZuXmDyc1YB4Id6bHBdYrnf2LeMB5jCfixFMEGSVv3wDFUJf58d9ho8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1692937400; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=7CJqOspbypehZ1vtQlwwsD/ydBuq9GDUSD4XUeXI+7w=; b=Ljqc4SqWFzGexV7y3Q83FeffJa/GGlxjKD05OPXWBRxxMrYT/X2fWOC3Njo30VCwSvpktVw0jsK2v34UdKjzHfM7IWyhxMDZ/8acUw6E6waP39BygQvvIyKWlnyRONvNsfr6jiOQgTaNTV2slqXWnxZ+Iu7LrB+PB3w8Q3bGGqo= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1692937400294351.08859790459667; Thu, 24 Aug 2023 21:23:20 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-388-x45RoEGKMMmnRtddtRWSPA-1; Fri, 25 Aug 2023 00:23:13 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 48FD6823D7B; Fri, 25 Aug 2023 04:23:11 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 35CEA1121319; Fri, 25 Aug 2023 04:23:10 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 5CC5A19465B2; Fri, 25 Aug 2023 04:23:09 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 4097F19465A8 for ; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 313EE40C2079; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) Received: from vhost3.router.laine.org (unknown [10.22.8.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1908040C2073 for ; Fri, 25 Aug 2023 04:23:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1692937399; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=7CJqOspbypehZ1vtQlwwsD/ydBuq9GDUSD4XUeXI+7w=; b=GdDwWojxOjoglgL1kaaeF8/qWLT5kgiaQ/GNYZKAfD4HtpMB+lRvt/Ke4gFulTENP0pQwB +KH9j39ChjgOI7FvQkKUuxOCWGhiHXkjfg7oC4uJu3QlQA2OHHGggPbY7WopZoKsrtr6cP L8E3F6JaExKJlP6kYWgUJCOM5TA6LqQ= X-MC-Unique: x45RoEGKMMmnRtddtRWSPA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Laine Stump To: libvir-list@redhat.com Subject: [libvirt PATCH 2/2] NEWS: document support for VFIO variant drivers Date: Fri, 25 Aug 2023 00:23:07 -0400 Message-ID: <20230825042307.645057-3-laine@redhat.com> In-Reply-To: <20230825042307.645057-1-laine@redhat.com> References: <20230825042307.645057-1-laine@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.3 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1692937400680100003 Content-Type: text/plain; charset="utf-8"; x-default="true" Signed-off-by: Laine Stump Reviewed-by: Michal Privoznik --- NEWS.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/NEWS.rst b/NEWS.rst index 3571c01b29..e40c8ac259 100644 --- a/NEWS.rst +++ b/NEWS.rst @@ -17,6 +17,17 @@ v9.7.0 (unreleased) =20 * **New features** =20 + * qemu: basic support for use of "VFIO variant" drivers + + A VFIO variant driver is a device-specific driver that can + be used in place of the generic vfio-pci driver, and provides + extra functionality to support things like live migration of + guests with vfio-assigned devices. It can currently be used by: + + 1) setting ``managed=3D'no'`` in the XML configuration for the device + 2) pre-binding the variant driver using the ``--driver`` option of + ``virsh nodedev-detach``. + * **Improvements** =20 * **Bug fixes** --=20 2.41.0