diff mbox series

[yocto-docs,v2,01/14] ref-manual/variables: document the KERNEL_CONSOLE variable

Message ID 20241220-release-note-5-2-updates-v2-1-df29527f3fc5@bootlin.com
State Accepted
Headers show
Series Updates from recent core changes | expand

Commit Message

Antonin Godard Dec. 20, 2024, 12:16 p.m. UTC
This variables holds the value of the `console` kernel command line
parameter.

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

Comments

Quentin Schulz Jan. 14, 2025, 10:28 a.m. UTC | #1
Hi Antonin,

On 12/20/24 1:16 PM, Antonin Godard wrote:
> This variables holds the value of the `console` kernel command line
> parameter.
> 
> Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/ref-manual/variables.rst | 13 +++++++++++++
>   1 file changed, 13 insertions(+)
> 
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index e8db89f8c9642b1e36c574e1369093a7a2ce30a4..b31abeced4cc9b692f8bed814891a267c73f29b7 100644
> --- a/documentation/ref-manual/variables.rst
> +++ b/documentation/ref-manual/variables.rst
> @@ -4578,6 +4578,19 @@ 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_CONSOLE`
> +     The :term:`KERNEL_CONSOLE` variable holds the value of the ``console``
> +     parameter of the kernel command line and can be used in places such as a
> +     ``wks`` description file for :ref:`Wic images <dev-manual/wic:creating
> +     partitioned images using wic>`.
> +
> +     The default value of this variable is extracted from the first console
> +     device and setting in :term:`SERIAL_CONSOLES`. If nothing is found in
> +     :term:`SERIAL_CONSOLES`, the default value is set to ``ttyS0,115200``).
> +

Missing opening parenthesis (or spurious closing parenthesis) :)

Cheers,
Quentin
diff mbox series

Patch

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index e8db89f8c9642b1e36c574e1369093a7a2ce30a4..b31abeced4cc9b692f8bed814891a267c73f29b7 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -4578,6 +4578,19 @@  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_CONSOLE`
+     The :term:`KERNEL_CONSOLE` variable holds the value of the ``console``
+     parameter of the kernel command line and can be used in places such as a
+     ``wks`` description file for :ref:`Wic images <dev-manual/wic:creating
+     partitioned images using wic>`.
+
+     The default value of this variable is extracted from the first console
+     device and setting in :term:`SERIAL_CONSOLES`. If nothing is found in
+     :term:`SERIAL_CONSOLES`, the default value is set to ``ttyS0,115200``).
+
+     For more information, see the `Kernel command-line documentation
+     <https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html>`__.
+
    :term:`KERNEL_DANGLING_FEATURES_WARN_ONLY`
       When kernel configuration fragments are missing for some
       :term:`KERNEL_FEATURES` specified by layers or BSPs,