From 518789aa7377acba21c3e8da974e120f24cfc895 Mon Sep 17 00:00:00 2001 From: Arthur Schiwon Date: Wed, 22 Jan 2020 17:45:27 +0100 Subject: [PATCH] extended documentation Signed-off-by: Arthur Schiwon --- config/config.sample.php | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/config/config.sample.php b/config/config.sample.php index 45d78ca9123..c840bdd116e 100644 --- a/config/config.sample.php +++ b/config/config.sample.php @@ -1424,27 +1424,34 @@ $CONFIG = array( /** * Hashing * - * Nextcloud uses the Argon2 algorithm (with PHP >= 7.2) to create hashes by its - * own and exposes its configuration options as following. More information can - * be found at: https://www.php.net/manual/en/function.password-hash.php + * Nextcloud uses the Argon2 algorithm (available with PHP >= 7.2 if compiled + * with it) to create hashes by its own and exposes its configuration options as + * following. The default depends on the PHP build. More information can be + * found at: https://www.php.net/manual/en/function.password-hash.php */ /** - * The allowed maximum memory to be used by the algorithm for computing a hash. + * The allowed maximum memory in KiB to be used by the algorithm for computing a + * hash. The smallest possible value is 8. Values that undershoot the minimum + * will be ignored in favor of the default. */ -'hashingMemoryCost' => PASSWORD_ARGON2_DEFAULT_MEMORY_COST, +'hashingMemoryCost' => 65536, /** - * The allowed maximum time that can be used by the algorithm for computing a - * hash. + * The allowed maximum time in seconds that can be used by the algorithm for + * computing a hash. The value must be an integer, and the minimum value is 1. + * Values that undershoot the minimum will be ignored in favor of the default. */ -'hashingTimeCost' => PASSWORD_ARGON2_DEFAULT_TIME_COST, +'hashingTimeCost' => 4, /** * The allowed number of CPU threads that can be used by the algorithm for - * computing a hash. + * computing a hash. The value must be an integer, and the minimum value is 1. + * Rationally it does not help to provide a number higher than the available + * threads on the machine. Values that undershoot the minimum will be ignored + * in favor of the default. */ -'hashingThreads' => PASSWORD_ARGON2_DEFAULT_THREADS, +'hashingThreads' => 1, /** * The hashing cost used by hashes generated by Nextcloud -- 2.39.5