From 167da99eaa9708289492e8fca2ebe4964cf5baa7 Mon Sep 17 00:00:00 2001 From: Ondrej Kozina Date: Mon, 9 Jul 2018 17:27:55 +0200 Subject: [PATCH 5/6] Update crypt_repair API documentation for LUKS2. --- lib/libcryptsetup.h | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/lib/libcryptsetup.h b/lib/libcryptsetup.h index 0a7ebdb..2d959fa 100644 --- a/lib/libcryptsetup.h +++ b/lib/libcryptsetup.h @@ -624,7 +624,7 @@ int crypt_load(struct crypt_device *cd, void *params); /** - * Try to repair crypt device LUKS1 on-disk header if invalid. + * Try to repair crypt device LUKS on-disk header if invalid. * * @param cd crypt device handle * @param requested_type @link crypt-type @endlink or @e NULL for all known @@ -632,9 +632,11 @@ int crypt_load(struct crypt_device *cd, * * @returns 0 on success or negative errno value otherwise. * - * @note Does not support LUKS2 devices explicitly. LUKS2 header is auto-repaired - * (if exactly one header checksum does not match) automatically on - * crypt_load(). + * @note For LUKS2 device crypt_repair bypass blkid checks and + * perform auto-recovery even though there're third party device + * signatures found by blkid probes. Currently the crypt_repair on LUKS2 + * works only if exactly one header checksum does not match or exactly + * one header is missing. */ int crypt_repair(struct crypt_device *cd, const char *requested_type, -- 1.8.3.1