Skip to content

Commit 80ff4a1

Browse files
pb8oShadowCurse
authored andcommitted
chore(docs/linux-4.14): update documentation
We are dropping support for Linux 4.14 so reflect it in the docs. Signed-off-by: Pablo Barbáchano <[email protected]>
1 parent b821a1f commit 80ff4a1

File tree

7 files changed

+20
-18
lines changed

7 files changed

+20
-18
lines changed

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,14 @@ and this project adheres to
1414

1515
### Deprecated
1616

17+
### Removed
18+
19+
- [#4689](https://github.com/firecracker-microvm/firecracker/pull/4689): Drop
20+
support for host kernel 4.14. Linux 4.14 reached end-of-life in
21+
[January 2024](https://lore.kernel.org/lkml/2024011046-ecology-tiptoeing-ce50@gregkh/).
22+
The minimum supported kernel now is 5.10. Guest kernel 4.14 is still
23+
supported.
24+
1725
### Fixed
1826

1927
## \[1.8.0\]
@@ -140,10 +148,12 @@ and this project adheres to
140148
supported snapshot version format. This change renders all previous
141149
Firecracker snapshots (up to Firecracker version v1.6.0) incompatible with the
142150
current Firecracker version.
151+
143152
- [#4449](https://github.com/firecracker-microvm/firecracker/pull/4449): Added
144153
information about page size to the payload Firecracker sends to the UFFD
145154
handler. Each memory region object now contains a `page_size_kib` field. See
146155
also the [hugepages documentation](docs/hugepages.md).
156+
147157
- [#4498](https://github.com/firecracker-microvm/firecracker/pull/4498): Only
148158
use memfd to back guest memory if a vhost-user-blk device is configured,
149159
otherwise use anonymous private memory. This is because serving page faults of

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -132,9 +132,9 @@ We test all combinations of:
132132

133133
| Instance | Host OS & Kernel | Guest Rootfs | Guest Kernel |
134134
| :-------- | :---------------- | :----------- | :----------- |
135-
| c5n.metal | al2 linux_4.14 | ubuntu 22.04 | linux_4.14 |
136-
| m5n.metal | al2 linux_5.10 | | linux_5.10 |
137-
| m6i.metal | al2023 linux_6.1 | | |
135+
| c5n.metal | al2 linux_5.10 | ubuntu 22.04 | linux_4.14 |
136+
| m5n.metal | al2023 linux_6.1 | | linux_5.10 |
137+
| m6i.metal | | | |
138138
| m6a.metal | | | |
139139
| m6g.metal | | | |
140140
| m7g.metal | | | |

docs/kernel-policy.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ We are continuously validating the currently supported Firecracker releases (as
99
per [Firecracker’s release policy](../docs/RELEASE_POLICY.md)) using a
1010
combination of:
1111

12-
- host linux kernel versions 4.14, 5.10, and 6.1;
12+
- host linux kernel versions 5.10, and 6.1;
1313
- guest linux kernel versions 4.14, and 5.10.
1414

1515
While other versions and other kernel configs might work, they are not
@@ -23,7 +23,6 @@ release only if compatibility changes are required.
2323

2424
| Host kernel | Guest kernel v4.14 | Guest kernel v5.10 | Min. end of support |
2525
| ----------: | :----------------: | :----------------: | ------------------: |
26-
| v4.14 | Y | Y | 2021-01-22 |
2726
| v5.10 | Y | Y | 2024-01-31 |
2827
| v6.1 | Y | Y | 2025-10-12 |
2928

@@ -121,10 +120,6 @@ following configurations:
121120

122121
## Caveats
123122

124-
- When using a 4.14 host and a 5.10 guest, we disable the SVE extension in the
125-
guest. This is due to the introduction of the SVE extension in Graviton3,
126-
which causes the default 5.10 guest (with SVE support enabled), to crash if
127-
run with a 4.14 host which does not support SVE.
128123
- [Snapshot compatibility across kernel versions](snapshotting/snapshot-support.md#snapshot-compatibility-across-kernel-versions)
129124
- When booting with kernels that support both ACPI and legacy boot mechanisms
130125
Firecracker passes VirtIO devices to the guest twice, once through ACPI and a

docs/snapshotting/handling-page-faults-on-snapshot-resume.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ descriptor object (UFFD).
2424

2525
### Creating a UFFD object
2626

27-
#### Kernels 4.14 and 5.10
27+
#### Kernel 5.10
2828

29-
For (host) kernels 4.14 and 5.10 UFFD objects are created by calling into
29+
For host kernel 5.10 UFFD objects are created by calling into
3030
[`userfaultfd` syscall](https://man7.org/linux/man-pages/man2/userfaultfd.2.html).
3131

3232
#### Kernel 6.1

docs/snapshotting/snapshot-support.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -664,8 +664,6 @@ m6i won't work on an m6g instance.
664664

665665
| *CPU family* | *taken on host kernel* | *restored on host kernel* | *working?* |
666666
| ------------ | ---------------------- | ------------------------- | ---------- |
667-
| **x86_64** | 4.14 | 5.10 | Y |
668-
| **all** | 5.10 | 4.14 | N |
669667
| **all** | 5.10 | 6.1 | Y |
670668
| **all** | 6.1 | 5.10 | Y |
671669

docs/snapshotting/versioning.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -85,10 +85,9 @@ The current implementation relies on the
8585

8686
### Host kernel
8787

88-
The minimum kernel version required by Firecracker snapshots is 4.14. Snapshots
89-
can be saved and restored on the same kernel version without any issues. There
90-
might be issues when restoring snapshots created on different host kernel
91-
version even when using the same Firecracker version.
88+
Snapshots can be saved and restored on the same kernel version without any
89+
issues. There might be issues when restoring snapshots created on different host
90+
kernel version even when using the same Firecracker version.
9291

9392
SnapshotCreate and SnapshotLoad operations across different host kernels is
9493
considered unstable in Firecracker as the saved KVM state might have different

tests/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ regardless of success or failure, pass the `-s` flag, e.g.
6767

6868
### Dependencies
6969

70-
- A bare-metal `Linux` host with `uname -r` >= 4.14 and KVM enabled (`/dev/kvm`
70+
- A bare-metal `Linux` host with `uname -r` >= 5.10 and KVM enabled (`/dev/kvm`
7171
device node exists)
7272
- Docker
7373
- `awscli` version 2

0 commit comments

Comments
 (0)