ui_compat - des_read_password, des_read_2passwords, des_read_pw_string, des_read_pw Compatibility user interface functions
#include <openssl/des_old.h> int des_read_password(DES_cblock *key,const char *prompt,int verify); int des_read_2passwords(DES_cblock *key1,DES_cblock *key2, const char *prompt,int verify); int des_read_pw_string(char *buf,int length,const char *prompt,int verify); int des_read_pw(char *buf,char *buff,int size,const char *prompt,int verify);
ui_compat(3openssl) OpenSSL ui_compat(3openssl)
NAME
des_read_password, des_read_2passwords, des_read_pw_string, des_read_pw
- Compatibility user interface functions
SYNOPSIS
#include <openssl/des_old.h>
int des_read_password(DES_cblock *key,const char *prompt,int verify);
int des_read_2passwords(DES_cblock *key1,DES_cblock *key2,
const char *prompt,int verify);
int des_read_pw_string(char *buf,int length,const char *prompt,int verify);
int des_read_pw(char *buf,char *buff,int size,const char *prompt,int verify);
DESCRIPTION
The DES library contained a few routines to prompt for passwords.
These aren't necessarely dependent on DES, and have therefore become
part of the UI compatibility library.
des_read_pw() writes the string specified by prompt to standard output
turns echo off and reads an input string from the terminal. The string
is returned in buf, which must have spac for at least size bytes. If
verify is set, the user is asked for the password twice and unless the
two copies match, an error is returned. The second password is stored
in buff, which must therefore also be at least size bytes. A return
code of -1 indicates a system error, 1 failure due to use interaction,
and 0 is success. All other functions described here use des_read_pw()
to do the work.
des_read_pw_string() is a variant of des_read_pw() that provides a
buffer for you if verify is set.
des_read_password() calls des_read_pw() and converts the password to a
DES key by calling DES_string_to_key(); des_read_2password() operates
in the same way as des_read_password() except that it generates two
keys by using the DES_string_to_2key() function.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | library/security/openssl |
+---------------+--------------------------+
|Stability | Pass-through uncommitted |
+---------------+--------------------------+
NOTES
des_read_pw_string() is available in the MIT Kerberos library as well,
and is also available under the name EVP_read_pw_string().
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
https://www.openssl.org/source/openssl-1.0.2ze.tar.gz.
Further information about this software can be found on the open source
community website at https://www.openssl.org/.
SEE ALSO
ui(3), ui_create(3)
AUTHOR
Richard Levitte (richard@levitte.org) for the OpenSSL project
(http://www.openssl.org).
1.0.2ze 2022-05-03 ui_compat(3openssl)