summaryrefslogtreecommitdiff
path: root/src/lib/libc/crypt/crypt.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libc/crypt/crypt.3')
-rw-r--r--src/lib/libc/crypt/crypt.340
1 files changed, 8 insertions, 32 deletions
diff --git a/src/lib/libc/crypt/crypt.3 b/src/lib/libc/crypt/crypt.3
index 636e49d106..f01f996445 100644
--- a/src/lib/libc/crypt/crypt.3
+++ b/src/lib/libc/crypt/crypt.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: crypt.3,v 1.40 2014/11/18 22:17:50 jmc Exp $ 1.\" $OpenBSD: crypt.3,v 1.41 2014/11/20 19:18:25 tedu Exp $
2.\" 2.\"
3.\" FreeSec: libcrypt 3.\" FreeSec: libcrypt
4.\" 4.\"
@@ -31,13 +31,11 @@
31.\" 31.\"
32.\" Manual page, using -mandoc macros 32.\" Manual page, using -mandoc macros
33.\" 33.\"
34.Dd $Mdocdate: November 18 2014 $ 34.Dd $Mdocdate: November 20 2014 $
35.Dt CRYPT 3 35.Dt CRYPT 3
36.Os 36.Os
37.Sh NAME 37.Sh NAME
38.Nm crypt , 38.Nm crypt ,
39.Nm crypt_checkpass ,
40.Nm crypt_newhash ,
41.Nm setkey , 39.Nm setkey ,
42.Nm encrypt , 40.Nm encrypt ,
43.Nm des_setkey , 41.Nm des_setkey ,
@@ -54,10 +52,6 @@
54.Ft char * 52.Ft char *
55.Fn crypt "const char *key" "const char *setting" 53.Fn crypt "const char *key" "const char *setting"
56.Ft int 54.Ft int
57.Fn crypt_checkpass "const char *password" "const char *hash"
58.Ft int
59.Fn crypt_newhash "const char *password" "login_cap_t *lc" "char *hash" "size_t hashsize"
60.Ft int
61.Fn encrypt "char *block" "int flag" 55.Fn encrypt "char *block" "int flag"
62.Ft int 56.Ft int
63.Fn des_setkey "const char *key" 57.Fn des_setkey "const char *key"
@@ -69,6 +63,11 @@
69.Ft char * 63.Ft char *
70.Fn bcrypt "const char *key" "const char *salt" 64.Fn bcrypt "const char *key" "const char *salt"
71.Sh DESCRIPTION 65.Sh DESCRIPTION
66These functions are deprecated in favor of
67.Xr crypt_checkpass 3
68and
69.Xr crypt_newhash 3 .
70.Pp
72The 71The
73.Fn crypt 72.Fn crypt
74function performs password hashing based on the 73function performs password hashing based on the
@@ -94,30 +93,6 @@ and a number then a different algorithm is used depending on the number.
94At the moment 93At the moment
95.Ql $2 94.Ql $2
96chooses Blowfish hashing; see below for more information. 95chooses Blowfish hashing; see below for more information.
97.Pp
98The
99.Fn crypt_checkpass
100function is provided to simplify checking a user's password.
101If both the hash and the password are the empty string, authentication
102is a success.
103Otherwise, the password is hashed and compared to the provided hash.
104If the hash is NULL, authentication will always fail, but a default
105amount of work is performed to simulate the hashing operation.
106A successful match will return 0.
107A failure will return \-1 and set errno.
108.Pp
109The
110.Fn crypt_newhash
111function is provided to simplify the creation of new password hashes.
112The provided
113.Fa password
114is randomly salted and hashed and stored in
115.Fa hash .
116The login class argument
117.Fa lc
118is used to identify the preferred hashing algorithm and parameters.
119Refer to
120.Xr login.conf 5 .
121.Ss Extended crypt 96.Ss Extended crypt
122The 97The
123.Ar key 98.Ar key
@@ -298,6 +273,7 @@ return 0 on success and 1 on failure.
298.Xr login 1 , 273.Xr login 1 ,
299.Xr passwd 1 , 274.Xr passwd 1 ,
300.Xr blowfish 3 , 275.Xr blowfish 3 ,
276.Xr crypt_checkpass 3 ,
301.Xr getpass 3 , 277.Xr getpass 3 ,
302.Xr md5 3 , 278.Xr md5 3 ,
303.Xr passwd 5 279.Xr passwd 5