Merge pull request #1838 from rneugeba/kerndoc

docs: Add a section on custom kernel builds
This commit is contained in:
Justin Cormack 2017-05-16 13:24:08 +01:00 committed by GitHub
commit 1fa78e42d4

View File

@ -65,6 +65,27 @@ file. [kmod.yml](../tests/kmod/kmod.yml) contains an example for the
configuration. configuration.
## Building and using custom kernels
To build and test locally modified kernels, e.g., to try a different
kernel config or new patches, the existing kernel build system in the
[`./kernel`](./kernel) can be re-used. For example, assuming the
current 4.9 kernel is 4.9.28, you can build a local kernel with:
```
make build_4.9.28 HASH=foo
```
This will create a local kernel image called
`linuxkit/kernel:4.9.28-foo` which you can use in your YAML file as:
```
kernel:
image: "linuxkit/kernel:4.9.28-foo"
```
If you have more substantial changes, or require a different kernel
version, it's best to replicate the kernel build system and change the
Docker Hub organisation to your own.
## Working with Linux kernel patches for LinuxKit ## Working with Linux kernel patches for LinuxKit
We may apply patches to the Linux kernel used in LinuxKit, primarily to We may apply patches to the Linux kernel used in LinuxKit, primarily to