Annotation of src/include/des.h, Revision 1.3
1.3 ! art 1: /* $OpenBSD: des.h,v 1.2 1997/09/21 10:45:30 niklas Exp $ */
1.2 niklas 2:
1.1 provos 3: /* crypto/des/des.h */
4: /* Copyright (C) 1995-1997 Eric Young (eay@mincom.oz.au)
5: * All rights reserved.
6: *
7: * This package is an SSL implementation written
8: * by Eric Young (eay@mincom.oz.au).
9: * The implementation was written so as to conform with Netscapes SSL.
10: *
11: * This library is free for commercial and non-commercial use as long as
12: * the following conditions are aheared to. The following conditions
13: * apply to all code found in this distribution, be it the RC4, RSA,
14: * lhash, DES, etc., code; not just the SSL code. The SSL documentation
15: * included with this distribution is covered by the same copyright terms
16: * except that the holder is Tim Hudson (tjh@mincom.oz.au).
17: *
18: * Copyright remains Eric Young's, and as such any Copyright notices in
19: * the code are not to be removed.
20: * If this package is used in a product, Eric Young should be given attribution
21: * as the author of the parts of the library used.
22: * This can be in the form of a textual message at program startup or
23: * in documentation (online or textual) provided with the package.
24: *
25: * Redistribution and use in source and binary forms, with or without
26: * modification, are permitted provided that the following conditions
27: * are met:
28: * 1. Redistributions of source code must retain the copyright
29: * notice, this list of conditions and the following disclaimer.
30: * 2. Redistributions in binary form must reproduce the above copyright
31: * notice, this list of conditions and the following disclaimer in the
32: * documentation and/or other materials provided with the distribution.
33: * 3. All advertising materials mentioning features or use of this software
34: * must display the following acknowledgement:
35: * "This product includes cryptographic software written by
36: * Eric Young (eay@mincom.oz.au)"
37: * The word 'cryptographic' can be left out if the rouines from the library
38: * being used are not cryptographic related :-).
39: * 4. If you include any Windows specific code (or a derivative thereof) from
40: * the apps directory (application code) you must include an acknowledgement:
41: * "This product includes software written by Tim Hudson (tjh@mincom.oz.au)"
42: *
43: * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
44: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46: * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
47: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53: * SUCH DAMAGE.
54: *
55: * The licence and distribution terms for any publically available version or
56: * derivative of this code cannot be changed. i.e. this code cannot simply be
57: * copied and put under another distribution licence
58: * [including the GNU Public Licence.]
59: */
60:
61: #ifndef HEADER_DES_H
62: #define HEADER_DES_H
63:
64: #ifdef __cplusplus
65: extern "C" {
66: #endif
67:
68: #include <stdio.h>
69:
70: /* If this is set to 'unsigned int' on a DEC Alpha, this gives about a
71: * %20 speed up (longs are 8 bytes, int's are 4). */
72: #ifndef DES_LONG
73: #define DES_LONG unsigned long
74: #endif
75:
76: typedef unsigned char des_cblock[8];
77: typedef struct des_ks_struct
78: {
79: union {
80: des_cblock _;
81: /* make sure things are correct size on machines with
82: * 8 byte longs */
83: DES_LONG pad[2];
84: } ks;
85: #undef _
86: #define _ ks._
87: } des_key_schedule[16];
88:
89: #define DES_KEY_SZ (sizeof(des_cblock))
90: #define DES_SCHEDULE_SZ (sizeof(des_key_schedule))
91:
92: #define DES_ENCRYPT 1
93: #define DES_DECRYPT 0
94:
95: #define DES_CBC_MODE 0
96: #define DES_PCBC_MODE 1
97:
98: #define des_ecb2_encrypt(i,o,k1,k2,e) \
99: des_ecb3_encrypt((i),(o),(k1),(k2),(k1),(e))
100:
101: #define des_ede2_cbc_encrypt(i,o,l,k1,k2,iv,e) \
102: des_ede3_cbc_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(e))
103:
104: #define des_ede2_cfb64_encrypt(i,o,l,k1,k2,iv,n,e) \
105: des_ede3_cfb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n),(e))
106:
107: #define des_ede2_ofb64_encrypt(i,o,l,k1,k2,iv,n) \
108: des_ede3_ofb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n))
109:
110: #define C_Block des_cblock
111: #define Key_schedule des_key_schedule
112: #define des_set_key_schedule des_set_key
113: #ifdef KERBEROS
114: #define ENCRYPT DES_ENCRYPT
115: #define DECRYPT DES_DECRYPT
116: #endif
117: #define KEY_SZ DES_KEY_SZ
118: #define string_to_key des_string_to_key
119: #define read_pw_string des_read_pw_string
120: #define random_key des_random_key
121: #define pcbc_encrypt des_pcbc_encrypt
122: #define set_key des_set_key
123: #define key_sched des_key_sched
124: #define ecb_encrypt des_ecb_encrypt
125: #define cbc_encrypt des_cbc_encrypt
126: #define ncbc_encrypt des_ncbc_encrypt
127: #define xcbc_encrypt des_xcbc_encrypt
128: #define cbc_cksum des_cbc_cksum
129: #define quad_cksum des_quad_cksum
130:
131: /* For compatibility with the MIT lib - eay 20/05/92 */
132: typedef des_key_schedule bit_64;
133: #define des_fixup_key_parity des_set_odd_parity
134: #define des_check_key_parity check_parity
135:
136: extern int des_check_key; /* defaults to false */
137: extern int des_rw_mode; /* defaults to DES_PCBC_MODE */
138:
139: /* The next line is used to disable full ANSI prototypes, if your
140: * compiler has problems with the prototypes, make sure this line always
141: * evaluates to true :-) */
142: #if defined(MSDOS) || defined(__STDC__)
143: #undef _DES_NOPROTO
144: #endif
145: #ifndef _DES_NOPROTO
146: char *des_options(void);
147: void des_ecb3_encrypt(des_cblock *input,des_cblock *output,
148: des_key_schedule ks1,des_key_schedule ks2,
149: des_key_schedule ks3, int enc);
150: DES_LONG des_cbc_cksum(des_cblock *input,des_cblock *output,
151: long length,des_key_schedule schedule,des_cblock *ivec);
152: void des_cbc_encrypt(des_cblock *input,des_cblock *output,long length,
153: des_key_schedule schedule,des_cblock *ivec,int enc);
154: void des_ncbc_encrypt(des_cblock *input,des_cblock *output,long length,
155: des_key_schedule schedule,des_cblock *ivec,int enc);
156: void des_xcbc_encrypt(des_cblock *input,des_cblock *output,long length,
157: des_key_schedule schedule,des_cblock *ivec,
158: des_cblock *inw,des_cblock *outw,int enc);
159: void des_3cbc_encrypt(des_cblock *input,des_cblock *output,long length,
160: des_key_schedule sk1,des_key_schedule sk2,
161: des_cblock *ivec1,des_cblock *ivec2,int enc);
162: void des_cfb_encrypt(unsigned char *in,unsigned char *out,int numbits,
163: long length,des_key_schedule schedule,des_cblock *ivec,int enc);
164: void des_ecb_encrypt(des_cblock *input,des_cblock *output,
165: des_key_schedule ks,int enc);
166: void des_encrypt(DES_LONG *data,des_key_schedule ks, int enc);
167: void des_encrypt2(DES_LONG *data,des_key_schedule ks, int enc);
168: void des_encrypt3(DES_LONG *data, des_key_schedule ks1,
169: des_key_schedule ks2, des_key_schedule ks3);
170: void des_decrypt3(DES_LONG *data, des_key_schedule ks1,
171: des_key_schedule ks2, des_key_schedule ks3);
172: void des_ede3_cbc_encrypt(des_cblock *input, des_cblock *output,
173: long length, des_key_schedule ks1, des_key_schedule ks2,
174: des_key_schedule ks3, des_cblock *ivec, int enc);
175: void des_ede3_cfb64_encrypt(unsigned char *in, unsigned char *out,
176: long length, des_key_schedule ks1, des_key_schedule ks2,
177: des_key_schedule ks3, des_cblock *ivec, int *num, int encrypt);
178: void des_ede3_ofb64_encrypt(unsigned char *in, unsigned char *out,
179: long length, des_key_schedule ks1, des_key_schedule ks2,
180: des_key_schedule ks3, des_cblock *ivec, int *num);
181:
182: int des_enc_read(int fd,char *buf,int len,des_key_schedule sched,
183: des_cblock *iv);
184: int des_enc_write(int fd,char *buf,int len,des_key_schedule sched,
185: des_cblock *iv);
186: char *des_fcrypt(const char *buf,const char *salt, char *ret);
187: char *des_crypt(const char *buf,const char *salt);
188: /* some stupid compilers complain because I have declared char instead
189: * of const char */
190: #ifdef HEADER_DES_LOCL_H
191: char *crypt(const char *buf,const char *salt);
192: #else
193: char *crypt();
194: #endif
195: void des_ofb_encrypt(unsigned char *in,unsigned char *out,
196: int numbits,long length,des_key_schedule schedule,des_cblock *ivec);
197: void des_pcbc_encrypt(des_cblock *input,des_cblock *output,long length,
198: des_key_schedule schedule,des_cblock *ivec,int enc);
199: DES_LONG des_quad_cksum(des_cblock *input,des_cblock *output,
200: long length,int out_count,des_cblock *seed);
201: void des_random_seed(des_cblock key);
202: void des_random_key(des_cblock ret);
203: int des_read_password(des_cblock *key,char *prompt,int verify);
204: int des_read_2passwords(des_cblock *key1,des_cblock *key2,
205: char *prompt,int verify);
206: int des_read_pw_string(char *buf,int length,char *prompt,int verify);
207: void des_set_odd_parity(des_cblock *key);
208: int des_is_weak_key(des_cblock *key);
209: int des_set_key(des_cblock *key,des_key_schedule schedule);
210: int des_key_sched(des_cblock *key,des_key_schedule schedule);
211: void des_string_to_key(char *str,des_cblock *key);
212: void des_string_to_2keys(char *str,des_cblock *key1,des_cblock *key2);
213: void des_cfb64_encrypt(unsigned char *in, unsigned char *out, long length,
214: des_key_schedule schedule, des_cblock *ivec, int *num, int enc);
215: void des_ofb64_encrypt(unsigned char *in, unsigned char *out, long length,
216: des_key_schedule schedule, des_cblock *ivec, int *num);
217:
218: /* Extra functions from Mark Murray <mark@grondar.za> */
219: void des_cblock_print_file(des_cblock *cb, FILE *fp);
220: /* The following functions are not in the normal unix build or the
221: * SSLeay build. When using the SSLeay build, use RAND_seed()
222: * and RAND_bytes() instead. */
223: int des_new_random_key(des_cblock *key);
224: void des_init_random_number_generator(des_cblock *key);
225: void des_set_random_generator_seed(des_cblock *key);
226: void des_set_sequence_number(des_cblock new_sequence_number);
227: void des_generate_random_block(des_cblock *block);
228:
229: #else
230:
231: char *des_options();
232: void des_ecb3_encrypt();
233: DES_LONG des_cbc_cksum();
234: void des_cbc_encrypt();
235: void des_ncbc_encrypt();
236: void des_xcbc_encrypt();
237: void des_3cbc_encrypt();
238: void des_cfb_encrypt();
239: void des_ede3_cfb64_encrypt();
240: void des_ede3_ofb64_encrypt();
241: void des_ecb_encrypt();
242: void des_encrypt();
243: void des_encrypt2();
244: void des_encrypt3();
245: void des_decrypt3();
246: void des_ede3_cbc_encrypt();
247: int des_enc_read();
248: int des_enc_write();
249: char *des_fcrypt();
250: char *des_crypt();
251: char *crypt();
252: void des_ofb_encrypt();
253: void des_pcbc_encrypt();
254: DES_LONG des_quad_cksum();
255: void des_random_seed();
256: void des_random_key();
257: int des_read_password();
258: int des_read_2passwords();
259: int des_read_pw_string();
260: void des_set_odd_parity();
261: int des_is_weak_key();
262: int des_set_key();
263: int des_key_sched();
264: void des_string_to_key();
265: void des_string_to_2keys();
266: void des_cfb64_encrypt();
267: void des_ofb64_encrypt();
268:
269: /* Extra functions from Mark Murray <mark@grondar.za> */
270: void des_cblock_print_file();
271: /* The following functions are not in the normal unix build or the
272: * SSLeay build. When using the SSLeay build, use RAND_seed()
273: * and RAND_bytes() instead. */
274: #ifdef FreeBSD
275: int des_new_random_key();
276: void des_init_random_number_generator();
277: void des_set_random_generator_seed();
278: void des_set_sequence_number();
279: void des_generate_random_block();
280: #endif
281:
282: #endif
283:
284: #ifdef __cplusplus
285: }
286: #endif
287:
288: #endif