github/linuxkit
1
0
Fork 0
mirror of https://github.com/linuxkit/linuxkit.git synced 2025-07-20 17:49:10 +00:00
Code Issues Projects Releases Wiki Activity

docs: Add a section on custom kernel builds

Browse Source 
fixes #1835

Signed-off-by: Rolf Neugebauer <rolf.neugebauer@docker.com>
This commit is contained in:
Rolf Neugebauer 2017-05-16 10:07:21 +01:00
parent 9fd743a28f
commit 6c4722d4a9
1 changed files with 21 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/kernels.md
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