diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-17 08:06:26 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-17 08:06:26 +0000 |
commit | 1660d4b7a65d9ad2ce0deaa19d35579ca4084ac5 (patch) | |
tree | 6cf8220b628ebd2ccfc1375dd6516c6996e9abcc /man/cryptsetup-refresh.8.adoc | |
parent | Initial commit. (diff) | |
download | cryptsetup-upstream.tar.xz cryptsetup-upstream.zip |
Adding upstream version 2:2.6.1.upstream/2%2.6.1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/cryptsetup-refresh.8.adoc')
-rw-r--r-- | man/cryptsetup-refresh.8.adoc | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/man/cryptsetup-refresh.8.adoc b/man/cryptsetup-refresh.8.adoc new file mode 100644 index 0000000..b79a80a --- /dev/null +++ b/man/cryptsetup-refresh.8.adoc @@ -0,0 +1,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[] |