[bootlin/training-materials] 89a5f1: kernel: modules: Put the description of out-of-tre...

Wed Nov 10 11:09:38 CET 2021

  Branch: refs/heads/master
  Home:   https://github.com/bootlin/training-materials
  Commit: 89a5f15c60f98ac0226e2b4fd54077b81424831c
      https://github.com/bootlin/training-materials/commit/89a5f15c60f98ac0226e2b4fd54077b81424831c
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-driver-development-modules/kernel-driver-development-modules.tex

  Log Message:
  -----------
  kernel: modules: Put the description of out-of-tree right next to the term

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 4c83ed01263eb5da3e45794ee9b5170a5dedeb77
      https://github.com/bootlin/training-materials/commit/4c83ed01263eb5da3e45794ee9b5170a5dedeb77
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-driver-development-modules/kernel-driver-development-modules.tex

  Log Message:
  -----------
  kernel: modules: There is not advantage to use an out-of-tree module, they are a pain, period

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: f5feb687f37de72cc901cb5b107223bb6c9d192b
      https://github.com/bootlin/training-materials/commit/f5feb687f37de72cc901cb5b107223bb6c9d192b
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-driver-development-modules/kernel-driver-development-modules.tex

  Log Message:
  -----------
  kernel: modules: Rework a little bit the out-of-tree vs in-tree slide

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 5cf5a0af99c8157659bf15c62d1d0a6893d315b8
      https://github.com/bootlin/training-materials/commit/5cf5a0af99c8157659bf15c62d1d0a6893d315b8
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-resources-references/kernel-resources-references.tex
    A slides/kernel-resources-references/linux-kernel-in-a-nutshell.jpg
    R slides/sysdev-linux-intro-modules/linux-kernel-in-a-nutshell.jpg
    M slides/sysdev-linux-intro-modules/sysdev-linux-intro-modules.tex

  Log Message:
  -----------
  Move the reference to 'Kernel in a Nutshell' to the end of the slide deck

This book is very old now, we can still give it as a reference with the
other books at the end of the slide deck but it makes no sense to keep
it here, in the middle of the slides.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 468620a7a380298ad76fbfab022e3fdf7d6a1b8c
      https://github.com/bootlin/training-materials/commit/468620a7a380298ad76fbfab022e3fdf7d6a1b8c
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-source-code-drivers/kernel-source-code-drivers.tex

  Log Message:
  -----------
  kernel: modules: Getting free contributions is not directly related to the licence

You get free contributions when you mainline your drivers not because
you decide to use the GPL. This is the purpose of the next slide and
this advantage is already listed, so drop the sentence here.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 4487d19404bc2f9417d1e35e404e2c677a28265a
      https://github.com/bootlin/training-materials/commit/4487d19404bc2f9417d1e35e404e2c677a28265a
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-source-code-drivers/kernel-source-code-drivers.tex

  Log Message:
  -----------
  kernel: sources: Rework the slide about in-tree drivers

This slide is more advertising the benefits of mainlining code more than
organizing code. "in-tree" drivers do not mean that they are upstream
(that was the purpose of one of the previous slides). Here we are
talking about mainline code so rename the slide. Also rework a little
bit the list of advantages, getting contributions from customers is
anecdotal, getting reviews is actually useful and should be seen
positively, a mainline driver will not suffer from API changes and will
be compatible with all the kernel versions onward.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 4fb97e09e5b3143e2a5b38c5eb460c17cacd065e
      https://github.com/bootlin/training-materials/commit/4fb97e09e5b3143e2a5b38c5eb460c17cacd065e
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/kernel-source-code-drivers/kernel-source-code-drivers.tex

  Log Message:
  -----------
  kernel: sources: There is no use of getting a userspace driver swapped out

So let's drop that "advantage".

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 99a248f6c017fdaf7d02d745787e0357e2a2cfee
      https://github.com/bootlin/training-materials/commit/99a248f6c017fdaf7d02d745787e0357e2a2cfee
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: make help is an interesting target, make it an item on its own

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: d63014c20adcc6666962030e8db456b0bf2b1e01
      https://github.com/bootlin/training-materials/commit/d63014c20adcc6666962030e8db456b0bf2b1e01
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: linux-4.14.x/ is not an up-to-date directory name so use linux/ instead

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: a2a9f45041ae976c319e8498179b79ef8de22dc1
      https://github.com/bootlin/training-materials/commit/a2a9f45041ae976c319e8498179b79ef8de22dc1
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Simplify a sentence to make more room for the rest of the slide

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 2e87e8c999c3a901c205bf424c728c918e8a5318
      https://github.com/bootlin/training-materials/commit/2e87e8c999c3a901c205bf424c728c918e8a5318
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Reword a bit the slide about the default configurations to make it more generic

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 813fd0086e82b07cf0a2eb8faf386fbf7d4d4cce
      https://github.com/bootlin/training-materials/commit/813fd0086e82b07cf0a2eb8faf386fbf7d4d4cce
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Clearly show the specificity of ARM64 about defconfigs

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 663538c33e2a0ce5fc2a5aacd45f8343fc526048
      https://github.com/bootlin/training-materials/commit/663538c33e2a0ce5fc2a5aacd45f8343fc526048
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Explain when/how to change the configuration better

Reword the slide so that it appears logical that the user must:
- pick a default configuration (previous slide)
- change the configuration
- save it and overwrite its .config
- make a default configuration file if he wants to save it properly

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: b12283760ed5edc59778663d96e37b60f3492cc2
      https://github.com/bootlin/training-materials/commit/b12283760ed5edc59778663d96e37b60f3492cc2
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    R slides/sysdev-kernel-building/gconfig-screenshot.png
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: configuration: Drop the slide about gconfig, this tool is purely useless

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 8e1d1463d0522916600aadba57ff65c0e1685d34
      https://github.com/bootlin/training-materials/commit/8e1d1463d0522916600aadba57ff65c0e1685d34
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    R slides/sysdev-kernel-building/nconfig-screenshot.png
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: configuration: Drop the slide about nconfig, this tool is purely useless

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 29c488026fcba18bcefc5df0dccfe86c03f2ba71
      https://github.com/bootlin/training-materials/commit/29c488026fcba18bcefc5df0dccfe86c03f2ba71
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: configuration: Don't list over and over again the configuration tools

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 09211230db4873660c68b96e7b464f8b8f377dd5
      https://github.com/bootlin/training-materials/commit/09211230db4873660c68b96e7b464f8b8f377dd5
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: move vmlinux to the bottom of the list

This file is rather useless, so don't show it first in the list.

Clément told me that Barebox had support for an ELF loader, meaning that
this file can be booted. Updated its description accordingly.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 5852218522cf1ec4f294a98ab0340f17d6c4bceb
      https://github.com/bootlin/training-materials/commit/5852218522cf1ec4f294a98ab0340f17d6c4bceb
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Cosmetic change about device tree blobs

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 7a71549b9ba8f1fd37e55c655bf84fb775785009
      https://github.com/bootlin/training-materials/commit/7a71549b9ba8f1fd37e55c655bf84fb775785009
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Image is the base file so put it first in the list

Also harmonize the wording to clarify the slide.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: a3ebf106304978c9a659ffe87dec1ee1353e1929
      https://github.com/bootlin/training-materials/commit/a3ebf106304978c9a659ffe87dec1ee1353e1929
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: DT: Harmonize the slide name with the other files

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: a85ef442e4fafaacb1fc340498005fca61466743
      https://github.com/bootlin/training-materials/commit/a85ef442e4fafaacb1fc340498005fca61466743
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: DT: Drop a detail about DT support

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: d9b4237a8d33bb2b80c9f6615627e57695e52b8f
      https://github.com/bootlin/training-materials/commit/d9b4237a8d33bb2b80c9f6615627e57695e52b8f
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: DT: Drop a superfluous slide about DT customization

Besides the fact that DT is useful for declaring the hardware and its
integration, this slide gives details about:
- the pin muxing which will be addressed later
- the tanzilli tool which is rather useless
- the flash partitions which really are an implementation detail (and
  now is legacy and must be kept)
- the command line which has already been addressed
- a talk given by Thomas which is also mentioned later in the slides.

Add an item to the previous slide just not to loose too much information
and simply drop that slide entirely.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

  Commit: 7569ea8ca68c200ecc51919357af23a852811f86
      https://github.com/bootlin/training-materials/commit/7569ea8ca68c200ecc51919357af23a852811f86
  Author: Miquel Raynal <miquel.raynal at bootlin.com>
  Date:   2021-11-10 (Wed, 10 Nov 2021)

  Changed paths:
    M slides/sysdev-kernel-building/sysdev-kernel-building.tex

  Log Message:
  -----------
  sysdev/kernel: building: Fully rework the slide about the cmdline

The original purpose of this slide was to explain how the kernel was
getting its cmdline.

While explaining that the kernel configuration has an impact on the
cmdline might be worth keeping, I do not think it is wise to talk about
device tree overlays, U-Boot fixing the DT and so on. In particular
because device tree will be addressed later in the training(s). Here, we
are just explaining how to boot the kernel with U-Boot, nothing more,
it's important to keep this portion short and clear, so let's not bother
with too much detail. Plus, U-boot natively does noting of all of that,
it's usually a user input/script more than a core/automated feature.

The reference to DT fixups is the slide title is dropped, if fixups and
overlays need to be explained, this should be a dedicatd slide among the
existing device tree slides comming next.

Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>

Compare: https://github.com/bootlin/training-materials/compare/2f5de50a2899...7569ea8ca68c