Debugging Cryptsetup issues

Cryptsetup is responsible for unlocking dm-crypt devices. The cryptsetup Debian provide a whole slew of helper scripts that integrate cryptsetup into the Debian operating system. The most important ones are the cryptdisks init script and the cryptroot initramfs scripts, both implementing support for the /etc/crypttab configuration file and for automatic unlocking of encrypted devices during the boot process.

This page collects information on debugging different features of the Debian cryptsetup packages in case of problems.

Debug cryptroot initramfs script

In order to debug the cryptroot initramfs script during initramfs stage, the following steps are required:

Sometimes, debugging the initramfs directly can be helpful as well. See for details.

Gather debugging information in the initramfs rescue shell

Useful commands to gather information from initramfs rescue shell:

– Jonas Meurer, Wed 25 Dec 2019 02:58:00 PM CET