From nobody Tue Dec 16 03:21:48 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1740044525831565.1872603962584; Thu, 20 Feb 2025 01:42:05 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id B3BA71E76; Thu, 20 Feb 2025 04:42:04 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id 283E91F4C; Thu, 20 Feb 2025 04:41:32 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id 8A7C91B34; Thu, 20 Feb 2025 04:41:28 -0500 (EST) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 158011E06 for ; Thu, 20 Feb 2025 04:41:28 -0500 (EST) Received: from mx-prod-mc-02.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-412-utVzIydXNFKOVXMMzMG6dQ-1; Thu, 20 Feb 2025 04:41:26 -0500 Received: from mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.40]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-02.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 649B2196E078 for ; Thu, 20 Feb 2025 09:41:25 +0000 (UTC) Received: from speedmetal.lan (unknown [10.44.22.26]) by mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 8749E19412A3 for ; Thu, 20 Feb 2025 09:41:24 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1740044487; h=from:from: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; bh=zOIKqDKaHnKImh2AAS3n1v9nz8VIYRLUqsCR3LDJctM=; b=L5rGf3nYRxJCQVC63ieRXFVgcLji8BIAKk2pEccrlX6NFKu/uXPRslAl+ZBCVyRFBm34ew ZOycgZ/Oq0N9ihy+vnITDqEik4eIVGsBhlokpLytF8qw6TUhsYrcztB/rBP5R1ahWR3k6b mDXo+8ozXHkCtwcWH5Kex/H4mkmIIH0= X-MC-Unique: utVzIydXNFKOVXMMzMG6dQ-1 X-Mimecast-MFC-AGG-ID: utVzIydXNFKOVXMMzMG6dQ_1740044485 From: Peter Krempa To: devel@lists.libvirt.org Subject: [PATCH 1/2] docs: formatdomain: Document few NVRAM config limitations Date: Thu, 20 Feb 2025 10:41:20 +0100 Message-ID: <884aec5049ae3b653c798d8111a3cf1088bf933c.1740044448.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.40 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: a5RM1zSqOdNchcXS1GEqVBf1cK4w6mQPo4DmRycYrJo_1740044485 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: QUDU2FZZMW7BNIHQFMANEUHOO4TS4U3Y X-Message-ID-Hash: QUDU2FZZMW7BNIHQFMANEUHOO4TS4U3Y X-MailFrom: pkrempa@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1740044527812019100 Content-Type: text/plain; charset="utf-8" Note that 'block' backed NVRAM may need to use 'qcow2' images to work properly and that populating from template may not support format conversion. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 381bf84f67..4a5241e610 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -283,13 +283,19 @@ harddisk, cdrom, network) determining where to obtain= /find the boot image. :since:`Since 8.5.0`, it's possible for the element to have ``type`` a= ttribute (accepts values ``file``, ``block`` and ``network``) in that case the N= VRAM storage is described by a ```` sub-element with the same syntax= as - ``disk``'s source. See `Hard drives, floppy disks, CDROMs`_. + ``disk``'s source. See `Hard drives, floppy disks, CDROMs`_. For ``bloc= k`` + backed NVRAM images it may be necessary to ensure that the block device + has the correct guest visible size based on hypervisor expectations. Th= is + may require use of non ``raw`` format image that allows arbitrary disk + size. **Note:** ``network`` backed NVRAM the variables are not instantiated f= rom the ``template`` and it's user's responsibility to provide a valid NVRA= M image. This element supports a ``format`` attribute, which specifies the format - of the NVRAM image. :since:`Since 9.2.0 (QEMU only)` + of the NVRAM image. :since:`Since 9.2.0 (QEMU only)` Note that hypervis= ors + may not support automatic population of the nvram if ``format`` differs= from + ``templateFormat`` or may support only a specific ``format``. It is not valid to provide this element if the loader is marked as stateless. --=20 2.48.1 From nobody Tue Dec 16 03:21:48 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1740044540578828.8001395856802; Thu, 20 Feb 2025 01:42:20 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id 712651E10; Thu, 20 Feb 2025 04:42:19 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id D26DF1E95; Thu, 20 Feb 2025 04:41:34 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id 0EE5B1E10; Thu, 20 Feb 2025 04:41:30 -0500 (EST) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 8E6821B34 for ; Thu, 20 Feb 2025 04:41:29 -0500 (EST) Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-342-CYhL7ns_NG6GVnjadsQstw-1; Thu, 20 Feb 2025 04:41:27 -0500 Received: from mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.40]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id CC2EA1801A13 for ; Thu, 20 Feb 2025 09:41:26 +0000 (UTC) Received: from speedmetal.lan (unknown [10.44.22.26]) by mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id E281419412A3 for ; Thu, 20 Feb 2025 09:41:25 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1740044489; h=from:from: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; bh=Ys3HAwEfh8MurlL5OAn5TprMTUsrR1pXREJIvtPxgzQ=; b=EhiB5SQ9jMIJWTze9lgwBYt+wJ95gtbdQ8r4x3oTBRzRElcDVYsdBTvfKR4IEV7pfrJa6H M0OGsRfIlrlFVbdSA54Dak3Dic8PMj+7naaqVfVuGHM8yG8m4Bw0tCTXFNMsRGBxxsHOzS btUWYip1A+PSv0ClGimcPafdLz6zfIE= X-MC-Unique: CYhL7ns_NG6GVnjadsQstw-1 X-Mimecast-MFC-AGG-ID: CYhL7ns_NG6GVnjadsQstw_1740044486 From: Peter Krempa To: devel@lists.libvirt.org Subject: [PATCH 2/2] docs: formatdomain: Mention that vhostuser interface with mode='server' waits for connection Date: Thu, 20 Feb 2025 10:41:21 +0100 Message-ID: <886fdde4f9e80d48b95ad29bb2594a5c9df731c5.1740044448.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.40 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: XlOQLbOD98BSkKzPHeAfoY1AyukoBXZ20dM1WTACZ-M_1740044486 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: AFCXZNVSGCQ7QS6XOZTPA6MSE4NUBHTC X-Message-ID-Hash: AFCXZNVSGCQ7QS6XOZTPA6MSE4NUBHTC X-MailFrom: pkrempa@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1740044541747019100 Content-Type: text/plain; charset="utf-8" When starting a VM with a vhost-user interface in server mode qemu will wait for the incoming connection without running CPUs. This isn't really documented in our XML. Additionally when hotplugging the same interface the above will not happen. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 4a5241e610..8ab6b7282d 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6346,6 +6346,11 @@ two attributes ``enabled`` (which accepts ``yes`` an= d ``no``) and ``timeout`` which specifies the amount of seconds after which hypervisor tries to reconnect. +Note that when ``mode=3D'server'`` is used, the hypervisor will wait for t= he +incomming connection to be established prior to actually running the VM. T= his is +not possible when hotplugging an interface the same config so the VM will +continue to run even when no connection is made. It's advised to use +``mode=3D'client'`` instead. vhost-user connection with passt backend ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ --=20 2.48.1