cryptsetup is responsible for unlocking dm-crypt devices. The cryptsetup Debian packages 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.

cryptroot initramfs scripts

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 InitramfsDebug#Saving_debug_information for details.

Gather debugging information in the initramfs rescue shell

Useful commands to gather information from initramfs rescue shell: