mirror of
https://gitlab.com/cryptsetup/cryptsetup.git
synced 2025-12-05 16:00:05 +01:00
360f85dde7
This is based mainly on Grammarly. It unifies man pages to at least some level of grammar, so later we can focus on adding more readable content.
42 lines
1.7 KiB
Plaintext
42 lines
1.7 KiB
Plaintext
= 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[]
|