OpenSL                                       uicompat(3openssl)



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).







OpenSL-0.9.8       Last change: Oct 11 2005                    1