summaryrefslogtreecommitdiffstats
path: root/lib/libc/crypt/crypt_checkpass.3
diff options
context:
space:
mode:
authorschwarze <schwarze@openbsd.org>2014-12-02 07:39:58 +0000
committerschwarze <schwarze@openbsd.org>2014-12-02 07:39:58 +0000
commitcdaa683c81a655c03567361d935d89cac7bc59a1 (patch)
tree749e4292486e6c75d26a68451c830e2fcdfd5356 /lib/libc/crypt/crypt_checkpass.3
parentzap extra parenthesis after recent rewrite (diff)
downloadwireguard-openbsd-cdaa683c81a655c03567361d935d89cac7bc59a1.tar.xz
wireguard-openbsd-cdaa683c81a655c03567361d935d89cac7bc59a1.zip
macro cleanup; kaspars at bankovskis dot net
Diffstat (limited to 'lib/libc/crypt/crypt_checkpass.3')
-rw-r--r--lib/libc/crypt/crypt_checkpass.319
1 files changed, 14 insertions, 5 deletions
diff --git a/lib/libc/crypt/crypt_checkpass.3 b/lib/libc/crypt/crypt_checkpass.3
index fd60523502e..09f2d02796c 100644
--- a/lib/libc/crypt/crypt_checkpass.3
+++ b/lib/libc/crypt/crypt_checkpass.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: crypt_checkpass.3,v 1.4 2014/11/21 12:52:54 jmc Exp $
+.\" $OpenBSD: crypt_checkpass.3,v 1.5 2014/12/02 07:39:58 schwarze Exp $
.\"
.\" Copyright (c) 2014 Ted Unangst <tedu@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 21 2014 $
+.Dd $Mdocdate: December 2 2014 $
.Dt CRYPT_CHECKPASS 3
.Os
.Sh NAME
@@ -31,10 +31,19 @@
The
.Fn crypt_checkpass
function is provided to simplify checking a user's password.
-If both the hash and the password are the empty string, authentication
+If both the
+.Fa hash
+and the
+.Fa password
+are the empty string, authentication
is a success.
-Otherwise, the password is hashed and compared to the provided hash.
-If the hash is
+Otherwise, the
+.Fa password
+is hashed and compared to the provided
+.Fa hash .
+If the
+.Fa hash
+is
.Dv NULL ,
authentication will always fail, but a default
amount of work is performed to simulate the hashing operation.