File: cryptsetup-refresh.8.adoc

package info (click to toggle)
cryptsetup 2%3A2.7.5-2
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 19,624 kB
  • sloc: ansic: 62,955; sh: 16,774; cpp: 994; xml: 920; makefile: 488; perl: 486
file content (53 lines) | stat: -rw-r--r-- 1,686 bytes parent folder | download | duplicates (2)
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
42
43
44
45
46
47
48
49
50
51
52
53
= 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>.

Updates parameters of active device <name> without the need to deactivate
the device (and umount filesystem). Currently, it supports parameters
refresh on 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 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 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 volume key passed in
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[]