summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/lib/libcrypto/man/des_read_pw.343
1 files changed, 29 insertions, 14 deletions
diff --git a/src/lib/libcrypto/man/des_read_pw.3 b/src/lib/libcrypto/man/des_read_pw.3
index 50c1390b35..e772d0a65a 100644
--- a/src/lib/libcrypto/man/des_read_pw.3
+++ b/src/lib/libcrypto/man/des_read_pw.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: des_read_pw.3,v 1.5 2016/12/10 22:01:26 schwarze Exp $ 1.\" $OpenBSD: des_read_pw.3,v 1.6 2017/01/06 17:17:29 schwarze Exp $
2.\" OpenSSL doc/crypto/ui_compat.pod May 14 11:28:00 2006 +0000 2.\" OpenSSL doc/crypto/ui_compat.pod May 14 11:28:00 2006 +0000
3.\" OpenSSL doc/crypto/des.pod 2a9aca32 Oct 25 08:44:10 2001 +0000 3.\" OpenSSL doc/crypto/des.pod 2a9aca32 Oct 25 08:44:10 2001 +0000
4.\" 4.\"
@@ -50,27 +50,36 @@
50.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 50.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
51.\" OF THE POSSIBILITY OF SUCH DAMAGE. 51.\" OF THE POSSIBILITY OF SUCH DAMAGE.
52.\" 52.\"
53.Dd $Mdocdate: December 10 2016 $ 53.Dd $Mdocdate: January 6 2017 $
54.Dt DES_READ_PW 3 54.Dt DES_READ_PW 3
55.Os 55.Os
56.Sh NAME 56.Sh NAME
57.Nm des_read_pw ,
57.Nm des_read_pw_string , 58.Nm des_read_pw_string ,
58.Nm des_read_pw 59.Nm EVP_read_pw_string
59.Nd compatibility user interface functions 60.Nd compatibility user interface functions
60.Sh SYNOPSIS 61.Sh SYNOPSIS
61.In openssl/ui_compat.h 62.In openssl/ui_compat.h
62.Ft int 63.Ft int
64.Fo des_read_pw
65.Fa "char *buf"
66.Fa "char *buff"
67.Fa "int length"
68.Fa "const char *prompt"
69.Fa "int verify"
70.Fc
71.Ft int
63.Fo des_read_pw_string 72.Fo des_read_pw_string
64.Fa "char *buf" 73.Fa "char *buf"
65.Fa "int length" 74.Fa "int length"
66.Fa "const char *prompt" 75.Fa "const char *prompt"
67.Fa "int verify" 76.Fa "int verify"
68.Fc 77.Fc
78.In openssl/evp.h
69.Ft int 79.Ft int
70.Fo des_read_pw 80.Fo EVP_read_pw_string
71.Fa "char *buf" 81.Fa "char *buf"
72.Fa "char *buff" 82.Fa "int length"
73.Fa "int size"
74.Fa "const char *prompt" 83.Fa "const char *prompt"
75.Fa "int verify" 84.Fa "int verify"
76.Fc 85.Fc
@@ -87,7 +96,7 @@ terminal.
87The string is returned in 96The string is returned in
88.Fa buf , 97.Fa buf ,
89which must have space for at least 98which must have space for at least
90.Fa size 99.Fa length
91bytes. 100bytes.
92If 101If
93.Fa verify 102.Fa verify
@@ -96,13 +105,10 @@ copies match, an error is returned.
96The second password is stored in 105The second password is stored in
97.Fa buff , 106.Fa buff ,
98which must therefore also be at least 107which must therefore also be at least
99.Fa size 108.Fa length
100bytes. 109bytes.
101A return code of -1 indicates a system error, 1 failure due to use 110A return code of -1 indicates a system error, 1 failure due to use
102interaction, and 0 is success. 111interaction, and 0 is success.
103All other functions described here use
104.Fn des_read_pw
105to do the work.
106.Pp 112.Pp
107.Fn des_read_pw_string 113.Fn des_read_pw_string
108is a variant of 114is a variant of
@@ -110,9 +116,18 @@ is a variant of
110that provides a buffer if 116that provides a buffer if
111.Fa verify 117.Fa verify
112is set. 118is set.
113It is available in the MIT Kerberos library as well, 119It is available in the MIT Kerberos library as well.
114and is also available under the name 120If
115.Xr EVP_read_pw_string 3 . 121.Fa length
122exceeds
123.Dv BUFSIZ ,
124.Fn des_read_pw_string
125uses
126.Dv BUFSIZ .
127.Pp
128.Fn EVP_read_pw_string
129is functionally similar to
130.Fn des_read_pw_string .
116.Sh SEE ALSO 131.Sh SEE ALSO
117.Xr UI_new 3 132.Xr UI_new 3
118.Sh AUTHORS 133.Sh AUTHORS