From nobody Tue Dec 16 16:43:09 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