Imported Upstream version 1.6.7
[platform/upstream/cryptsetup.git] / docs / v1.6.7-ReleaseNotes
1 Cryptsetup 1.6.7 Release Notes
2 ==============================
3
4 Changes since version 1.6.6
5
6 * Cryptsetup git and wiki are now hosted on GitLab.
7   https://gitlab.com/cryptsetup/cryptsetup
8
9   Repository of stable releases remains on kernel.org site
10   https://www.kernel.org/pub/linux/utils/cryptsetup/
11
12   For more info please see README file.
13
14 * Cryptsetup TCRYPT mode now supports VeraCrypt devices (TrueCrypt extension).
15
16   The VeraCrypt extension only increases iteration count for the key
17   derivation function (on-disk format is the same as TrueCrypt format).
18
19   Note that unlocking of a VeraCrypt device can take very long time if used
20   on slow machines.
21
22   To use this extension, add --veracrypt option, for example
23     cryptsetup open --type tcrypt --veracrypt <container> <name>
24
25   For use through libcryptsetup, just add CRYPT_TCRYPT_VERA_MODES flag.
26
27 * Support keyfile-offset and keyfile-size options even for plain volumes.
28
29 * Support keyfile option for luksAddKey if the master key is specified.
30
31 * For historic reasons, hashing in the plain mode is not used
32   if keyfile is specified (with exception of --key-file=-).
33   Print a warning if these parameters are ignored.
34
35 * Support permanent device decryption for cryptsetup-reencrypt.
36   To remove LUKS encryption from a device, you can now use --decrypt option.
37
38 * Allow to use --header option in all LUKS commands.
39   The --header always takes precedence over positional device argument.
40
41 * Allow luksSuspend without need to specify a detached header.
42
43 * Detect if O_DIRECT is usable on a device allocation.
44   There are some strange storage stack configurations which wrongly allows
45   to open devices with direct-io but fails on all IO operations later.
46
47   Cryptsetup now tries to read the device first sector to ensure it can use
48   direct-io.
49
50 *  Add low-level performance options tuning for dmcrypt (for Linux 4.0 and later).
51
52    Linux kernel 4.0 contains rewritten dmcrypt code which tries to better utilize
53    encryption on parallel CPU cores.
54
55    While tests show that this change increases performance on most configurations,
56    dmcrypt now provides some switches to change its new behavior.
57
58    You can use them (per-device) with these cryptsetup switches:
59       --perf-same_cpu_crypt
60       --perf-submit_from_crypt_cpus
61
62   Please use these only in the case of serious performance problems.
63   Refer to the cryptsetup man page and dm-crypt documentation
64   (for same_cpu_crypt and submit_from_crypt_cpus options).
65   https://gitlab.com/cryptsetup/cryptsetup/wikis/DMCrypt
66
67 * Get rid of libfipscheck library.
68   (Note that this option was used only for Red Hat and derived distributions.)
69   With recent FIPS changes we do not need to link to this FIPS monster anymore.
70   Also drop some no longer needed FIPS mode checks.
71
72 * Many fixes and clarifications to man pages.
73
74 * Prevent compiler to optimize-out zeroing of buffers for on-stack variables.
75
76 * Fix a crash if non-GNU strerror_r is used.
77
78 Cryptsetup API NOTE:
79 The direct terminal handling for passphrase entry will be removed from
80 libcryptsetup in next major version (application should handle it itself).
81
82 It means that you have to always either provide password in buffer or set
83 your own password callback function through crypt_set_password_callback().
84 See API documentation (or libcryptsetup.h) for more info.