LTKCPP-- LLRP Toolkit C Plus Plus Library
des.h
00001 /* crypto/des/des.h */
00002 /* Copyright (C) 1995-1997 Eric Young (eay@cryptsoft.com)
00003  * All rights reserved.
00004  *
00005  * This package is an SSL implementation written
00006  * by Eric Young (eay@cryptsoft.com).
00007  * The implementation was written so as to conform with Netscapes SSL.
00008  *
00009  * This library is free for commercial and non-commercial use as long as
00010  * the following conditions are aheared to.  The following conditions
00011  * apply to all code found in this distribution, be it the RC4, RSA,
00012  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
00013  * included with this distribution is covered by the same copyright terms
00014  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
00015  *
00016  * Copyright remains Eric Young's, and as such any Copyright notices in
00017  * the code are not to be removed.
00018  * If this package is used in a product, Eric Young should be given attribution
00019  * as the author of the parts of the library used.
00020  * This can be in the form of a textual message at program startup or
00021  * in documentation (online or textual) provided with the package.
00022  *
00023  * Redistribution and use in source and binary forms, with or without
00024  * modification, are permitted provided that the following conditions
00025  * are met:
00026  * 1. Redistributions of source code must retain the copyright
00027  *    notice, this list of conditions and the following disclaimer.
00028  * 2. Redistributions in binary form must reproduce the above copyright
00029  *    notice, this list of conditions and the following disclaimer in the
00030  *    documentation and/or other materials provided with the distribution.
00031  * 3. All advertising materials mentioning features or use of this software
00032  *    must display the following acknowledgement:
00033  *    "This product includes cryptographic software written by
00034  *     Eric Young (eay@cryptsoft.com)"
00035  *    The word 'cryptographic' can be left out if the rouines from the library
00036  *    being used are not cryptographic related :-).
00037  * 4. If you include any Windows specific code (or a derivative thereof) from
00038  *    the apps directory (application code) you must include an acknowledgement:
00039  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
00040  *
00041  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
00042  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00043  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00044  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
00045  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00046  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
00047  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
00048  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
00049  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
00050  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00051  * SUCH DAMAGE.
00052  *
00053  * The licence and distribution terms for any publically available version or
00054  * derivative of this code cannot be changed.  i.e. this code cannot simply be
00055  * copied and put under another distribution licence
00056  * [including the GNU Public Licence.]
00057  */
00058 
00059 #ifndef HEADER_NEW_DES_H
00060 # define HEADER_NEW_DES_H
00061 
00062 # include <openssl/e_os2.h>     /* OPENSSL_EXTERN, OPENSSL_NO_DES, DES_LONG
00063                                  * (via openssl/opensslconf.h */
00064 
00065 # ifdef OPENSSL_NO_DES
00066 #  error DES is disabled.
00067 # endif
00068 
00069 # ifdef OPENSSL_BUILD_SHLIBCRYPTO
00070 #  undef OPENSSL_EXTERN
00071 #  define OPENSSL_EXTERN OPENSSL_EXPORT
00072 # endif
00073 
00074 #ifdef  __cplusplus
00075 extern "C" {
00076 #endif
00077 
00078 typedef unsigned char DES_cblock[8];
00079 typedef /* const */ unsigned char const_DES_cblock[8];
00080 /*
00081  * With "const", gcc 2.8.1 on Solaris thinks that DES_cblock * and
00082  * const_DES_cblock * are incompatible pointer types.
00083  */
00084 
00085 typedef struct DES_ks {
00086     union {
00087         DES_cblock cblock;
00088         /*
00089          * make sure things are correct size on machines with 8 byte longs
00090          */
00091         DES_LONG deslong[2];
00092     } ks[16];
00093 } DES_key_schedule;
00094 
00095 # ifndef OPENSSL_DISABLE_OLD_DES_SUPPORT
00096 #  ifndef OPENSSL_ENABLE_OLD_DES_SUPPORT
00097 #   define OPENSSL_ENABLE_OLD_DES_SUPPORT
00098 #  endif
00099 # endif
00100 
00101 # ifdef OPENSSL_ENABLE_OLD_DES_SUPPORT
00102 #  include <openssl/des_old.h>
00103 # endif
00104 
00105 # define DES_KEY_SZ      (sizeof(DES_cblock))
00106 # define DES_SCHEDULE_SZ (sizeof(DES_key_schedule))
00107 
00108 # define DES_ENCRYPT     1
00109 # define DES_DECRYPT     0
00110 
00111 # define DES_CBC_MODE    0
00112 # define DES_PCBC_MODE   1
00113 
00114 # define DES_ecb2_encrypt(i,o,k1,k2,e) \
00115         DES_ecb3_encrypt((i),(o),(k1),(k2),(k1),(e))
00116 
00117 # define DES_ede2_cbc_encrypt(i,o,l,k1,k2,iv,e) \
00118         DES_ede3_cbc_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(e))
00119 
00120 # define DES_ede2_cfb64_encrypt(i,o,l,k1,k2,iv,n,e) \
00121         DES_ede3_cfb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n),(e))
00122 
00123 # define DES_ede2_ofb64_encrypt(i,o,l,k1,k2,iv,n) \
00124         DES_ede3_ofb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n))
00125 
00126 OPENSSL_DECLARE_GLOBAL(int, DES_check_key); /* defaults to false */
00127 # define DES_check_key OPENSSL_GLOBAL_REF(DES_check_key)
00128 OPENSSL_DECLARE_GLOBAL(int, DES_rw_mode); /* defaults to DES_PCBC_MODE */
00129 # define DES_rw_mode OPENSSL_GLOBAL_REF(DES_rw_mode)
00130 
00131 const char *DES_options(void);
00132 void DES_ecb3_encrypt(const_DES_cblock *input, DES_cblock *output,
00133                       DES_key_schedule *ks1, DES_key_schedule *ks2,
00134                       DES_key_schedule *ks3, int enc);
00135 DES_LONG DES_cbc_cksum(const unsigned char *input, DES_cblock *output,
00136                        long length, DES_key_schedule *schedule,
00137                        const_DES_cblock *ivec);
00138 /* DES_cbc_encrypt does not update the IV!  Use DES_ncbc_encrypt instead. */
00139 void DES_cbc_encrypt(const unsigned char *input, unsigned char *output,
00140                      long length, DES_key_schedule *schedule,
00141                      DES_cblock *ivec, int enc);
00142 void DES_ncbc_encrypt(const unsigned char *input, unsigned char *output,
00143                       long length, DES_key_schedule *schedule,
00144                       DES_cblock *ivec, int enc);
00145 void DES_xcbc_encrypt(const unsigned char *input, unsigned char *output,
00146                       long length, DES_key_schedule *schedule,
00147                       DES_cblock *ivec, const_DES_cblock *inw,
00148                       const_DES_cblock *outw, int enc);
00149 void DES_cfb_encrypt(const unsigned char *in, unsigned char *out, int numbits,
00150                      long length, DES_key_schedule *schedule,
00151                      DES_cblock *ivec, int enc);
00152 void DES_ecb_encrypt(const_DES_cblock *input, DES_cblock *output,
00153                      DES_key_schedule *ks, int enc);
00154 
00155 /*
00156  * This is the DES encryption function that gets called by just about every
00157  * other DES routine in the library.  You should not use this function except
00158  * to implement 'modes' of DES.  I say this because the functions that call
00159  * this routine do the conversion from 'char *' to long, and this needs to be
00160  * done to make sure 'non-aligned' memory access do not occur.  The
00161  * characters are loaded 'little endian'. Data is a pointer to 2 unsigned
00162  * long's and ks is the DES_key_schedule to use.  enc, is non zero specifies
00163  * encryption, zero if decryption.
00164  */
00165 void DES_encrypt1(DES_LONG *data, DES_key_schedule *ks, int enc);
00166 
00167 /*
00168  * This functions is the same as DES_encrypt1() except that the DES initial
00169  * permutation (IP) and final permutation (FP) have been left out.  As for
00170  * DES_encrypt1(), you should not use this function. It is used by the
00171  * routines in the library that implement triple DES. IP() DES_encrypt2()
00172  * DES_encrypt2() DES_encrypt2() FP() is the same as DES_encrypt1()
00173  * DES_encrypt1() DES_encrypt1() except faster :-).
00174  */
00175 void DES_encrypt2(DES_LONG *data, DES_key_schedule *ks, int enc);
00176 
00177 void DES_encrypt3(DES_LONG *data, DES_key_schedule *ks1,
00178                   DES_key_schedule *ks2, DES_key_schedule *ks3);
00179 void DES_decrypt3(DES_LONG *data, DES_key_schedule *ks1,
00180                   DES_key_schedule *ks2, DES_key_schedule *ks3);
00181 void DES_ede3_cbc_encrypt(const unsigned char *input, unsigned char *output,
00182                           long length,
00183                           DES_key_schedule *ks1, DES_key_schedule *ks2,
00184                           DES_key_schedule *ks3, DES_cblock *ivec, int enc);
00185 void DES_ede3_cbcm_encrypt(const unsigned char *in, unsigned char *out,
00186                            long length,
00187                            DES_key_schedule *ks1, DES_key_schedule *ks2,
00188                            DES_key_schedule *ks3,
00189                            DES_cblock *ivec1, DES_cblock *ivec2, int enc);
00190 void DES_ede3_cfb64_encrypt(const unsigned char *in, unsigned char *out,
00191                             long length, DES_key_schedule *ks1,
00192                             DES_key_schedule *ks2, DES_key_schedule *ks3,
00193                             DES_cblock *ivec, int *num, int enc);
00194 void DES_ede3_cfb_encrypt(const unsigned char *in, unsigned char *out,
00195                           int numbits, long length, DES_key_schedule *ks1,
00196                           DES_key_schedule *ks2, DES_key_schedule *ks3,
00197                           DES_cblock *ivec, int enc);
00198 void DES_ede3_ofb64_encrypt(const unsigned char *in, unsigned char *out,
00199                             long length, DES_key_schedule *ks1,
00200                             DES_key_schedule *ks2, DES_key_schedule *ks3,
00201                             DES_cblock *ivec, int *num);
00202 # if 0
00203 void DES_xwhite_in2out(const_DES_cblock *DES_key, const_DES_cblock *in_white,
00204                        DES_cblock *out_white);
00205 # endif
00206 
00207 int DES_enc_read(int fd, void *buf, int len, DES_key_schedule *sched,
00208                  DES_cblock *iv);
00209 int DES_enc_write(int fd, const void *buf, int len, DES_key_schedule *sched,
00210                   DES_cblock *iv);
00211 char *DES_fcrypt(const char *buf, const char *salt, char *ret);
00212 char *DES_crypt(const char *buf, const char *salt);
00213 void DES_ofb_encrypt(const unsigned char *in, unsigned char *out, int numbits,
00214                      long length, DES_key_schedule *schedule,
00215                      DES_cblock *ivec);
00216 void DES_pcbc_encrypt(const unsigned char *input, unsigned char *output,
00217                       long length, DES_key_schedule *schedule,
00218                       DES_cblock *ivec, int enc);
00219 DES_LONG DES_quad_cksum(const unsigned char *input, DES_cblock output[],
00220                         long length, int out_count, DES_cblock *seed);
00221 int DES_random_key(DES_cblock *ret);
00222 void DES_set_odd_parity(DES_cblock *key);
00223 int DES_check_key_parity(const_DES_cblock *key);
00224 int DES_is_weak_key(const_DES_cblock *key);
00225 /*
00226  * DES_set_key (= set_key = DES_key_sched = key_sched) calls
00227  * DES_set_key_checked if global variable DES_check_key is set,
00228  * DES_set_key_unchecked otherwise.
00229  */
00230 int DES_set_key(const_DES_cblock *key, DES_key_schedule *schedule);
00231 int DES_key_sched(const_DES_cblock *key, DES_key_schedule *schedule);
00232 int DES_set_key_checked(const_DES_cblock *key, DES_key_schedule *schedule);
00233 void DES_set_key_unchecked(const_DES_cblock *key, DES_key_schedule *schedule);
00234 # ifdef OPENSSL_FIPS
00235 void private_DES_set_key_unchecked(const_DES_cblock *key,
00236                                    DES_key_schedule *schedule);
00237 # endif
00238 void DES_string_to_key(const char *str, DES_cblock *key);
00239 void DES_string_to_2keys(const char *str, DES_cblock *key1, DES_cblock *key2);
00240 void DES_cfb64_encrypt(const unsigned char *in, unsigned char *out,
00241                        long length, DES_key_schedule *schedule,
00242                        DES_cblock *ivec, int *num, int enc);
00243 void DES_ofb64_encrypt(const unsigned char *in, unsigned char *out,
00244                        long length, DES_key_schedule *schedule,
00245                        DES_cblock *ivec, int *num);
00246 
00247 int DES_read_password(DES_cblock *key, const char *prompt, int verify);
00248 int DES_read_2passwords(DES_cblock *key1, DES_cblock *key2,
00249                         const char *prompt, int verify);
00250 
00251 # define DES_fixup_key_parity DES_set_odd_parity
00252 
00253 #ifdef  __cplusplus
00254 }
00255 #endif
00256 
00257 #endif