Files
cryptsetup/man/cryptsetup-benchmark.8.adoc
Milan Broz 360f85dde7 man: Grammar and simple stylistic fixes.
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.
2025-07-17 15:01:39 +02:00

36 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 a few common configurations.
To benchmark other ciphers or modes, 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 the kernel userspace crypto API to be available (introduced in Linux kernel 2.6.38).
If you are configuring the 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[]