aboutsummaryrefslogtreecommitdiffstats
path: root/doc/passhash.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/passhash.txt')
-rw-r--r--doc/passhash.txt27
1 files changed, 17 insertions, 10 deletions
diff --git a/doc/passhash.txt b/doc/passhash.txt
index 005043e44..e9a179c1a 100644
--- a/doc/passhash.txt
+++ b/doc/passhash.txt
@@ -133,23 +133,30 @@ Here is an example of using bcrypt:
.. literalinclude:: examples/bcrypt.cpp
+.. _passhash9:
+
Passhash9
----------------------------------------
Botan also provides a password hashing technique called passhash9, in
-``passhash9.h``, which is based on PBKDF2.
+``passhash9.h``, which is based on PBKDF2. Its outputs look like::
-.. cpp:function:: std::string generate_passhash9(const std::string& password, \
- RandomNumberGenerator& rng, u16bit work_factor = 10)
-
- Functions much like ``generate_bcrypt``
+ "$9$AAAKxwMGNPSdPkOKJS07Xutm3+1Cr3ytmbnkjO6LjHzCMcMQXvcT"
.. cpp:function:: std::string generate_passhash9(const std::string& password, \
- byte alg_id, RandomNumberGenerator& rng, u16bit work_factor = 10)
-
- Like the other ``generate_passhash9``, but taking a parameter that
- specifies which PRF to use. Currently defined values are 0
- ("HMAC(SHA-1)"), 1 ("HMAC(SHA-256)"), and 2 ("CMAC(Blowfish)").
+ RandomNumberGenerator& rng, u16bit work_factor = 10, byte alg_id = 0)
+
+ Functions much like ``generate_bcrypt``. The last parameter,
+ ``alg_id``, specifies which PRF to use. Currently defined values
+ are
+
+ ======= ==============
+ Value PRF algorithm
+ ======= ==============
+ 0 HMAC(SHA-1)
+ 1 HMAC(SHA-256)
+ 2 CMAC(Blowfish)
+ ======= ==============
.. cpp:function:: bool check_passhash9(const std::string& password, \
const std::string& hash)