From nobody Fri Dec 12 14:09:14 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 Reviewed-by: Jiri Denemark --- 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 From nobody Fri Dec 12 14:09:14 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=1761904815; cv=none; d=zohomail.com; s=zohoarc; b=Y+m3dNUE9oYCM/99+yJManxzChj7m4R4sPzpvPNDWBsc1K6+75UTHV0R6NVB7EyPratMipf5k9Zl0RZbobYXR2OH5AqSLFQ8d6eAC9YNOTLVnZMvyho9elpwvZ7/QoKqR+50R34WeWGMHCZosSfktWZgc5M9eYtMJ5zutxb6IfY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1761904815; 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=EKzgNSG8ntZH8OKPoA4ahp4uqVkSDRCp01g03vU/jP4=; b=V2Q2+OCHkgPxrvp0/nMmwT4WQOoJEWRT1MtGQw0+DnA5WF1yWRl0LEB3lui5ZN1f9NY+jUd7sxjl6tQIssUxqiIRvwt3yseYpjGK+u1Rl1AuwNQ6bZew9cK1xCtzzX969mHlFjr0ONeN21iBP5pYDJKZsEAcRNOfR/A4OYlLr90= 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 1761904815347618.8262756511325; Fri, 31 Oct 2025 03:00:15 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id ABECF41B7E; Fri, 31 Oct 2025 06:00:14 -0400 (EDT) Received: from [172.19.199.29] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id C36EE44076; Fri, 31 Oct 2025 05:57:06 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 072DD43E8D; Fri, 31 Oct 2025 05:56:59 -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 CEFC843F29 for ; Fri, 31 Oct 2025 05:56:40 -0400 (EDT) Received: from mx-prod-mc-06.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-203-GtNvnkYwMzK_xpHcuDfahg-1; Fri, 31 Oct 2025 05:56:33 -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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 06E85180A27C for ; Fri, 31 Oct 2025 09:56:31 +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 495681800595 for ; Fri, 31 Oct 2025 09:56:30 +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=1761904600; 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=EKzgNSG8ntZH8OKPoA4ahp4uqVkSDRCp01g03vU/jP4=; b=F/l6KkbnQGknNX/8O+qa1YKH2F2Z5Jskp1uo9GAg3nrHH7L+wbs59mMWo97DimHh+jPsZi J7ik+Dcei2d5rEUbwvdo5UrwSralwpYLUpkfV7R2WDfPnXhghVrBOQ+ctDNNs8IfaQI+Sn PEDYqd1a4zwIM90PFpmK830b0qgzq0Y= X-MC-Unique: GtNvnkYwMzK_xpHcuDfahg-1 X-Mimecast-MFC-AGG-ID: GtNvnkYwMzK_xpHcuDfahg_1761904591 To: devel@lists.libvirt.org Subject: [PATCH 2/4] drvch: Demote example section to a subsection Date: Fri, 31 Oct 2025 10:56:23 +0100 Message-ID: <4bfe47fd34c34fa9113ef3af57e28fd61b4fc8eb.1761904541.git.mprivozn@redhat.com> 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: 0b9R_7N0lF6bl_5G50YF-tVA5kOQrp0bFKeBUrK54i8_1761904591 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: H3ZXAITOYYI2I4WBDWQNFOPJEJAOZPDT X-Message-ID-Hash: H3ZXAITOYYI2I4WBDWQNFOPJEJAOZPDT 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: 1761904816339154100 Content-Type: text/plain; charset="utf-8"; x-default="true" From: Michal Privoznik In our drvch.rst there's a section with example XML. Demote it to a subsection ('-') since the whole document starts with section ('=3D') and this paragraph is really just a child of the root. Signed-off-by: Michal Privoznik Reviewed-by: Jiri Denemark --- docs/drvch.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/drvch.rst b/docs/drvch.rst index b8c48a775b..2f900b785b 100644 --- a/docs/drvch.rst +++ b/docs/drvch.rst @@ -29,7 +29,7 @@ But all other transport modes are supported too =20 =20 Example guest domain XML configurations -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +--------------------------------------- =20 The Cloud Hypervisor driver in libvirt is in its early stage under active development only supporting a limited number of Cloud Hypervisor features. --=20 2.51.0 From nobody Fri Dec 12 14:09:14 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=1761904696; cv=none; d=zohomail.com; s=zohoarc; b=nZo6A9dAh4fDVnI6aNP8wdbqauT2n77PqRKi10LYvauTLKocAjlYH1BBEjU3zx/4FiHcQYyKZd3OkSN1o8JWLICxClN3NRr4CMeijTIQvRv9uJZQ8M3JAxYhkHdLbXEYK/cU6i44wRkvoOi9gWMfMCOtNQQU4TeIhOeHyxsvcN8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1761904696; 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=N65VoRoq6C9YxjZXPOG5ltt64x5sZ5ex2j2B+rmRAtQ=; b=jhLwUIB9LklWMO4KM4C3Y0gCGqAi+RfzgizcYCziEgFycJZ58oYJpK3hCrKPGnTRD+A017DMS/EqGll0+IvlWCNOgT0oETwbWsOx5SsHEv5AsUbUmCe7b7cahBA4M6cqJyoK120K5PCIcGCX8ByRJQWnaMHAZQOYNnAq8AgHIYg= 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 176190469604915.90736878514474; Fri, 31 Oct 2025 02:58:16 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 37AAB43E78; Fri, 31 Oct 2025 05:58:13 -0400 (EDT) Received: from [172.19.199.29] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id 0A6AF43FA3; Fri, 31 Oct 2025 05:56:47 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 6695443E47; 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 B5B0A417EF for ; Fri, 31 Oct 2025 05:56:35 -0400 (EDT) Received: from mx-prod-mc-05.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-403-WOc6cdf8PsyFXb909Lf2PQ-1; Fri, 31 Oct 2025 05:56:33 -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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 44CFD1955E8F for ; Fri, 31 Oct 2025 09:56:32 +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 7A04F1800594 for ; Fri, 31 Oct 2025 09:56:31 +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=1761904595; 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=N65VoRoq6C9YxjZXPOG5ltt64x5sZ5ex2j2B+rmRAtQ=; b=QN0rcwRP8yLS09n77nkERK8b/JSexbzlLB21rKIefc5tfiajaNbZgfh7i5eKfs+VKN4aDb PAY7YR+mFyJVXCLlFykeHZ3bokAwxQzPGRlDjv4hldtZS93Ph54PQsDCIW7XoMEvGfhgwO dwtkrCaWQUN/GMu8In+CojLH/bUmEm0= X-MC-Unique: WOc6cdf8PsyFXb909Lf2PQ-1 X-Mimecast-MFC-AGG-ID: WOc6cdf8PsyFXb909Lf2PQ_1761904592 To: devel@lists.libvirt.org Subject: [PATCH 3/4] ch: Load ch.conf from SYSCONFDIR Date: Fri, 31 Oct 2025 10:56:24 +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: RY2f2PmDJLaN6yEyz1dzRflZ5r7Knr0KJE3Rla2JZlA_1761904592 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: CLUXKOHXFO6NJ5ILNER6ABOUZI757QGD X-Message-ID-Hash: CLUXKOHXFO6NJ5ILNER6ABOUZI757QGD 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: 1761904703411158500 Content-Type: text/plain; charset="utf-8"; x-default="true" From: Michal Privoznik Config files for system instances of our drivers (e.g. "ch:///system", "qemu:///system", etc.) live under /etc/libvirt. But for some reason, the CH driver was trying to load the config file from /var/lib/libvirt/ch/ even though the file is installed under /etc/libvirt per the following line from src/meson.build: install_data(virt_conf_files, install_dir: confdir) Signed-off-by: Michal Privoznik Reviewed-by: Jiri Denemark --- src/ch/ch_conf.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/ch/ch_conf.c b/src/ch/ch_conf.c index 8a542eef19..6896683b7f 100644 --- a/src/ch/ch_conf.c +++ b/src/ch/ch_conf.c @@ -178,8 +178,7 @@ virCHDriverConfigNew(bool privileged) cfg->logDir =3D g_strdup_printf("%s/log/libvirt/ch", LOCALSTATEDIR= ); cfg->stateDir =3D g_strdup_printf("%s/libvirt/ch", RUNSTATEDIR); cfg->saveDir =3D g_strdup_printf("%s/lib/libvirt/ch/save", LOCALST= ATEDIR); - cfg->configDir =3D g_strdup_printf("%s/lib/libvirt/ch", LOCALSTATE= DIR); - + cfg->configDir =3D g_strdup(SYSCONFDIR "/libvirt"); } else { g_autofree char *rundir =3D NULL; g_autofree char *cachedir =3D NULL; --=20 2.51.0 From nobody Fri Dec 12 14:09:14 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=1761904776; cv=none; d=zohomail.com; s=zohoarc; b=RT3R7+wf+0eKU5AS9T/NHKUxpjvZZXeectmHNs9yV9JmagLjpN//RnshmL20KqXpsmDZk4Q1JWkyNq5WQmWLY+2Br1zdRrBR4ZqkxKc7PAnqJ2TLfo5NWhmBIdNFzmpYK8P1Zphe6gHbAQGm6Ji/ULoSO9rmABqAZKNUAMEW8sU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1761904776; 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=OgYbyzGSg+hlL1fGxoLbcEX1eaARAIPk4pIRpi1RNhk=; b=MmJn2oyhRBEAO3M2Q6bFb8zJh7/BojT3MJyIletenQix4bXGP6RyKZMAJpCF6heEO3nNDKb3/zBaMHqJYJTe8IVJTsR2a9mMtlqPqJArWQV92a3iOFp9LAt1EmszLdDZcHDGUakdHVN+0Y+v2tNlhjPDPeQKRJFbzgTnFFgTepc= 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 1761904776983874.2024039691745; Fri, 31 Oct 2025 02:59:36 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 2305743E91; Fri, 31 Oct 2025 05:59:36 -0400 (EDT) Received: from [172.19.199.29] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id 9BFF54403F; Fri, 31 Oct 2025 05:56:57 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 7661543F69; Fri, 31 Oct 2025 05:56:45 -0400 (EDT) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.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 CC63F43EA4 for ; Fri, 31 Oct 2025 05:56:37 -0400 (EDT) Received: from mx-prod-mc-06.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-212-JCeraLVrME2qmI6-6vxi-g-1; Fri, 31 Oct 2025 05:56:36 -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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E173D1828ACF for ; Fri, 31 Oct 2025 09:56:33 +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 A19B7180058D for ; Fri, 31 Oct 2025 09:56:32 +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=1761904597; 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=OgYbyzGSg+hlL1fGxoLbcEX1eaARAIPk4pIRpi1RNhk=; b=D6PIL2g+rIa5xIomvC34bPldhOOM3Mzi0JszBzhOIZOTDhYc2GtmkqDsub5EFfH+Qfq5JD nlBZl17oXd1oEGb+xcCwPX+xXaVHQvu9CEtUeOF7RwhXdmNInjVc5gnlYtlIFtv3tEgIDw uDY91Jc/66/HHT6uZcLU2uBD+V0BtWM= X-MC-Unique: JCeraLVrME2qmI6-6vxi-g-1 X-Mimecast-MFC-AGG-ID: JCeraLVrME2qmI6-6vxi-g_1761904594 To: devel@lists.libvirt.org Subject: [PATCH 4/4] drvch: Document config file locations Date: Fri, 31 Oct 2025 10:56:25 +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: hYlhqDdhsyi9tOJVTG3ZVB5-FhR2CL6GKqh842Df9nc_1761904594 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: UUZZCCQX5APKNEVXOJI5JH2V3OOGNW3R X-Message-ID-Hash: UUZZCCQX5APKNEVXOJI5JH2V3OOGNW3R 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: 1761904778367158500 Content-Type: text/plain; charset="utf-8"; x-default="true" From: Michal Privoznik Signed-off-by: Michal Privoznik Reviewed-by: Jiri Denemark --- docs/drvch.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/drvch.rst b/docs/drvch.rst index 2f900b785b..b9effc4409 100644 --- a/docs/drvch.rst +++ b/docs/drvch.rst @@ -28,6 +28,22 @@ But all other transport modes are supported too (see `documentation `__). =20 =20 +Location of configuration files +------------------------------- + +The CH driver comes with sane default values. However, during its +initialization it reads a configuration file which offers system +administrator or an user to override some of that default. The location +of the file depends on the connection URI, as follows: + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D +``ch:///system`` ``/etc/libvirt/ch.conf`` +``ch:///session`` ``$XDG_CONFIG_HOME/libvirt/ch/ch.conf`` +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D + +If ``$XDG_CONFIG_HOME`` is not set in the environment, it defaults to +``$HOME/.config``. + Example guest domain XML configurations --------------------------------------- =20 --=20 2.51.0