Skip to contentSkip to conversation

ref-manual: variables.rst: document KERNEL_DANGLING_FEATURES_WARN_ONLY

PATCH In review [email protected] 2 participants 2 messages Apr 18, 2023 – Apr 19, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ref-manual: variables.rst: document KERNEL_DANGLING_FEATURES_WARN_ONLY

From: Michael Opdenacker <[email protected]>

---
 documentation/ref-manual/variables.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
documentation/ref-manual/variables.rst +14 -0
index 6a9dcfd5ba..2899bd78fc 100644
@@ -4420,6 +4420,20 @@ system and gives an overview of their function and contents.
       You can register custom kernel image types with the
       :ref:`ref-classes-kernel` class using this variable.
 
+   :term:`KERNEL_DANGLING_FEATURES_WARN_ONLY`
+      When kernel configuration fragments are missing for some
+      :term:`KERNEL_FEATURES` specified by layers or BSPs,
+      building and configuring the kernel stops with an error.
+    
+      You can turn these errors into warnings by setting the
+      following in ``conf/local.conf``::
+
+         KERNEL_DANGLING_FEATURES_WARN_ONLY = "1"
+    
+      You will still be warned that runtime issues may occur,
+      but at least the kernel configuration and build process will
+      be allowed to continue.
+
    :term:`KERNEL_DEBUG_TIMESTAMPS`
       If set to "1", enables timestamping functionality during building
       the kernel. The default is "0" to disable this for reproducibility
Signature · 1 line
2.34.1
Reviewed-by on v1 1/1
#1 lore raw
Quoted 21 lines · On Tue, Apr 18, 2023 at 1:10 PM <[email protected]> wrote:

From: Michael Opdenacker <[email protected]>

---
 documentation/ref-manual/variables.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
documentation/ref-manual/variables.rst +4 -0
index 6a9dcfd5ba..2899bd78fc 100644
@@ -4420,6 +4420,20 @@ system and gives an overview of their function and contents.
       You can register custom kernel image types with the
       :ref:`ref-classes-kernel` class using this variable.
 
+   :term:`KERNEL_DANGLING_FEATURES_WARN_ONLY`
+      When kernel configuration fragments are missing for some
+      :term:`KERNEL_FEATURES` specified by layers or BSPs,
+      building and configuring the kernel stops with an error.

documentation/ref-manual/variables.rst system and gives an overview of their function and contents. · line 4436

Quoted 10 lines
documentation/ref-manual/variables.rst +10 -0
+
+      You can turn these errors into warnings by setting the
+      following in ``conf/local.conf``::
+
+         KERNEL_DANGLING_FEATURES_WARN_ONLY = "1"
+
+      You will still be warned that runtime issues may occur,
+      but at least the kernel configuration and build process will
+      be allowed to continue.
+

Looks good to me.

Quoted 6 lines
documentation/ref-manual/variables.rst +0 -1
    :term:`KERNEL_DEBUG_TIMESTAMPS`
       If set to "1", enables timestamping functionality during building
       the kernel. The default is "0" to disable this for reproducibility
--

2.34.1

Signature · 3 lines
- Thou shalt not follow the NULL pointer, for chaos and madness await
thee at its end
- "Use the force Harry" - Gandalf, Star Trek II