kernel-dev: Add FAQ for how to use a vanilla kernel
PATCH 1/1 kernel-dev: Add FAQ for how to use a vanilla kernel
Adds a FAQ with explicit directions about how to build a vanilla kernel for a machine.
--- documentation/kernel-dev/kernel-dev-faq.rst | 49 +++++++++++++++++++++ 1 file changed, 49 insertions(+)
documentation/kernel-dev/kernel-dev-faq.rst +49 -0
@@ -79,3 +79,52 @@ following: APPEND += "printk.time=y initcall_debug debug" +How do I use a vanilla Linux kernel with my machine? +---------------------------------------------------- + +The simplest way to use a vanilla kernel is with the ``linux-yocto`` kernel +maintained by openembedded-core. Using this kernel is as simple as adding the +following to your machine.conf file: +:: + + # Use a defconfig provided by the kernel. If you are going to provide your + # own defconfig in SRC_URI as show below, you'll need to omit this line + KBUILD_DEFCONFIG = "multi_v7_defconfig" + + # Use default value for all symbols. This is usually what you want when + # providing a defconfig + KCONFIG_MODE = "alldefconfig" + + # Make linux-yocto provide the kernel + PREFERRED_PROVIDER_virtual/kernel = "linux-yocto" + + # If you want to use a specific version of the upstream kernel, uncomment + # and set this line, otherwise omit it to use the latest stable kernel + #PREFERRED_VERSION_linux-yocto = "5.8.%" + +You will also need to add a .bbappend in your BSP layer to amend the +linux-yocto recipe (e.g. recipes-kernel/linux/linux-yocto_%.bbappend): +:: + + FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" + + # Uncomment this line to provide your own defconfig file in your BSP layer: + # SRC_URI_append_my-machine = " file://defconfig" + + # Marks the recipe as compatible with your machine. Be sure to replace + # my-machine with the name of your machine + COMPATIBLE_MACHINE .= "|my-machine" + +You can also apply patches and config fragements in the bbappend if desired, +see :ref:`kernel-dev/kernel-dev-common:applying patches` and +:ref:`kernel-dev/kernel-dev-common:changing the configuration` in the Kernel +dev manual. It is recommended that you use ``_append_my-machine`` to prevent +these changes from inadverently leaking into other machine configurations + +.. note:: + You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel. +
Signature · 1 line
2.28.0
Quoted 55 lines · Joshua Watt
Adds a FAQ with explicit directions about how to build a vanilla kernel for a machine.
Signed-off-by Joshua Watt <[email protected]>--- documentation/kernel-dev/kernel-dev-faq.rst | 49 +++++++++++++++++++++ 1 file changed, 49 insertions(+)documentation/kernel-dev/kernel-dev-faq.rst +38
-0@@ -79,3 +79,52 @@ following: APPEND += "printk.time=y initcall_debug debug" +How do I use a vanilla Linux kernel with my machine? +---------------------------------------------------- + +The simplest way to use a vanilla kernel is with the ``linux-yocto`` kernel +maintained by openembedded-core. Using this kernel is as simple as adding the +following to your machine.conf file: +:: + + # Use a defconfig provided by the kernel. If you are going to provide your + # own defconfig in SRC_URI as show below, you'll need to omit this line + KBUILD_DEFCONFIG = "multi_v7_defconfig" + + # Use default value for all symbols. This is usually what you want when + # providing a defconfig + KCONFIG_MODE = "alldefconfig" + + # Make linux-yocto provide the kernel + PREFERRED_PROVIDER_virtual/kernel = "linux-yocto" + + # If you want to use a specific version of the upstream kernel, uncomment + # and set this line, otherwise omit it to use the latest stable kernel + #PREFERRED_VERSION_linux-yocto = "5.8.%" + +You will also need to add a .bbappend in your BSP layer to amend the +linux-yocto recipe (e.g. recipes-kernel/linux/linux-yocto_%.bbappend): +:: + + FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" + + # Uncomment this line to provide your own defconfig file in your BSP layer: + # SRC_URI_append_my-machine = " file://defconfig" + + # Marks the recipe as compatible with your machine. Be sure to replace + # my-machine with the name of your machine + COMPATIBLE_MACHINE .= "|my-machine" + +You can also apply patches and config fragements in the bbappend if desired, +see :ref:`kernel-dev/kernel-dev-common:applying patches` and
documentation/kernel-dev/kernel-dev-faq.rst following: · line 129
Quoted 10 lines
documentation/kernel-dev/kernel-dev-faq.rst +10
-0+:ref:`kernel-dev/kernel-dev-common:changing the configuration` in the Kernel +dev manual. It is recommended that you use ``_append_my-machine`` to prevent +these changes from inadverently leaking into other machine configurations + +.. note:: + You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel.
This is a lie. I thought it was the upstream mirror, but it's not. v5.8/base is the mirror and this one has a few extra patches.
Quoted 4 lines
documentation/kernel-dev/kernel-dev-faq.rst +1
-1+ --2.28.0
Hi Joshua,
Quoted 28 lines · Joshua Watt
Adds a FAQ with explicit directions about how to build a vanilla kernel for a machine.
Signed-off-by Joshua Watt <[email protected]>---
documentation/kernel-dev/kernel-dev-faq.rst| 49 +++++++++++++++++++++1 file changed, 49 insertions(+)documentation/kernel-dev/kernel-dev-faq.rst +4
-0@@ -79,3 +79,52 @@ following: APPEND += "printk.time=y initcall_debug debug" +How do I use a vanilla Linux kernel with my machine? +---------------------------------------------------- + +The simplest way to use a vanilla kernel is with the ``linux-yocto``kernel
+maintained by openembedded-core. Using this kernel is as simple as adding thedocumentation/kernel-dev/kernel-dev-faq.rst +4
-0+following to your machine.conf file: +:: + + # Use a defconfig provided by the kernel. If you are going to
Quoted 2 lines
provide your
+ # own defconfig inSRC_URIas show below, you'll need to omit this
s/show/shown/
documentation/kernel-dev/kernel-dev-faq.rst following: · line 97
Quoted 8 lines
line
documentation/kernel-dev/kernel-dev-faq.rst +3
-0+ KBUILD_DEFCONFIG = "multi_v7_defconfig" + + # Use default value for all symbols. This is usually what you wantwhen
documentation/kernel-dev/kernel-dev-faq.rst +3
-0+ # providing a defconfig + KCONFIG_MODE = "alldefconfig" +
KCONFIG_MODE is not explained in the Variables Glossary, could you please fix that?
Quoted 7 lines
documentation/kernel-dev/kernel-dev-faq.rst +4
-0+ # Make linux-yocto provide the kernel + PREFERRED_PROVIDER_virtual/kernel = "linux-yocto" + + # If you want to use a specific version of the upstream kernel,uncomment
+ # and set this line, otherwise omit it to use the latest stable
kernel
Here's to hoping that no layer with a higher priority provide their own linux-yocto :)
documentation/kernel-dev/kernel-dev-faq.rst following: · line 106
Quoted 4 lines
documentation/kernel-dev/kernel-dev-faq.rst +4
-0+ #PREFERRED_VERSION_linux-yocto = "5.8.%" + +You will also need to add a .bbappend in your BSP layer to amend the +linux-yocto recipe (e.g. recipes-kernel/linux/linux-yocto_%.bbappend):
``linux-yocto`` and the path in double tick too.
documentation/kernel-dev/kernel-dev-faq.rst following: · line 117
Quoted 13 lines
+::
documentation/kernel-dev/kernel-dev-faq.rst +4
-0+ + FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" + + # Uncomment this line to provide your own defconfig file in yourBSP layer:
documentation/kernel-dev/kernel-dev-faq.rst +3
-0+ # SRC_URI_append_my-machine = " file://defconfig" + + # Marks the recipe as compatible with your machine. Be sure toreplace
documentation/kernel-dev/kernel-dev-faq.rst +3
-0+ # my-machine with the name of your machine + COMPATIBLE_MACHINE .= "|my-machine" +
I don't think spaces matter in COMPATIBLE_MACHINE but happy to be proven otherwise. In that case, probably += would be better as it's usually what's used throughout the docs? As to not confuse beginners?
Quoted 1 line
+You can also apply patches and config fragements in the bbappend if
s/fragements/fragments/
Quoted 8 lines
desired,
+see :ref:kernel-dev/kernel-dev-common:applying patchesand +:ref:kernel-dev/kernel-dev-common:changing the configurationin the Kernel
+dev manual. It is recommended that you use ``_append_my-machine`` to prevent
+these changes from inadverently leaking into other machine configurations
Missing dot at the end of the sentence.
documentation/kernel-dev/kernel-dev-faq.rst following:
Quoted 3 lines
documentation/kernel-dev/kernel-dev-faq.rst +3
-0+ +.. note:: + You will notice that this is will still pull the kernel source
Not a native, but my doubts on "you will notice" being correct?
s/is//
documentation/kernel-dev/kernel-dev-faq.rst
Quoted 3 lines
from `the
documentation/kernel-dev/kernel-dev-faq.rst +2
-0+ Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_,
:yocto_git:the Yocto Kernel git repo </cgit/cgit.cgi/linux-yocto/>
Thanks,
Quentin
Signature · 1 line
Sent from my Android device with K-9 Mail. Please excuse my brevity.
Hi,
Quoted 11 lines · Joshua Watt
documentation/kernel-dev/kernel-dev-faq.rst following: · line 129
Quoted 6 lines · Joshua Watt
+.. note::
documentation/kernel-dev/kernel-dev-faq.rst +5
-0+ You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel.This is a lie. I thought it was the upstream mirror, but it's not. v5.8/base is the mirror and this one has a few extra patches.
And exactly because only Bruce knows (most of the time) what is in all those funny branches why not use upstream (kernel.org) for a vanilla kernel?
Regards,
Robert
Quoted 12 lines · On Tue, Oct 20, 2020 at 5:05 PM Robert [email protected]…
Hi,
Quoted 8 lines · Joshua Watt
Quoted 6 lines · Joshua Watt
+.. note::
documentation/kernel-dev/kernel-dev-faq.rst +5
-0+ You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel.
Quoted 7 lines
Quoted 3 lines
This is a lie. I thought it was the upstream mirror, but it's not. v5.8/base is the mirror and this one has a few extra patches.
And exactly because only Bruce knows (most of the time) what is in all those funny branches why not use upstream (kernel.org) for a vanilla kernel?
We are documented how the single linux-yocto repository can be used to track tip (master), or any of the -stable upstream kernels (<version>/base), or the yocto specifics (<version>/standard/base), without needing to create 'x' recipes to do it. It is just a branch switch away.
Someone can always use upstream in their own kernel recipe, we are just using this doc to describe what's in oe-core itself.
Bruce
Quoted 3 lines
Regards,
Robert
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
Quoted 23 lines · Bruce Ashfield
Quoted 12 lines · On Tue, Oct 20, 2020 at 5:05 PM Robert [email protected]…
Hi,
Quoted 8 lines · Joshua Watt
Quoted 6 lines · Joshua Watt
+.. note::
documentation/kernel-dev/kernel-dev-faq.rst +5
-0+ You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel.Quoted 7 lines
Quoted 3 lines
This is a lie. I thought it was the upstream mirror, but it's not. v5.8/base is the mirror and this one has a few extra patches.
And exactly because only Bruce knows (most of the time) what is in all those funny branches why not use upstream (kernel.org) for a vanilla kernel?
Quoted 8 lines
We are documented how the single linux-yocto repository can be used to track tip (master), or any of the -stable upstream kernels (<version>/base), or the yocto specifics (<version>/standard/base), without needing to create 'x' recipes to do it. It is just a branch switch away.
Someone can always use upstream in their own kernel recipe, we are just using this doc to describe what's in oe-core itself.
There is a lot at play here; IMHO, using the branches Bruce maintains is actually the best option (if you can use it) because those branches are tested; I assume he's not making changes and diverging from upstream for the fun of it; the changes fix actual bugs. For example, I converted meta-rockchip to use the standard/base branches, and really haven't had to worry about it since; I have pretty high confidence those are going to continue to just work. meta-rockchip gets to freeload off of Bruce's hard work to upgrade the kernel and stays relatively up-to-date without much effort on my part :)
OOTH, I get that people really just want to use the vanilla kernel (even though they probably *also* want the changes Bruce made), and it certainly "feels" like a better story if we can do that. As Bruce pointed out, you can do that by setting KBRANCH to the <version>/base branch. I think the part that's missing there is that you also have to set SRCREV to a SHA1 on the branch, probably with some strange override? Maybe SRCREV_machine_pn-linux-yocto = "..." ? And, if you do that, I think the other problem is that LINUX_VERSION will then be wrong, so you might need to override that also. This also means that you don't get the latest versions "automatically" since you have to manually bump the SRCREV. In general it seems really easy for the linux-yocto recipes to get out of sync with your settings and cause confusion. We could maybe figure out a way to have a SRCREV for the upstream branch in the linux-yocto recipes, but it's weird and problematic to have a SRCREV pointing to something that's not tested (back the the point of why we have the "standard" branches in the first place, they are tested and work).
Quoted 13 lines
Bruce
Quoted 3 lines
Regards,
Robert
--
- Thou shalt not follow the NULL pointer, for chaos and madness await thee at its end
- "Use the force Harry" - Gandalf, Star Trek II
Quoted 58 lines · Joshua Watt
Quoted 57 lines · Joshua Watt
Adds a FAQ with explicit directions about how to build a vanilla kernel for a machine.
Signed-off-by Joshua Watt <[email protected]>--- documentation/kernel-dev/kernel-dev-faq.rst | 49 +++++++++++++++++++++ 1 file changed, 49 insertions(+)documentation/kernel-dev/kernel-dev-faq.rst +41
-0@@ -79,3 +79,52 @@ following: APPEND += "printk.time=y initcall_debug debug" +How do I use a vanilla Linux kernel with my machine? +---------------------------------------------------- + +The simplest way to use a vanilla kernel is with the ``linux-yocto`` kernel +maintained by openembedded-core. Using this kernel is as simple as adding the +following to your machine.conf file: +:: + + # Use a defconfig provided by the kernel. If you are going to provide your + # own defconfig in SRC_URI as show below, you'll need to omit this line + KBUILD_DEFCONFIG = "multi_v7_defconfig" + + # Use default value for all symbols. This is usually what you want when + # providing a defconfig + KCONFIG_MODE = "alldefconfig" + + # Make linux-yocto provide the kernel + PREFERRED_PROVIDER_virtual/kernel = "linux-yocto" + + # If you want to use a specific version of the upstream kernel, uncomment + # and set this line, otherwise omit it to use the latest stable kernel + #PREFERRED_VERSION_linux-yocto = "5.8.%" + +You will also need to add a .bbappend in your BSP layer to amend the +linux-yocto recipe (e.g. recipes-kernel/linux/linux-yocto_%.bbappend): +:: + + FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" + + # Uncomment this line to provide your own defconfig file in your BSP layer: + # SRC_URI_append_my-machine = " file://defconfig" + + # Marks the recipe as compatible with your machine. Be sure to replace + # my-machine with the name of your machine + COMPATIBLE_MACHINE .= "|my-machine" + +You can also apply patches and config fragements in the bbappend if desired, +see :ref:`kernel-dev/kernel-dev-common:applying patches` and +:ref:`kernel-dev/kernel-dev-common:changing the configuration` in the Kernel +dev manual. It is recommended that you use ``_append_my-machine`` to prevent +these changes from inadverently leaking into other machine configurations
Quoted 8 lines
documentation/kernel-dev/kernel-dev-faq.rst following: · line 129
Quoted 7 lines
documentation/kernel-dev/kernel-dev-faq.rst +7
-0+ +.. note:: + You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel.This is a lie.
No. You listen to this old man ; )
was I close?
-Armin
Quoted 10 lines
I thought it was the upstream mirror, but it's not.
v5.8/base is the mirror and this one has a few extra patches.Quoted 7 lines
documentation/kernel-dev/kernel-dev-faq.rst +1
-1+ --2.28.0
Quoted 18 lines · Bruce Ashfield
Quoted 10 lines · On Tue, Oct 20, 2020 at 5:05 PM Robert [email protected]…
Hi,
Quoted 7 lines · Joshua Watt
Quoted 6 lines · Joshua Watt
+.. note::
documentation/kernel-dev/kernel-dev-faq.rst +5
-0+ You will notice that this is will still pull the kernel source from `the + Yocto Kernel git repo + <https://git.yoctoproject.org/cgit/cgit.cgi/linux-yocto/>`_, however it is + using the default value for :term:`KBRANCH` (e.g. ``"v5.8/standard/base"``) + which is an exact mirror of the upstream kernel.Quoted 6 lines
Quoted 3 lines
This is a lie. I thought it was the upstream mirror, but it's not. v5.8/base is the mirror and this one has a few extra patches.
And exactly because only Bruce knows (most of the time) what is in all those funny branches why not use upstream (kernel.org) for a vanilla kernel?
Quoted 8 lines
We are documented how the single linux-yocto repository can be used to track tip (master), or any of the -stable upstream kernels (<version>/base), or the yocto specifics (<version>/standard/base), without needing to create 'x' recipes to do it. It is just a branch switch away.
Someone can always use upstream in their own kernel recipe, we are just using this doc to describe what's in oe-core itself.
this is what I just did for the meta-odroid.
https://gitlab.com/akuster/meta-odroid/-/blob/master/recipes-kernel/linux/linux-yocto_5.8.bbappend
It you don't have your own kernel fragments, it could be simpler.
-armin
Quoted 9 lines
Bruce
Quoted 1 line
Robert