[src/trunk]: src/lib/libcrypt pw_gensalt.3: add argon2 bits

[nia <nia%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/aeae3e9c6431
branches:  trunk
changeset: 1024199:aeae3e9c6431
user:      nia <nia%NetBSD.org@localhost>
date:      Tue Oct 12 12:03:47 2021 +0000

description:
pw_gensalt.3: add argon2 bits

diffstat:

 lib/libcrypt/pw_gensalt.3 |  24 ++++++++++++++++++------
 1 files changed, 18 insertions(+), 6 deletions(-)

diffs (45 lines):

diff -r a962a1b51206 -r aeae3e9c6431 lib/libcrypt/pw_gensalt.3
--- a/lib/libcrypt/pw_gensalt.3 Tue Oct 12 11:08:14 2021 +0000
+++ b/lib/libcrypt/pw_gensalt.3 Tue Oct 12 12:03:47 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pw_gensalt.3,v 1.7 2020/03/25 22:09:48 wiz Exp $
+.\"    $NetBSD: pw_gensalt.3,v 1.8 2021/10/12 12:03:47 nia Exp $
 .\"
 .\" Copyright (c) 2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -28,7 +28,7 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd March 25, 2020
+.Dd October 12, 2021
 .Dt PW_GENSALT 3
 .Os
 .Sh NAME
@@ -132,10 +132,22 @@
 The
 .Li 2
 in the salt string indicates the current blowfish version.
-.\" .It argon2
-.\" .It argon2id
-.\" .It argon2i
-.\" .It argon2
+.It argon2d
+This is of the form:
+.Li $argon2d$v=19$m=MEMORY,t=TIME,p=THREADS$????????????????$
+.It argon2i
+This is of the form:
+.Li $argon2i$v=19$m=MEMORY,t=TIME,p=THREADS$????????????????$
+.It argon2id
+This is of the form:
+.Li $argon2id$v=19$m=MEMORY,t=TIME,p=THREADS$????????????????$
+.It argon2
+An alias for
+.Dq argon2id .
+.Pp
+See
+.Xr crypt 3
+for details on the Argon2 parameters.
 .El
 .Sh RETURN VALUES
 Upon successful completion, a value of 0 is returned.