diff options
| author | wiz <wiz@NetBSD.org> | 2020-03-25 18:53:50 +0000 |
|---|---|---|
| committer | wiz <wiz@NetBSD.org> | 2020-03-25 18:53:50 +0000 |
| commit | bb3794bfb0a51bf1893b602448a492823cb3d134 (patch) | |
| tree | b12f3ebdf4aafceef06f6e747853cc84a38fb1f6 /lib/libcrypt | |
| parent | 611b624179645b3b4a930f5522c2383b22059763 (diff) | |
Fix typos. Use more markup. New sentence, new line.
Diffstat (limited to 'lib/libcrypt')
| -rw-r--r-- | lib/libcrypt/pw_gensalt.3 | 36 |
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 . |
