diff options
Diffstat (limited to 'man/cryptsetup-repair.8.adoc')
-rw-r--r-- | man/cryptsetup-repair.8.adoc | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/man/cryptsetup-repair.8.adoc b/man/cryptsetup-repair.8.adoc new file mode 100644 index 0000000..22ad9cb --- /dev/null +++ b/man/cryptsetup-repair.8.adoc @@ -0,0 +1,43 @@ += cryptsetup-repair(8) +:doctype: manpage +:manmanual: Maintenance Commands +:mansource: cryptsetup {release-version} +:man-linkstyle: pass:[blue R < >] +:COMMON_OPTIONS: +:ACTION_REPAIR: + +== Name + +cryptsetup-repair - repair the device metadata + +== SYNOPSIS + +*cryptsetup _repair_ [<options>] <device>* + +== DESCRIPTION + +Tries to repair the device metadata if possible. Currently supported +only for LUKS device type. + +This command is useful to fix some known benign LUKS metadata header +corruptions. Only basic corruptions of unused keyslot are fixable. This +command will only change the LUKS header, not any key-slot data. You may +enforce LUKS version by adding --type option. + +It also repairs (upgrades) LUKS2 reencryption metadata by adding +a metadata digest that protects it against malicious changes. + +If LUKS2 reencryption was interrupted in the middle of writing +reencryption segment the repair command can be used to perform +reencryption recovery so that reencryption can continue later. +Repairing reencryption requires verification of reencryption +keyslot so passphrase or keyfile is needed. + +*<options>* can be [--timeout, --verify-passphrase, --disable-locks, +--type, --header, --key-file, --keyfile-size, --keyfile-offset, --key-slot]. + +*WARNING:* Always create a binary backup of the original header before +calling this command. + +include::man/common_options.adoc[] +include::man/common_footer.adoc[] |