From c12982230b275185063558276f037eea2bcd5299 Mon Sep 17 00:00:00 2001 From: Nextcloud bot Date: Fri, 6 Mar 2020 03:41:21 +0000 Subject: [PATCH] generate documentation from config.sample.php --- .../config_sample_php_parameters.rst | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 6bbc80db2..5cbab8ad0 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -1604,6 +1604,43 @@ use. The Web server user must have write access to this directory. +Hashing +------- + +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 + + +:: + + 'hashingMemoryCost' => 65536, + +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. + +:: + + 'hashingTimeCost' => 4, + +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. + +:: + + 'hashingThreads' => 1, + +The allowed number of CPU threads that can be used by the algorithm for +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. + :: 'hashingCost' => 10,