From nobody Mon Jan 26 07:40:44 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=1768893498; cv=none; d=zohomail.com; s=zohoarc; b=HG6CtD5kKm4zCjLQvSAF2tgV2W6/DpMFqpuKEK4/U1FJOADgHdlCazrwdlRJHyeZzSIlHe6k4QlbaWw0Tj+D+kUlmbmR7S5S8drxpFNC4I3D/1EThB4Rn3QpTAsO/ymZOz4B1gBouiFwQUCzdTfwzkWYJ3cUDec97x4fkEVf9jw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1768893498; 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=pKv7ArlF2h8gshpBz8SQSzsZjNvWC9ePOUcC6f6+vYs=; b=MnsuSDK/G2V9XSJd2yPZVPsHiETOTFGzcu1hmwFjB+hpETo8gJBLE74Erjt3/pHzxX5a2Xt4cB9g+vW5YvjFnMSifyDZfwiY61vtlUHmAvgWV0APgDXRftQaPVm1OIjFqMXgZIu7tGQaaL9c4fo/wlT5HfpQ4vcVe68nOtlmvIU= 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 1768893498371424.765285754238; Mon, 19 Jan 2026 23:18:18 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.1208398.1520559 (Exim 4.92) (envelope-from ) id 1vi5zk-0005ia-SP; Tue, 20 Jan 2026 07:17:44 +0000 Received: by outflank-mailman (output) from mailman id 1208398.1520559; Tue, 20 Jan 2026 07:17:44 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1vi5zk-0005iT-Pe; Tue, 20 Jan 2026 07:17:44 +0000 Received: by outflank-mailman (input) for mailman id 1208398; Tue, 20 Jan 2026 07:17:43 +0000 Received: from mail.xenproject.org ([104.130.215.37]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1vi5zj-0005iN-OW for xen-devel@lists.xenproject.org; Tue, 20 Jan 2026 07:17:43 +0000 Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.96) (envelope-from ) id 1vi5zj-00Cd7n-1N; Tue, 20 Jan 2026 07:17:43 +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 1vi5zi-00B9Gz-2f; Tue, 20 Jan 2026 07:17:43 +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=pKv7ArlF2h8gshpBz8SQSzsZjNvWC9ePOUcC6f6+vYs=; b=fqCAX5 x5ojsDobFg+W5C3nbGSSGsmyDUjaOm0WBukIaUZRnOLFsA8V5lSby+/aamd5HMswdrlFlZfwrYvTH CMbjLAZPLr5uOKDIvnbj5V6onXxWjbI9zMiiE0zYquW6LsaQ1UeYE69xVrNW6soBZKk9K/Crh0g1V Dpzx9EEBArk=; 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 v3] INSTALL: remove unsupported XEN_CONFIG_EXPERT from documentation Date: Mon, 19 Jan 2026 23:16:56 -0800 Message-ID: <20260120071654.640873-3-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: 1768893500166158500 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 Acked-by: Jan Beulich --- Changes since v2: - Applied suggested edits to the entire section suggested by Stefano - Link to v2: https://lore.kernel.org/xen-devel/20260116030842.415583-2-dmu= khin@ford.com/ --- INSTALL | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) diff --git a/INSTALL b/INSTALL index c2e756bf4b2b..670cbc2fa3b8 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, 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