Skip to content

Commit 2ad7ca7

Browse files
committed
doc: update Readme.md about how to use kernel quilt release
Signed-off-by: Lili Li <[email protected]>
1 parent 0237280 commit 2ad7ca7

File tree

1 file changed

+71
-3
lines changed

1 file changed

+71
-3
lines changed

Readme.md

Lines changed: 71 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,75 @@
1-
This repository contains Intel's Linux LTS quilt releases.
1+
### Introduction
22

3-
GPG Signed Releases
4-
-------------------
3+
This repository contains Intel's Linux LTS and mainline kernel quilt releases.
4+
5+
Kernel quilt release 'patches' folder include a quilt series file and all kernel patches mentioned in the series file.\
6+
kernel patches are grouped by feature, example:
7+
8+
```
9+
#series file for v6.12.40 linux kernel
10+
# d90ecb2b1308b Linux 6.12.40
11+
#sriov
12+
0001-drm-i915-mtl-Add-C10-table-for-HDMI-Clock-25175.sriov
13+
0002-drm-i915-mtl-Copy-c10-phy-pll-sw-state-from-master-t.sriov
14+
0003-drm-i915-guc-Define-MAX_DWORDS-for-CTB-HXG-Message.sriov
15+
0004-drm-i915-call-taint_for_CI-on-FLR-failure.sriov
16+
...
17+
#security
18+
0001-mei-bus-add-api-to-query-capabilities-of-ME-clien.security
19+
...
20+
```
21+
22+
### How to use quilt release
23+
24+
Step 1: clone and checkout quilt release, lts-v6.12.40-linux-250728T040815Z as example:
25+
26+
```
27+
$ git clone https://github.com/intel/linux-intel-quilt.git linux-intel-quilt
28+
$ cd linux-intel-quilt
29+
$ git checkout lts-v6.12.40-linux-250728T040815Z -b my/v6.12.40
30+
```
31+
32+
Step 2: use 'cat patches/series |head -n2' to get the base kernel version and HEAD, lts-v6.12.40-linux-250728T040815Z as example:
33+
34+
```
35+
$ cat patches/series |head -n2
36+
# Series file for v6.12.40 linux kernel
37+
# d90ecb2b1308b Linux 6.12.40
38+
```
39+
40+
Step 3: clone base kernel from community [stable](https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git) or [mainline](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git). Continue use above tag as example:
41+
42+
```
43+
$ cd ..
44+
$ git clone https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git kernel-src
45+
$ cd kernel-src
46+
$ git checkout v6.12.40 -b my/v6.12.40
47+
$ cp -r ../linux-intel-quilt/patches .
48+
```
49+
50+
Step 4: use quilt or git quiltimport to apply kernel patches to your branch.
51+
52+
quilt example:
53+
```
54+
$ quilt push -a
55+
```
56+
57+
git quiltimport example:
58+
```
59+
$ git quiltimport
60+
```
61+
62+
Step 5: modify your kernel configuration with 'make menuconfig' or copy from your existing configuration and 'make bindeb-pkg' to build this kernel.
63+
64+
65+
Note: If you don't want apply all the patches, you can also modify the series file to remove patches/features before applying.
66+
67+
### Reference kernel overlay repository
68+
69+
You can also use our kernel overlay release to build the kernel instead of apply quilt series by yourself.\
70+
You can find reference kernel configuration, kernel patch series and build scripts from this [linux kernel overlay release repository](https://github.com/intel/linux-kernel-overlay).
71+
72+
### GPG Signed Releases
573

674
i) Check if a release tag is GPG-signed or not
775

0 commit comments

Comments
 (0)