uicompat(3)                        OpenSL                       uicompat(3)



NAME
       desreadpassword, desread2passwords, desreadpwstring, desreadpw
       - Compatibility user interface functions

SYNOPSIS
        int desreadpassword(DEScblock *key,const char *prompt,int verify);
        int desread2passwords(DEScblock *key1,DEScblock *key2,
               const char *prompt,int verify);

        int desreadpwstring(char *buf,int length,const char *prompt,int verify);
        int desreadpw(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.

       desreadpw() 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 desreadpw()
       to do the work.

       desreadpwstring() is a variant of desreadpw() that provides a
       buffer for you if verify is set.

       desreadpassword() calls desreadpw() and converts the password to a
       DES key by calling DESstringtokey(); desread2password() operates
       in the same way as desreadpassword() except that it generates two
       keys by using the DESstringto2key() function.

NOTES
       desreadpwstring() is available in the MIT Kerberos library as well,
       and is also available under the name EVPreadpwstring().

SEE ALSO
       ui(3), uicreate(3)

AUTHOR
       Richard Levitte (richard@levitte.org) for the OpenSL project
       (http:/www.openssl.org).



0.9.7l                            2001-10-25                      uicompat(3)