[src/trunk]: src/share/man/man5 passwd.conf.5: document using argon2

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

details:   https://anonhg.NetBSD.org/src/rev/fc476dad775a
branches:  trunk
changeset: 989119:fc476dad775a
user:      nia <nia%NetBSD.org@localhost>
date:      Tue Oct 12 11:08:14 2021 +0000

description:
passwd.conf.5: document using argon2

diffstat:

 share/man/man5/passwd.conf.5 |  19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)

diffs (53 lines):

diff -r c5e224911286 -r fc476dad775a share/man/man5/passwd.conf.5
--- a/share/man/man5/passwd.conf.5      Tue Oct 12 10:52:40 2021 +0000
+++ b/share/man/man5/passwd.conf.5      Tue Oct 12 11:08:14 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: passwd.conf.5,v 1.11 2017/07/03 21:30:59 wiz Exp $
+.\"    $NetBSD: passwd.conf.5,v 1.12 2021/10/12 11:08:14 nia Exp $
 .\"
 .\" Copyright 1997 Niels Provos <provos%physnet.uni-hamburg.de@localhost>
 .\" All rights reserved.
@@ -28,7 +28,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 3, 2010
+.Dd October 12, 2021
 .Dt PASSWD.CONF 5
 .Os
 .Sh NAME
@@ -59,19 +59,34 @@
 The cipher to use for local passwords.
 .Pp
 Possible values are:
+.Dq argon2d,<t=X,m=Y,p=Z> ,
+.Dq argon2i,<t=X,m=Y,p=Z> ,
+.Dq argon2id,<t=X,m=Y,p=Z> ,
 .Dq old ,
 .Dq newsalt,<rounds> ,
 .Dq md5 ,
 .Dq sha1,<rounds> ,
 and
 .Dq blowfish,<rounds> .
+.Pp
+For
+.Dq argon2d ,
+.Dq argon2i ,
+and
+.Dq argon2id ,
+optional hardness parameters can be specified as described in the
+manual for
+.Xr pwhash 1 .
+.Pp
 For
 .Dq newsalt
 the value of rounds is a 24-bit integer with a minimum of 7250 rounds.
+.Pp
 For
 .Dq sha1
 the value of rounds is a 32-bit integer, 0 means use the default
 of 24680.
+.Pp
 For
 .Dq blowfish
 the value can be between 4 and 31.