mirror of
https://gitlab.com/cryptsetup/cryptsetup.git
synced 2025-12-05 16:00:05 +01:00
a52e1aadca
- do not use bold if option is the text - unify argument format - do not highlight obsolete syntax
42 lines
1.3 KiB
Plaintext
42 lines
1.3 KiB
Plaintext
= cryptsetup-benchmark(8)
|
|
:doctype: manpage
|
|
:manmanual: Maintenance Commands
|
|
:mansource: cryptsetup {release-version}
|
|
:man-linkstyle: pass:[blue R < >]
|
|
:COMMON_OPTIONS:
|
|
:ACTION_BENCHMARK:
|
|
|
|
== Name
|
|
|
|
cryptsetup-benchmark - benchmarks ciphers and KDF
|
|
|
|
== SYNOPSIS
|
|
|
|
*cryptsetup _benchmark_ [<options>]*
|
|
|
|
== DESCRIPTION
|
|
|
|
Benchmarks ciphers and KDF (key derivation function). Without
|
|
parameters, it tries to measure few common configurations.
|
|
|
|
To benchmark other ciphers or modes, you need to specify --cipher and
|
|
--key-size options.
|
|
|
|
To benchmark PBKDF you need to specify --pbkdf or --hash with optional
|
|
cost parameters --iter-time, --pbkdf-memory or --pbkdf-parallel.
|
|
|
|
*NOTE:* This benchmark uses memory only and is only informative. You
|
|
cannot directly predict real storage encryption speed from it.
|
|
|
|
For testing block ciphers, this benchmark requires kernel userspace
|
|
crypto API to be available (introduced in Linux kernel 2.6.38). If you
|
|
are configuring kernel yourself, enable "User-space interface for
|
|
symmetric key cipher algorithms" in "Cryptographic API" section
|
|
(CRYPTO_USER_API_SKCIPHER .config option).
|
|
|
|
*<options>* can be [--cipher, --key-size, --hash, --pbkdf, --iter-time,
|
|
--pbkdf-memory, --pbkdf-parallel].
|
|
|
|
include::man/common_options.adoc[]
|
|
include::man/common_footer.adoc[]
|