1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
= cryptsetup-refresh(8)
:doctype: manpage
:manmanual: Maintenance Commands
:mansource: cryptsetup {release-version}
:man-linkstyle: pass:[blue R < >]
:COMMON_OPTIONS:
:ACTION_REFRESH:
== Name
cryptsetup-refresh - refresh parameters of an active mapping
== SYNOPSIS
*cryptsetup _refresh_ [<options>] <name>*
== DESCRIPTION
Refreshes parameters of active mapping <name>.
Update parameters of active device <name> without the need to deactivate the device (and unmount the filesystem).
Currently, it supports parameter refresh on the following devices: LUKS1, LUKS2 (including authenticated encryption), plain crypt and loop-AES.
Mandatory parameters are identical to those of an open action for the respective device type.
You may change the following parameters on all devices --perf-same_cpu_crypt, --perf-submit_from_crypt_cpus, --perf-no_read_workqueue, --perf-no_write_workqueue and --allow-discards.
Refreshing the device without any optional parameter will refresh the device with the default setting (respective to device type).
*LUKS2 only:*
The --integrity-no-journal parameter affects only LUKS2 devices with the underlying dm-integrity device.
Adding option --persistent stores any combination of device parameters above in LUKS2 metadata (only after successful refresh operation).
The --disable-keyring parameter refreshes a device with the volume key passed in the dm-crypt driver.
*<options>* can be [--allow-discards, --perf-same_cpu_crypt, --perf-submit_from_crypt_cpus, --perf-no_read_workqueue, --perf-no_write_workqueue, --header, --disable-keyring, --disable-locks, --persistent, --integrity-no-journal].
include::man/common_options.adoc[]
include::man/common_footer.adoc[]
|
