From nobody Mon Feb 9 09:28:50 2026 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=1652713979; cv=none; d=zohomail.com; s=zohoarc; b=GhuD6M1lXyqj0ntJW1rEs34kYQmZCnsO0nE72xXsTDIywAj2UJHUV1Tgmj9yHhJl8wS9+At4YxlJtmwwR2BiAaF9Q+PxSsjTvaj1yLuKSDyIxsAMREpbeVDKv9eJrD2eW1IKXVWuQzcSJq1CCVNRZmEQIZ0rtOVCV8BvmsvgHEk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1652713979; 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=S7Rpkmb/p7amxxuKt5E7/dofjNdpuBoI7oOIIRl429A=; b=nuMT4ZPgHg6ZAKmcRnjf3Cjk+zZoyivpeA1+3ASrssJWsiv3e7JaoEvCTfimCdkSdTrStDNmc4SkgAnQWExdvSuzpCLisyC/r09fqMF8Q9kE2mIW8ITTnRmWOqEaCzVPBdqYGebV/L6qrYv4lIy1YEna4AUVcFv7fXKwUMXOdoI= 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 1652713979287820.0274330621111; Mon, 16 May 2022 08:12:59 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-398-Pi-vSxveOx-0qoVhhw53yA-1; Mon, 16 May 2022 11:12:53 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 1D77E29ABA2A; Mon, 16 May 2022 15:12:49 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 06AEC492C14; Mon, 16 May 2022 15:12:49 +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 C8E571947075; Mon, 16 May 2022 15:12:48 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 8F93D1947073 for ; Mon, 16 May 2022 15:12:45 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 74AA7492C14; Mon, 16 May 2022 15:12:45 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id DB4D4401E74 for ; Mon, 16 May 2022 15:12:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1652713978; 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=S7Rpkmb/p7amxxuKt5E7/dofjNdpuBoI7oOIIRl429A=; b=LirZokdBKsYDx6zy9BKspQ0LvcMBy3ebSp4Ifu/QOi1pS/LJ1lCMO03Vu3ASF3Nnr2+/os Tndj5+KC58Y3KKKG9DQ5+/jH+u74mx9onwUIOlX1aaU++F+OD7Bc0+sEwywd8v5n0gdYag p4y+Fq17s+S7W40zqXB9GAQRUc7t3h8= X-MC-Unique: Pi-vSxveOx-0qoVhhw53yA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 02/11] docs: drvqemu: Decrease expectations about command line from 'virsh domxml-to-native' Date: Mon, 16 May 2022 17:12:32 +0200 Message-Id: <32cba5edcea7fed617ba531914630792315079c9.1652710341.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.85 on 10.11.54.10 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 2.85 on 10.11.54.10 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com 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: 1652713980446100007 Content-Type: text/plain; charset="utf-8" In the qemu driver certain configs such as disk throttling or CPU hotplug is configured by interacting with the monitor at the startup phase of the hypervisor and thus is not part of the "native config". Add a paragraph into the documentation outlining that the native configuration might not be completely usable. Signed-off-by: Peter Krempa --- docs/drvqemu.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/drvqemu.rst b/docs/drvqemu.rst index 6368a91fb9..e08a60c705 100644 --- a/docs/drvqemu.rst +++ b/docs/drvqemu.rst @@ -443,10 +443,16 @@ Converting from domain XML to QEMU args ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The ``virsh domxml-to-native`` provides a way to convert a guest descripti= on -using libvirt Domain XML, into a set of QEMU args that can be run manually= . Note -that currently the command line formatted by libvirt is no longer suited f= or -manually running qemu as the configuration expects various resources and o= pen -file descriptors passed to the process which are usually prepared by libvi= rtd. +using libvirt Domain XML, into a set of QEMU args that would be used by li= bvirt +to start the qemu process. + +Note that currently the command line formatted by libvirt is no longer sui= ted +for manually running qemu as the configuration expects various resources a= nd +open file descriptors passed to the process which are usually prepared by +libvirtd as well as certain features being configured via the monitor. + +The qemu arguments as returned by ``virsh domxml-to-native`` thus are not +trivially usable outside of libvirt. Pass-through of arbitrary qemu commands --------------------------------------- --=20 2.35.3