Version 1.4.2.
[platform/upstream/cryptsetup.git] / docs / v1.4.2-ReleaseNotes
1 Cryptsetup 1.4.2 Release Notes
2 ==============================
3
4 Changes since version 1.4.1
5
6 * Add --keyfile-offset and --new-keyfile-offset parameters to API and CLI.
7   These options can be used to skip start of keyfile or device used as keyfile.
8
9 * Add repair command and crypt_repair() for known LUKS metadata problems repair.
10
11   Some well-known LUKS metadata corruptions are easy to repair, this
12   command should provide a way to fix these problems.
13
14   Always create binary backup of header device before running repair,
15   (only 4kB - visible header) for example by using dd:
16      dd if=/dev/<LUKS header device> of=repair_bck.img bs=1k count=4
17
18   Then you can try to run repair:
19      cryptsetup repair <device>
20
21  Note, not all problems are possible to repair and if keyslot or some header
22  parameters are overwritten, device is lost permanently.
23
24 * Allow to specify --align-payload only for luksFormat.
25
26 * Add --master-key-file option to luksOpen (open using volume key).
27
28 * Support UUID=<LUKS_UUID> format for device specification.
29   You can open device by UUID (only shortcut to /dev/disk/by-uuid/ symlinks).
30
31 * Support password verification with quiet flag if possible. (1.2.0)
32   Password verification can be still possible if input is terminal.
33
34 * Fix retry if entered passphrases (with verify option) do not match.
35   (It should retry if requested, not fail.)
36
37 * Fix use of empty keyfile.
38
39 * Fix error message for luksClose and detached LUKS header.
40
41 * Allow --header for status command to get full info with detached header.