summaryrefslogtreecommitdiff
path: root/lib/libcrypt
diff options
context:
space:
mode:
authorwiz <wiz@NetBSD.org>2020-03-25 18:53:50 +0000
committerwiz <wiz@NetBSD.org>2020-03-25 18:53:50 +0000
commitbb3794bfb0a51bf1893b602448a492823cb3d134 (patch)
treeb12f3ebdf4aafceef06f6e747853cc84a38fb1f6 /lib/libcrypt
parent611b624179645b3b4a930f5522c2383b22059763 (diff)
Fix typos. Use more markup. New sentence, new line.
Diffstat (limited to 'lib/libcrypt')
-rw-r--r--lib/libcrypt/pw_gensalt.336
1 files changed, 19 insertions, 17 deletions
diff --git a/lib/libcrypt/pw_gensalt.3 b/lib/libcrypt/pw_gensalt.3
index 07bfebdd166..da99ab4314d 100644
--- a/lib/libcrypt/pw_gensalt.3
+++ b/lib/libcrypt/pw_gensalt.3
@@ -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 the specified
.Sh HISTORY
The
.Fn pw_gensalt
-function was written in 1997 Niels Provos <provos@physnet.uni-hamburg.de>.
+function was written in 1997 by
+.An Niels Provos Aq Mt provos@physnet.uni-hamburg.de .