From nobody Mon Jan 26 07:39:33 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org ARC-Seal: i=1; a=rsa-sha256; t=1768935590; cv=none; d=zohomail.com; s=zohoarc; b=a8WoCcav+vD8Axfi990ocB6kSiLqNg0GVMUiIRSooyA848ngMBAiyZmpSpR+ezaBp9RPdX6yL+rUjZjDDxlB1g6esyS58JnnYC00gJ/V4hIefv2aYwney5Zw+a+iUEYEhZau97+90lSySaWn1xsbTZNqcGFNo0J5rHfcJBAKbw0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1768935590; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=ZkHW951EcvlKRgwnk8lLtbogl+mge00JxhboUAq9tIk=; b=XQFIR9EmrFWwC9kf1M5yS7rujidKbC+0mLiTri1Mj//jcjplH6IPKBNbCguWzVfUoq4ucB/aR+svdFgI5uwRN/ApjlTmoDsrNIvIK+i4cs5dLbvphDSxFyuZMi0uEVdVNbyjxdesRVqjGZlEdmWQ8N9gB0wOhoyVxBpjgmQCBQ8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1768935589867485.682762748954; Tue, 20 Jan 2026 10:59:49 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.1209299.1521357 (Exim 4.92) (envelope-from ) id 1viGwp-0005Jt-SC; Tue, 20 Jan 2026 18:59:27 +0000 Received: by outflank-mailman (output) from mailman id 1209299.1521357; Tue, 20 Jan 2026 18:59:27 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1viGwp-0005Jm-PW; Tue, 20 Jan 2026 18:59:27 +0000 Received: by outflank-mailman (input) for mailman id 1209299; Tue, 20 Jan 2026 18:59:26 +0000 Received: from mail.xenproject.org ([104.130.215.37]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1viGwo-0005Jg-Cb for xen-devel@lists.xenproject.org; Tue, 20 Jan 2026 18:59:26 +0000 Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.96) (envelope-from ) id 1viGwo-00Crcn-0t; Tue, 20 Jan 2026 18:59:25 +0000 Received: from [19.12.91.86] (helo=localhost) by xenbits.xenproject.org with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1viGwn-00BwMN-1f; Tue, 20 Jan 2026 18:59:25 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=xen.org; s=20200302mail; h=Content-Transfer-Encoding:MIME-Version:Message-ID:Date: Subject:Cc:To:From; bh=ZkHW951EcvlKRgwnk8lLtbogl+mge00JxhboUAq9tIk=; b=HGNt8b 1wr9mfy6GAzqmpXnpL0af7qlLBz5U+Nf9/LCYCXOkQpVTMgdsbwiPlY+l2hOb3lGuo9Au3LAd9IAI 4FhCTGxpaMQYfpuNNIdZ8n7FPl/vGQWVyNoYDpiyc5pPmY4Rk7WooIKRWZ8bmwoJCUHUBFlURA/79 mzuAiSDtP8Y=; From: dmukhin@xen.org To: xen-devel@lists.xenproject.org Cc: andrew.cooper3@citrix.com, anthony.perard@vates.tech, jbeulich@suse.com, julien@xen.org, michal.orzel@amd.com, roger.pau@citrix.com, sstabellini@kernel.org, dmukhin@ford.com Subject: [PATCH v4] INSTALL: remove unsupported XEN_CONFIG_EXPERT from documentation Date: Tue, 20 Jan 2026 10:59:05 -0800 Message-ID: <20260120185904.979992-2-dmukhin@ford.com> X-Mailer: git-send-email 2.52.0 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @xen.org) X-ZM-MESSAGEID: 1768935591649158500 Content-Type: text/plain; charset="utf-8" From: Denis Mukhin =20 Remove XEN_CONFIG_EXPERT explanation and also correct information in the entire "Xen Hypervisor" section. Amends: 37339ba9ef46 ("automation: Remove XEN_CONFIG_EXPERT leftovers") Suggested-by: Stefano Stabellini Signed-off-by: Denis Mukhin --- Changes since v3: - text correction suggested by Jan - Link to v3: https://lore.kernel.org/xen-devel/20260120071654.640873-3-dmu= khin@ford.com/ --- INSTALL | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) diff --git a/INSTALL b/INSTALL index c2e756bf4b2b..fb9efe884fb1 100644 --- a/INSTALL +++ b/INSTALL @@ -25,19 +25,12 @@ Xen Hypervisor Xen itself is configured via a `kconfig' system borrowed from Linux. See https://www.kernel.org/doc/html/v5.4/kbuild/. =20 -Note that unlike with Linux, and contrary to that document, you cannot -look at Kconfig files, or the default or generated config files etc., -to find available configuration options. This is because it is only -supported (and security supported) by the Xen Project, to change a -small subset of the options. Attempts to change other options will be -silently overridden. The only way to find which configuration options -are available is to run `make menuconfig' or the like. - -You can counter-override this behaviour by setting XEN_CONFIG_EXPERT=3Dy -in your environment. However, doing this is not supported and the -resulting configurations do not receive security support. If you set -this variable there is nothing stopping you setting dangerously -experimental combinations of features - not even any warnings. +Only a subset of options is supported or security-supported by Xen +Project. You can explore all available options, including unsupported +ones and those recommended only for expert users, e.g. by using `make +menuconfig` and enabling `CONFIG_UNSUPPORTED` and/or `CONFIG_EXPERT`. +However, enabling these options is not supported, and configurations +resulting from them do not receive security support. =20 Options recognized by configure =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 2.52.0