diff options
author | Maximilian Bosch <maximilian@mbosch.me> | 2022-12-09 11:34:05 +0100 |
---|---|---|
committer | Maximilian Bosch <maximilian@mbosch.me> | 2022-12-09 11:34:05 +0100 |
commit | 8476b02749ac97b49629745ded7b8b333c8d024a (patch) | |
tree | 789ad0d2436a8879d5a271a89a1428dba030897f /nixos/doc/manual | |
parent | fa257ecb332118786db8e6f635bbd0970838a6e0 (diff) | |
download | nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.tar nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.tar.gz nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.tar.bz2 nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.tar.lz nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.tar.xz nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.tar.zst nixpkgs-8476b02749ac97b49629745ded7b8b333c8d024a.zip |
nixos/doc: suggest using the latest longterm kernel for ZFS
Diffstat (limited to 'nixos/doc/manual')
-rw-r--r-- | nixos/doc/manual/configuration/linux-kernel.chapter.md | 5 | ||||
-rw-r--r-- | nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml | 12 |
2 files changed, 13 insertions, 4 deletions
diff --git a/nixos/doc/manual/configuration/linux-kernel.chapter.md b/nixos/doc/manual/configuration/linux-kernel.chapter.md index 87c1cf6a7cb..7b84416a864 100644 --- a/nixos/doc/manual/configuration/linux-kernel.chapter.md +++ b/nixos/doc/manual/configuration/linux-kernel.chapter.md @@ -152,7 +152,10 @@ $ make -C $dev/lib/modules/*/build M=$(pwd)/drivers/net/ethernet/mellanox module ## ZFS {#sec-linux-zfs} It's a common issue that the latest stable version of ZFS doesn't support the latest -available Linux kernel. It's possible to pin the system to the latest available kernel +available Linux kernel. It is recommended to use the latest available LTS that's compatible +with ZFS. Usually this is the default kernel provided by nixpkgs (i.e. `pkgs.linuxPackages`). + +Alternatively, it's possible to pin the system to the latest available kernel version *that is supported by ZFS* like this: ```nix diff --git a/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml b/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml index 7fb3ba5ac98..dd570e1d66c 100644 --- a/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml +++ b/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml @@ -171,9 +171,15 @@ $ make -C $dev/lib/modules/*/build M=$(pwd)/drivers/net/ethernet/mellanox module <title>ZFS</title> <para> It’s a common issue that the latest stable version of ZFS doesn’t - support the latest available Linux kernel. It’s possible to pin - the system to the latest available kernel version <emphasis>that - is supported by ZFS</emphasis> like this: + support the latest available Linux kernel. It is recommended to + use the latest available LTS that’s compatible with ZFS. Usually + this is the default kernel provided by nixpkgs (i.e. + <literal>pkgs.linuxPackages</literal>). + </para> + <para> + Alternatively, it’s possible to pin the system to the latest + available kernel version <emphasis>that is supported by + ZFS</emphasis> like this: </para> <programlisting language="bash"> { |