diff mbox series

[bug#69507] doc: Fix section on LUKS support.

Message ID c4ef4fc0cbb98d550dd0bc7244354996b281d12e.1709374876.git.me@fabionatali.com
State New
Headers show
Series [bug#69507] doc: Fix section on LUKS support. | expand

Commit Message

Fabio Natali March 2, 2024, 10:25 a.m. UTC
* doc/guix.texi (Keyboard Layout, Networking, and Partitioning)[Disk
Partitioning]: Fix section on LUKS support.

Only LUKS1 is supported in Guix at the time of this commit. Contrarily to what
reported in previous versions of this section, LUKS2 is not supported.
---
Hi! 👋

Documentation micro-fix as per this email thread⁰.

I hope it's ok, cheers, Fabio.

⁰ https://lists.gnu.org/archive/html/guix-devel/2024-03/msg00000.html.

 doc/guix.texi | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)


base-commit: 4a0549be52f3f46fbce61342d8de30f7b83130c5

Comments

Christopher Baines March 14, 2024, 1:52 p.m. UTC | #1
Fabio Natali via Guix-patches via <guix-patches@gnu.org> writes:

> * doc/guix.texi (Keyboard Layout, Networking, and Partitioning)[Disk
> Partitioning]: Fix section on LUKS support.
>
> Only LUKS1 is supported in Guix at the time of this commit. Contrarily to what
> reported in previous versions of this section, LUKS2 is not supported.
> ---
> Hi! 👋
>
> Documentation micro-fix as per this email thread⁰.
>
> I hope it's ok, cheers, Fabio.
>
> ⁰ https://lists.gnu.org/archive/html/guix-devel/2024-03/msg00000.html.
>
>  doc/guix.texi | 16 ++++++++--------
>  1 file changed, 8 insertions(+), 8 deletions(-)

Thanks! I've pushed this to master as
3bd795bc5736a81adc586da80c67107dd8f64384.

Chris
diff mbox series

Patch

diff --git a/doc/guix.texi b/doc/guix.texi
index f6476e0d81..0b4ba7e5bf 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2727,20 +2727,20 @@  Keyboard Layout and Networking and Partitioning
 @code{man cryptsetup}} for more information).
 
 @quotation Warning
-Note that GRUB can unlock LUKS2 devices since version 2.06, but only
-supports the PBKDF2 key derivation function, which is not the default
-for @command{cryptsetup luksFormat}.  You can check which key derivation
-function is being used by a device by running @command{cryptsetup
-luksDump @var{device}}, and looking for the PBKDF field of your
-keyslots.
+While efforts are in progress to extend support to LUKS2, please note
+that Guix only supports devices of type LUKS1 at the moment. You can
+verify that your existing LUKS device is of the right type by running
+@command{cryptsetup luksDump @var{device}}. Alternatively, you can
+create a new LUKS1 device with @command{cryptsetup luksFormat --type
+luks1 @var{device}}.
 @end quotation
 
 Assuming you want to store the root partition on @file{/dev/sda2}, the
-command sequence to format it as a LUKS2 partition would be along these
+command sequence to format it as a LUKS1 partition would be along these
 lines:
 
 @example
-cryptsetup luksFormat --type luks2 --pbkdf pbkdf2 /dev/sda2
+cryptsetup luksFormat --type luks1 /dev/sda2
 cryptsetup open /dev/sda2 my-partition
 mkfs.ext4 -L my-root /dev/mapper/my-partition
 @end example