From nobody Fri Dec 12 15:16:10 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=pass(p=reject dis=none) header.from=lists.libvirt.org ARC-Seal: i=1; a=rsa-sha256; t=1761904743; cv=none; d=zohomail.com; s=zohoarc; b=RibGBccjITlpW5a5wHSrctXlkXkX+QRY15hbdD8GsNo8tqlCjTe0h1spyzTMDjBOGv5FXQ/MwWIDzHYAOYk+4UuDVujXHXU1UuTMOJTk2Gdq/qoHvLMfDROwfmVujAEKFwYkfLBZ15k8bJWDQ87xqkgFdM7T4TKJBs0EqJcf1bU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1761904743; h=Content-Type:Content-Transfer-Encoding:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Owner:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Reply-To:References:Subject:Subject:To:To:Message-Id:Cc; bh=4J/XiEnJqeg30ICIeWSlKd7AqEDe296UYjYzbzY9qLo=; b=INIvXfdMElhkcv/lRiVPsaxrv2UmdWgqA+UXPBCG9lAd5zfpMteakDcqrmdTD3Q6YRBaPa2LtaAijplmg2NTw4M3s764Oth0Tg1LIKteinqsQfNnp6SeXpi4syCwl1UP0uENSSAmgfAeKSoiuJtSrAkt53QpUgpAhvxI65OiI2k= ARC-Authentication-Results: i=1; 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=pass header.from= (p=reject dis=none) Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1761904743556391.02003379101416; Fri, 31 Oct 2025 02:59:03 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 80ACF43F37; Fri, 31 Oct 2025 05:59:00 -0400 (EDT) Received: from [172.19.199.29] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id 7984B43FF7; Fri, 31 Oct 2025 05:56:53 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 0700643E77; Fri, 31 Oct 2025 05:56:36 -0400 (EDT) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (3072 bits) server-digest SHA256) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 65DF243DC4 for ; Fri, 31 Oct 2025 05:56:36 -0400 (EDT) Received: from mx-prod-mc-01.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-397-146AIMX3PWeb4VjE9ClzWA-1; Fri, 31 Oct 2025 05:56:30 -0400 Received: from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.111]) (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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id CD3B3195398E for ; Fri, 31 Oct 2025 09:56:29 +0000 (UTC) Received: from moe (unknown [10.43.3.236]) by mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 23A511800597 for ; Fri, 31 Oct 2025 09:56:28 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-5.0 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_PASS autolearn=unavailable autolearn_force=no version=4.0.1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1761904596; 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=4J/XiEnJqeg30ICIeWSlKd7AqEDe296UYjYzbzY9qLo=; b=dKCICfTVJ2lO38JHAW9HiuvtJMSXgWQhNOrPTA8I1oRlhO5fjT9pimDaJzTjrSW3Mn9VhN AC9uJ5K6KKO+6j6B2IlNdisA4wX0c2xhJjyFgjf582ZKvvvRQ6Dk9xEEWgFoTkgrCJfG0H lGP/hQYbcWWnXAnolnv4O5oeJDPo7kc= X-MC-Unique: 146AIMX3PWeb4VjE9ClzWA-1 X-Mimecast-MFC-AGG-ID: 146AIMX3PWeb4VjE9ClzWA_1761904589 To: devel@lists.libvirt.org Subject: [PATCH 1/4] docs: Document supported URIs for CH driver Date: Fri, 31 Oct 2025 10:56:22 +0100 Message-ID: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.111 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: bGoYOU9m2iSS6OcIKDQASci_e93Z8UG2whBISAy_VxY_1761904589 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: TQY32S27RMUBHA7RWN7246F5PVVKWFTN X-Message-ID-Hash: TQY32S27RMUBHA7RWN7246F5PVVKWFTN X-MailFrom: mprivozn@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.lists.libvirt.org-0; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.10 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Michal Privoznik via Devel Reply-To: Michal Privoznik X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1761904745911158500 Content-Type: text/plain; charset="utf-8"; x-default="true" From: Michal Privoznik Our docs suggest that only session mode is supported for CH drvier. Well, that's clearly not case. Document the system URI and refer to other (remote) supported transport modes (yeah, that works too). Signed-off-by: Michal Privoznik --- docs/drvch.rst | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/drvch.rst b/docs/drvch.rst index bb13599e6f..b8c48a775b 100644 --- a/docs/drvch.rst +++ b/docs/drvch.rst @@ -12,13 +12,20 @@ customers inside a cloud provider. For our purposes thi= s means modern operating systems with most I/O handled by paravirtualised devices (i.e. virtio), no requirement for legacy devices, and 64-bit CPUs. =20 -The libvirt Cloud Hypervisor driver is intended to be run as a session -driver without privileges. The cloud-hypervisor binary itself should be -``setcap cap_net_admin+ep`` (in order to create tap interfaces). +The libvirt Cloud Hypervisor (CH) driver is intended to be run as a +session driver without privileges. The cloud-hypervisor binary itself +should be ``setcap cap_net_admin+ep`` (in order to create tap +interfaces). Though, system-wide connection URI is also supported. =20 Expected connection URI would be =20 -``ch:///session`` +:: + + ch:///session (local access to per-user instance) + ch:///system (local access to system instance) + +But all other transport modes are supported too +(see `documentation `__). =20 =20 Example guest domain XML configurations --=20 2.51.0