man/cryptsetup-luksHeaderRestore.8.adoc

   1 = cryptsetup-luksHeaderRestore(8)
   2 :doctype: manpage
   3 :manmanual: Maintenance Commands
   4 :mansource: cryptsetup {release-version}
   5 :man-linkstyle: pass:[blue R < >]
   6 :COMMON_OPTIONS:
   7 :ACTION_LUKSHEADERRESTORE:
   8
   9 == Name
  10
  11 cryptsetup-luksHeaderRestore - restore a binary backup of the LUKS header and keyslot area
  12
  13 == SYNOPSIS
  14
  15 *cryptsetup _luksHeaderRestore_ --header-backup-file <file> [<options>] <device>*
  16
  17 == DESCRIPTION
  18
  19 Restores a binary backup of the LUKS header and keyslot area from the
  20 specified file. +
  21 *NOTE:* Using '-' as filename reads the header backup from a file named '-'.
  22
  23 *<options>* can be [--header, --header-backup-file, --disable-locks].
  24
  25 *WARNING:* Header and keyslots will be replaced, only the passphrases
  26 from the backup will work afterward.
  27
  28 This command requires that the volume key size and data offset of the
  29 LUKS header already on the device and of the header backup match.
  30 Alternatively, if there is no LUKS header on the device, the backup will
  31 also be written to it.
  32
  33 include::man/common_options.adoc[]
  34 include::man/common_footer.adoc[]