From ed7c7e6fdea155a920e1b0f6a818780e4bafd890 Mon Sep 17 00:00:00 2001 From: Francis Rowe Date: Sun, 01 Mar 2015 04:23:14 -0500 Subject: docs/gnulinux/encrypted_parabola.html: Fix bad English. --- (limited to 'docs') diff --git a/docs/gnulinux/encrypted_parabola.html b/docs/gnulinux/encrypted_parabola.html index 56d77c6..1e30438 100644 --- a/docs/gnulinux/encrypted_parabola.html +++ b/docs/gnulinux/encrypted_parabola.html @@ -588,28 +588,30 @@

Optional: Use Keyfile in Initramfs to unlock encrypted root

- Using the above Installation method, you will have to unlock the encrypted Filesystems two times. - Once in Grub and once during the boot of Parabola.
- In order to circumvent this, it is possible to inlcude a Keyfile into the Initramfs of Parabola and unlock it at boot.
- As mkinitcpio in Parabola and Archlinux needs patching for this to work, it is currently more of a "dirty hack" until it gets merged.
- Everytime the mkinitcpio Package gets updated, you need to reapply the patch, or add mkinitcpio to HoldPkg in /etc/pacman.conf, this way it won't get updated.
+ Using the above installation method, you will have to unlock the encrypted file system twice + once in GRUB, and again when booting Parabola). + To circumvent this, you can insert a keyfile into the initramfs. This is generally safe, because the /boot/ directory is encrypted. + You will need to apply a patch for this to work, until the patch is merged upstream. + Every time the mkinitcpio package is updated, you will need to re-apply the patch (recommended) + or add mkinitcpio to HoldPkg in /etc/pacman.conf (not recommended).
- Download the encrypt.patch for the hook from the Feature request that is open : FS#31877
+ Download the encrypt.patch file from this page: + FS#31877
Patch the encrypt hook:
# patch /usr/lib/initcpio/hooks/encrypt /path/to/encrypt.patch
Create a Keyfile:
# dd bs=512 count=4 if=/dev/urandom of=/etc/mykeyfile iflag=fullblock
- Add Keyfile to the Luks Device:
+ Add the keyfile to the Luks Device:
# cryptsetup luksAddKey /dev/sdX /etc/mykeyfile
- Add Keyfile to the initramfs by adding it to FILES in /etc/mkinitcpio.conf, for example:
+ Add the keyfile to the initramfs by adding it to FILES in /etc/mkinitcpio.conf. For example:
# FILES="/etc/mykeyfile"
- Recreate the initramfs Image, replace linux-libre with whatever flavour of Kernel you are using.
+ Re-create the initramfs image:
# mkinitcpio -p linux-libre
- Reboot and add the following to the kernel command line in Grub:
+ Reboot and add the following to the kernel command line in GRUB:
# cryptkey=initramfs:/etc/mykeyfile

- If everything works as expected you can permanently add the kernel parameter to the grub config inside your image and reflash it. - + If everything works as expected, permanently add the kernel parameter to the GRUB config using + the instructions at grub_cbfs.html.

-- cgit v0.9.1