[Xen-changelog] [xen master] INSTALL: Mention kconfig

[patchbot@xxxxxxx]

commit f7fb9a0aa9fbb81292e1626ce40340d3f6d8d505
Author:     Ian Jackson <ian.jackson@xxxxxxxxxx>
AuthorDate: Tue Feb 4 09:34:24 2020 +0000
Commit:     Wei Liu <wl@xxxxxxx>
CommitDate: Tue Feb 4 11:31:14 2020 +0000

    INSTALL: Mention kconfig
    
    Firstly, add a reference to the documentation for the kconfig system.
    
    Secondly, warn the user about the XEN_CONFIG_EXPERT problem.
    
    Signed-off-by: Ian Jackson <ian.jackson@xxxxxxxxxx>
    Reviewed-by: Doug Goldstein <cardoe@xxxxxxxxxx>
    Acked-by: Jan Beulich <jbeulich@xxxxxxxx>
---
 INSTALL | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/INSTALL b/INSTALL
index aa08562b8a..72dc4b67dd 100644
--- a/INSTALL
+++ b/INSTALL
@@ -19,6 +19,26 @@ following compile process. Once configure is done, make(1) 
has to be
 called. Also make(1) recognizes certain arguments. The following sections
 will give an overview.
 
+Xen Hypervisor
+==============
+
+Xen itself is configured via a `kconfig' system borrowed from Linux.
+See docs/misc/kconfig.txt.
+
+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=y
+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.
+
 Options recognized by configure
 ===============================
 
--
generated by git-patchbot for /home/xen/git/xen.git#master

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/xen-changelog