From: Arthur Schiwon <blizzz@arthur-schiwon.de>
Date: Wed, 22 Jan 2020 16:45:27 +0000 (+0100)
Subject: extended documentation
X-Git-Tag: v17.0.4RC1~7^2
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=refs%2Fpull%2F19095%2Fhead;p=nextcloud-server.git

extended documentation

Signed-off-by: Arthur Schiwon <blizzz@arthur-schiwon.de>
---

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