Module Name: src
Committed By: wiz
Date: Wed Mar 25 18:53:50 UTC 2020
Modified Files:
src/lib/libcrypt: pw_gensalt.3
Log Message:
Fix typos. Use more markup. New sentence, new line.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/lib/libcrypt/pw_gensalt.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libcrypt/pw_gensalt.3
diff -u src/lib/libcrypt/pw_gensalt.3:1.2 src/lib/libcrypt/pw_gensalt.3:1.3
--- src/lib/libcrypt/pw_gensalt.3:1.2 Wed Mar 25 18:37:08 2020
+++ src/lib/libcrypt/pw_gensalt.3 Wed Mar 25 18:53:50 2020
@@ -1,4 +1,4 @@
-.\" $NetBSD: pw_gensalt.3,v 1.2 2020/03/25 18:37:08 christos Exp $
+.\" $NetBSD: pw_gensalt.3,v 1.3 2020/03/25 18:53:50 wiz Exp $
.\"
.\" Copyright (c) 2020 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -32,7 +32,7 @@
.Dt PW_GENSALT 3
.Os
.Sh NAME
-.Nm pw_gensalt
+.Nm pw_gensalt
.Nd passwd salt generation function
.Sh LIBRARY
.Lb libcrypt
@@ -42,32 +42,33 @@
.Fn pw_gensalt "char *salt" "size_t saltlen" "const char *type" "const char *option"
.Sh DESCRIPTION
The
-.Fn pw_gensalt
+.Fn pw_gensalt
function generates a
.Dq salt
to be added to a password hashing function to guarantee uniqueness and
-slow down dictionary and brute force attacks. The function places a
-random array of
-.Ar saltlen bytes in
+slow down dictionary and brute force attacks.
+The function places a random array of
+.Ar saltlen
+bytes in
.Ar salt
using the hash function specified in
.Ar type
with the function-specific
.Ar option .
-.Ph
+.Pp
The new salt types follow the MCF standard and are of the form:
.Li $<id>[$<param>=<value>(,<param>=<value>)*][$<salt>[$<hash>]]
The characters allowed in the password salt are alphanumeric and
include a forward slash and a period.
.Pp
-.The following types are available:
-.Bl -tag -width blowfish compact
-.It old
+The following types are available:
+.Bl -tag -width blowfish -compact
+.It old
The original Unix implementation.
-This is of the form
+This is of the form
.Li _Gl/.???? ,
where
-.Li ?
+.Li \&?
denotes a random alphanumeric character.
The minimum salt size is
.Dv 3 .
@@ -90,7 +91,7 @@ An alias for
A salt generated using the
.Xr md5 1
algorithm.
-This is of the form
+This is of the form
.Li $1$????????$ .
The minimum salt size is
.Dv 13 .
@@ -98,14 +99,14 @@ The minimum salt size is
A salt generated using the
.Xr sha1 1
algorithm.
-This is of the form
+This is of the form
.Li $sha1$nrounds$????????$ ,
where
.Ar nrounds
is the number of rounds to be used.
The number of rounds can be specified in
.Ar option ,
-and defaults to random if
+and defaults to random if
.Dv NULL .
The minimum salt size is
.Dv 8
@@ -146,7 +147,7 @@ is not specified or has an illegal value
The
.Ar saltlen
was not large enough to fit the salt for the specified
-.Ar type.
+.Ar type .
.El
.Sh SEE ALSO
.Xr passwd 1 ,
@@ -154,4 +155,5 @@ was not large enough to fit the salt for
.Sh HISTORY
The
.Fn pw_gensalt
-function was written in 1997 Niels Provos <pro...@physnet.uni-hamburg.de>.
+function was written in 1997 by
+.An Niels Provos Aq Mt pro...@physnet.uni-hamburg.de .
