2 /* Copyright (C) 1995-1997 Eric Young (eay@cryptsoft.com)
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.
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).
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.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
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)"
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
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.]
59 © Portions copyright (c) 2006 Nokia Corporation. All rights reserved.
62 #ifndef HEADER_NEW_DES_H
63 #define HEADER_NEW_DES_H
67 #include <openssl/e_os2.h> /* OPENSSL_EXTERN, OPENSSL_NO_DES,
68 DES_LONG (via openssl/opensslconf.h */
72 #error DES is disabled.
75 #ifdef OPENSSL_BUILD_SHLIBCRYPTO
76 # undef OPENSSL_EXTERN
77 # define OPENSSL_EXTERN OPENSSL_EXPORT
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. */
94 /* make sure things are correct size on machines with
100 #ifndef OPENSSL_DISABLE_OLD_DES_SUPPORT
101 # ifndef OPENSSL_ENABLE_OLD_DES_SUPPORT
102 # define OPENSSL_ENABLE_OLD_DES_SUPPORT
106 #ifdef OPENSSL_ENABLE_OLD_DES_SUPPORT
107 # include <openssl/des_old.h>
109 #define DES_KEY_SZ (sizeof(DES_cblock))
110 #define DES_SCHEDULE_SZ (sizeof(DES_key_schedule))
112 #define DES_ENCRYPT 1
113 #define DES_DECRYPT 0
115 #define DES_CBC_MODE 0
116 #define DES_PCBC_MODE 1
118 #define DES_ecb2_encrypt(i,o,k1,k2,e) \
119 DES_ecb3_encrypt((i),(o),(k1),(k2),(k1),(e))
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))
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))
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__)))
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)
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,
147 IMPORT_C void DES_ncbc_encrypt(const unsigned char *input,unsigned char *output,
148 long length,DES_key_schedule *schedule,DES_cblock *ivec,
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,
156 IMPORT_C void DES_ecb_encrypt(const_DES_cblock *input,DES_cblock *output,
157 DES_key_schedule *ks,int enc);
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);
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);
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,
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,
188 DES_key_schedule *ks1,DES_key_schedule *ks2,
189 DES_key_schedule *ks3,
190 DES_cblock *ivec1,DES_cblock *ivec2,
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);
205 IMPORT_C void DES_xwhite_in2out(const_DES_cblock *DES_key,const_DES_cblock *in_white,
206 DES_cblock *out_white);
208 IMPORT_C int DES_enc_read(int fd,void *buf,int len,DES_key_schedule *sched,
210 IMPORT_C int DES_enc_write(int fd,const void *buf,int len,DES_key_schedule *sched,
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,
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,
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);
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,
244 #define DES_fixup_key_parity DES_set_odd_parity