ssl/libcrypto/src/crypto/des/des.h
changeset 0 e4d67989cc36
equal deleted inserted replaced
-1:000000000000 0:e4d67989cc36
       
     1 /* crypto/des/des.h */
       
     2 /* Copyright (C) 1995-1997 Eric Young (eay@cryptsoft.com)
       
     3  * All rights reserved.
       
     4  *
       
     5  * This package is an SSL implementation written
       
     6  * by Eric Young (eay@cryptsoft.com).
       
     7  * The implementation was written so as to conform with Netscapes SSL.
       
     8  * 
       
     9  * This library is free for commercial and non-commercial use as long as
       
    10  * the following conditions are aheared to.  The following conditions
       
    11  * apply to all code found in this distribution, be it the RC4, RSA,
       
    12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
       
    13  * included with this distribution is covered by the same copyright terms
       
    14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
       
    15  * 
       
    16  * Copyright remains Eric Young's, and as such any Copyright notices in
       
    17  * the code are not to be removed.
       
    18  * If this package is used in a product, Eric Young should be given attribution
       
    19  * as the author of the parts of the library used.
       
    20  * This can be in the form of a textual message at program startup or
       
    21  * in documentation (online or textual) provided with the package.
       
    22  * 
       
    23  * Redistribution and use in source and binary forms, with or without
       
    24  * modification, are permitted provided that the following conditions
       
    25  * are met:
       
    26  * 1. Redistributions of source code must retain the copyright
       
    27  *    notice, this list of conditions and the following disclaimer.
       
    28  * 2. Redistributions in binary form must reproduce the above copyright
       
    29  *    notice, this list of conditions and the following disclaimer in the
       
    30  *    documentation and/or other materials provided with the distribution.
       
    31  * 3. All advertising materials mentioning features or use of this software
       
    32  *    must display the following acknowledgement:
       
    33  *    "This product includes cryptographic software written by
       
    34  *     Eric Young (eay@cryptsoft.com)"
       
    35  *    The word 'cryptographic' can be left out if the rouines from the library
       
    36  *    being used are not cryptographic related :-).
       
    37  * 4. If you include any Windows specific code (or a derivative thereof) from 
       
    38  *    the apps directory (application code) you must include an acknowledgement:
       
    39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
       
    40  * 
       
    41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
       
    42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
       
    43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
       
    44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
       
    45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
       
    46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
       
    47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
       
    48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
       
    49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
       
    50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
       
    51  * SUCH DAMAGE.
       
    52  * 
       
    53  * The licence and distribution terms for any publically available version or
       
    54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
       
    55  * copied and put under another distribution licence
       
    56  * [including the GNU Public Licence.]
       
    57  */
       
    58 /*
       
    59  © Portions copyright (c) 2006 Nokia Corporation.  All rights reserved.
       
    60  */
       
    61 
       
    62 #ifndef HEADER_NEW_DES_H
       
    63 #define HEADER_NEW_DES_H
       
    64 #ifdef SYMBIAN
       
    65 #include <e32def.h>
       
    66 #endif
       
    67 #include <openssl/e_os2.h>	/* OPENSSL_EXTERN, OPENSSL_NO_DES,
       
    68 				   DES_LONG (via openssl/opensslconf.h */
       
    69 			   
       
    70 
       
    71 #ifdef OPENSSL_NO_DES
       
    72 #error DES is disabled.
       
    73 #endif
       
    74 
       
    75 #ifdef OPENSSL_BUILD_SHLIBCRYPTO
       
    76 # undef OPENSSL_EXTERN
       
    77 # define OPENSSL_EXTERN OPENSSL_EXPORT
       
    78 #endif
       
    79 
       
    80 #ifdef  __cplusplus
       
    81 extern "C" {
       
    82 #endif
       
    83 
       
    84 typedef unsigned char DES_cblock[8];
       
    85 typedef /* const */ unsigned char const_DES_cblock[8];
       
    86 /* With "const", gcc 2.8.1 on Solaris thinks that DES_cblock *
       
    87  * and const_DES_cblock * are incompatible pointer types. */
       
    88 
       
    89 typedef struct DES_ks
       
    90     {
       
    91     union
       
    92 	{
       
    93 	DES_cblock cblock;
       
    94 	/* make sure things are correct size on machines with
       
    95 	 * 8 byte longs */
       
    96 	DES_LONG deslong[2];
       
    97 	} ks[16];
       
    98     } DES_key_schedule;
       
    99 
       
   100 #ifndef OPENSSL_DISABLE_OLD_DES_SUPPORT
       
   101 # ifndef OPENSSL_ENABLE_OLD_DES_SUPPORT
       
   102 #  define OPENSSL_ENABLE_OLD_DES_SUPPORT
       
   103 # endif
       
   104 #endif
       
   105 
       
   106 #ifdef OPENSSL_ENABLE_OLD_DES_SUPPORT
       
   107 # include <openssl/des_old.h>
       
   108 #endif
       
   109 #define DES_KEY_SZ 	(sizeof(DES_cblock))
       
   110 #define DES_SCHEDULE_SZ (sizeof(DES_key_schedule))
       
   111 
       
   112 #define DES_ENCRYPT	1
       
   113 #define DES_DECRYPT	0
       
   114 
       
   115 #define DES_CBC_MODE	0
       
   116 #define DES_PCBC_MODE	1
       
   117 
       
   118 #define DES_ecb2_encrypt(i,o,k1,k2,e) \
       
   119 	DES_ecb3_encrypt((i),(o),(k1),(k2),(k1),(e))
       
   120 
       
   121 #define DES_ede2_cbc_encrypt(i,o,l,k1,k2,iv,e) \
       
   122 	DES_ede3_cbc_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(e))
       
   123 
       
   124 #define DES_ede2_cfb64_encrypt(i,o,l,k1,k2,iv,n,e) \
       
   125 	DES_ede3_cfb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n),(e))
       
   126 
       
   127 #define DES_ede2_ofb64_encrypt(i,o,l,k1,k2,iv,n) \
       
   128 	DES_ede3_ofb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n))
       
   129 #if (defined(SYMBIAN) && (defined(__WINSCW__) || defined(__WINS__)))
       
   130 #else
       
   131 OPENSSL_DECLARE_GLOBAL(int,DES_check_key);	/* defaults to false */
       
   132 #define DES_check_key OPENSSL_GLOBAL_REF(DES_check_key)
       
   133 OPENSSL_DECLARE_GLOBAL(int,DES_rw_mode);	/* defaults to DES_PCBC_MODE */
       
   134 #define DES_rw_mode OPENSSL_GLOBAL_REF(DES_rw_mode)
       
   135 #endif
       
   136 IMPORT_C const char *DES_options(void);
       
   137 IMPORT_C void DES_ecb3_encrypt(const_DES_cblock *input, DES_cblock *output,
       
   138 		      DES_key_schedule *ks1,DES_key_schedule *ks2,
       
   139 		      DES_key_schedule *ks3, int enc);
       
   140 IMPORT_C DES_LONG DES_cbc_cksum(const unsigned char *input,DES_cblock *output,
       
   141 		       long length,DES_key_schedule *schedule,
       
   142 		       const_DES_cblock *ivec);
       
   143 /* DES_cbc_encrypt does not update the IV!  Use DES_ncbc_encrypt instead. */
       
   144 IMPORT_C void DES_cbc_encrypt(const unsigned char *input,unsigned char *output,
       
   145 		     long length,DES_key_schedule *schedule,DES_cblock *ivec,
       
   146 		     int enc);
       
   147 IMPORT_C void DES_ncbc_encrypt(const unsigned char *input,unsigned char *output,
       
   148 		      long length,DES_key_schedule *schedule,DES_cblock *ivec,
       
   149 		      int enc);
       
   150 IMPORT_C void DES_xcbc_encrypt(const unsigned char *input,unsigned char *output,
       
   151 		      long length,DES_key_schedule *schedule,DES_cblock *ivec,
       
   152 		      const_DES_cblock *inw,const_DES_cblock *outw,int enc);
       
   153 IMPORT_C void DES_cfb_encrypt(const unsigned char *in,unsigned char *out,int numbits,
       
   154 		     long length,DES_key_schedule *schedule,DES_cblock *ivec,
       
   155 		     int enc);
       
   156 IMPORT_C void DES_ecb_encrypt(const_DES_cblock *input,DES_cblock *output,
       
   157 		     DES_key_schedule *ks,int enc);
       
   158 
       
   159 /* 	This is the DES encryption function that gets called by just about
       
   160 	every other DES routine in the library.  You should not use this
       
   161 	function except to implement 'modes' of DES.  I say this because the
       
   162 	functions that call this routine do the conversion from 'char *' to
       
   163 	long, and this needs to be done to make sure 'non-aligned' memory
       
   164 	access do not occur.  The characters are loaded 'little endian'.
       
   165 	Data is a pointer to 2 unsigned long's and ks is the
       
   166 	DES_key_schedule to use.  enc, is non zero specifies encryption,
       
   167 	zero if decryption. */
       
   168 IMPORT_C void DES_encrypt1(DES_LONG *data,DES_key_schedule *ks, int enc);
       
   169 
       
   170 /* 	This functions is the same as DES_encrypt1() except that the DES
       
   171 	initial permutation (IP) and final permutation (FP) have been left
       
   172 	out.  As for DES_encrypt1(), you should not use this function.
       
   173 	It is used by the routines in the library that implement triple DES.
       
   174 	IP() DES_encrypt2() DES_encrypt2() DES_encrypt2() FP() is the same
       
   175 	as DES_encrypt1() DES_encrypt1() DES_encrypt1() except faster :-). */
       
   176 IMPORT_C void DES_encrypt2(DES_LONG *data,DES_key_schedule *ks, int enc);
       
   177 
       
   178 IMPORT_C void DES_encrypt3(DES_LONG *data, DES_key_schedule *ks1,
       
   179 		  DES_key_schedule *ks2, DES_key_schedule *ks3);
       
   180 IMPORT_C void DES_decrypt3(DES_LONG *data, DES_key_schedule *ks1,
       
   181 		  DES_key_schedule *ks2, DES_key_schedule *ks3);
       
   182 IMPORT_C void DES_ede3_cbc_encrypt(const unsigned char *input,unsigned char *output, 
       
   183 			  long length,
       
   184 			  DES_key_schedule *ks1,DES_key_schedule *ks2,
       
   185 			  DES_key_schedule *ks3,DES_cblock *ivec,int enc);
       
   186 IMPORT_C void DES_ede3_cbcm_encrypt(const unsigned char *in,unsigned char *out,
       
   187 			   long length,
       
   188 			   DES_key_schedule *ks1,DES_key_schedule *ks2,
       
   189 			   DES_key_schedule *ks3,
       
   190 			   DES_cblock *ivec1,DES_cblock *ivec2,
       
   191 			   int enc);
       
   192 IMPORT_C void DES_ede3_cfb64_encrypt(const unsigned char *in,unsigned char *out,
       
   193 			    long length,DES_key_schedule *ks1,
       
   194 			    DES_key_schedule *ks2,DES_key_schedule *ks3,
       
   195 			    DES_cblock *ivec,int *num,int enc);
       
   196 IMPORT_C void DES_ede3_cfb_encrypt(const unsigned char *in,unsigned char *out,
       
   197 			  int numbits,long length,DES_key_schedule *ks1,
       
   198 			  DES_key_schedule *ks2,DES_key_schedule *ks3,
       
   199 			  DES_cblock *ivec,int enc);
       
   200 IMPORT_C void DES_ede3_ofb64_encrypt(const unsigned char *in,unsigned char *out,
       
   201 			    long length,DES_key_schedule *ks1,
       
   202 			    DES_key_schedule *ks2,DES_key_schedule *ks3,
       
   203 			    DES_cblock *ivec,int *num);
       
   204 
       
   205 IMPORT_C void DES_xwhite_in2out(const_DES_cblock *DES_key,const_DES_cblock *in_white,
       
   206 		       DES_cblock *out_white);
       
   207 
       
   208 IMPORT_C int DES_enc_read(int fd,void *buf,int len,DES_key_schedule *sched,
       
   209 		 DES_cblock *iv);
       
   210 IMPORT_C int DES_enc_write(int fd,const void *buf,int len,DES_key_schedule *sched,
       
   211 		  DES_cblock *iv);
       
   212 IMPORT_C char *DES_fcrypt(const char *buf,const char *salt, char *ret);
       
   213 IMPORT_C char *DES_crypt(const char *buf,const char *salt);
       
   214 IMPORT_C void DES_ofb_encrypt(const unsigned char *in,unsigned char *out,int numbits,
       
   215 		     long length,DES_key_schedule *schedule,DES_cblock *ivec);
       
   216 IMPORT_C void DES_pcbc_encrypt(const unsigned char *input,unsigned char *output,
       
   217 		      long length,DES_key_schedule *schedule,DES_cblock *ivec,
       
   218 		      int enc);
       
   219 IMPORT_C DES_LONG DES_quad_cksum(const unsigned char *input,DES_cblock output[],
       
   220 			long length,int out_count,DES_cblock *seed);
       
   221 IMPORT_C int DES_random_key(DES_cblock *ret);
       
   222 IMPORT_C void DES_set_odd_parity(DES_cblock *key);
       
   223 IMPORT_C int DES_check_key_parity(const_DES_cblock *key);
       
   224 IMPORT_C int DES_is_weak_key(const_DES_cblock *key);
       
   225 /* DES_set_key (= set_key = DES_key_sched = key_sched) calls
       
   226  * DES_set_key_checked if global variable DES_check_key is set,
       
   227  * DES_set_key_unchecked otherwise. */
       
   228 IMPORT_C int DES_set_key(const_DES_cblock *key,DES_key_schedule *schedule);
       
   229 IMPORT_C int DES_key_sched(const_DES_cblock *key,DES_key_schedule *schedule);
       
   230 IMPORT_C int DES_set_key_checked(const_DES_cblock *key,DES_key_schedule *schedule);
       
   231 IMPORT_C void DES_set_key_unchecked(const_DES_cblock *key,DES_key_schedule *schedule);
       
   232 IMPORT_C void DES_string_to_key(const char *str,DES_cblock *key);
       
   233 IMPORT_C void DES_string_to_2keys(const char *str,DES_cblock *key1,DES_cblock *key2);
       
   234 IMPORT_C void DES_cfb64_encrypt(const unsigned char *in,unsigned char *out,long length,
       
   235 		       DES_key_schedule *schedule,DES_cblock *ivec,int *num,
       
   236 		       int enc);
       
   237 IMPORT_C void DES_ofb64_encrypt(const unsigned char *in,unsigned char *out,long length,
       
   238 		       DES_key_schedule *schedule,DES_cblock *ivec,int *num);
       
   239 
       
   240 IMPORT_C int DES_read_password(DES_cblock *key, const char *prompt, int verify);
       
   241 IMPORT_C int DES_read_2passwords(DES_cblock *key1, DES_cblock *key2, const char *prompt,
       
   242 	int verify);
       
   243 
       
   244 #define DES_fixup_key_parity DES_set_odd_parity
       
   245 
       
   246 #ifdef  __cplusplus
       
   247 }
       
   248 #endif
       
   249 
       
   250 #endif