Annotation of src/include/des.h, Revision 1.1
1.1 ! provos 1: /* crypto/des/des.h */
! 2: /* Copyright (C) 1995-1997 Eric Young (eay@mincom.oz.au)
! 3: * All rights reserved.
! 4: *
! 5: * This package is an SSL implementation written
! 6: * by Eric Young (eay@mincom.oz.au).
! 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@mincom.oz.au).
! 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@mincom.oz.au)"
! 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@mincom.oz.au)"
! 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: #ifndef HEADER_DES_H
! 60: #define HEADER_DES_H
! 61:
! 62: #ifdef __cplusplus
! 63: extern "C" {
! 64: #endif
! 65:
! 66: #include <stdio.h>
! 67:
! 68: /* If this is set to 'unsigned int' on a DEC Alpha, this gives about a
! 69: * %20 speed up (longs are 8 bytes, int's are 4). */
! 70: #ifndef DES_LONG
! 71: #define DES_LONG unsigned long
! 72: #endif
! 73:
! 74: typedef unsigned char des_cblock[8];
! 75: typedef struct des_ks_struct
! 76: {
! 77: union {
! 78: des_cblock _;
! 79: /* make sure things are correct size on machines with
! 80: * 8 byte longs */
! 81: DES_LONG pad[2];
! 82: } ks;
! 83: #undef _
! 84: #define _ ks._
! 85: } des_key_schedule[16];
! 86:
! 87: #define DES_KEY_SZ (sizeof(des_cblock))
! 88: #define DES_SCHEDULE_SZ (sizeof(des_key_schedule))
! 89:
! 90: #define DES_ENCRYPT 1
! 91: #define DES_DECRYPT 0
! 92:
! 93: #define DES_CBC_MODE 0
! 94: #define DES_PCBC_MODE 1
! 95:
! 96: #define des_ecb2_encrypt(i,o,k1,k2,e) \
! 97: des_ecb3_encrypt((i),(o),(k1),(k2),(k1),(e))
! 98:
! 99: #define des_ede2_cbc_encrypt(i,o,l,k1,k2,iv,e) \
! 100: des_ede3_cbc_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(e))
! 101:
! 102: #define des_ede2_cfb64_encrypt(i,o,l,k1,k2,iv,n,e) \
! 103: des_ede3_cfb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n),(e))
! 104:
! 105: #define des_ede2_ofb64_encrypt(i,o,l,k1,k2,iv,n) \
! 106: des_ede3_ofb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n))
! 107:
! 108: #define C_Block des_cblock
! 109: #define Key_schedule des_key_schedule
! 110: #define des_set_key_schedule des_set_key
! 111: #ifdef KERBEROS
! 112: #define ENCRYPT DES_ENCRYPT
! 113: #define DECRYPT DES_DECRYPT
! 114: #endif
! 115: #define KEY_SZ DES_KEY_SZ
! 116: #define string_to_key des_string_to_key
! 117: #define read_pw_string des_read_pw_string
! 118: #define random_key des_random_key
! 119: #define pcbc_encrypt des_pcbc_encrypt
! 120: #define set_key des_set_key
! 121: #define key_sched des_key_sched
! 122: #define ecb_encrypt des_ecb_encrypt
! 123: #define cbc_encrypt des_cbc_encrypt
! 124: #define ncbc_encrypt des_ncbc_encrypt
! 125: #define xcbc_encrypt des_xcbc_encrypt
! 126: #define cbc_cksum des_cbc_cksum
! 127: #define quad_cksum des_quad_cksum
! 128:
! 129: /* For compatibility with the MIT lib - eay 20/05/92 */
! 130: typedef des_key_schedule bit_64;
! 131: #define des_fixup_key_parity des_set_odd_parity
! 132: #define des_check_key_parity check_parity
! 133:
! 134: extern int des_check_key; /* defaults to false */
! 135: extern int des_rw_mode; /* defaults to DES_PCBC_MODE */
! 136:
! 137: /* The next line is used to disable full ANSI prototypes, if your
! 138: * compiler has problems with the prototypes, make sure this line always
! 139: * evaluates to true :-) */
! 140: #if defined(MSDOS) || defined(__STDC__)
! 141: #undef _DES_NOPROTO
! 142: #endif
! 143: #ifndef _DES_NOPROTO
! 144: char *des_options(void);
! 145: void des_ecb3_encrypt(des_cblock *input,des_cblock *output,
! 146: des_key_schedule ks1,des_key_schedule ks2,
! 147: des_key_schedule ks3, int enc);
! 148: DES_LONG des_cbc_cksum(des_cblock *input,des_cblock *output,
! 149: long length,des_key_schedule schedule,des_cblock *ivec);
! 150: void des_cbc_encrypt(des_cblock *input,des_cblock *output,long length,
! 151: des_key_schedule schedule,des_cblock *ivec,int enc);
! 152: void des_ncbc_encrypt(des_cblock *input,des_cblock *output,long length,
! 153: des_key_schedule schedule,des_cblock *ivec,int enc);
! 154: void des_xcbc_encrypt(des_cblock *input,des_cblock *output,long length,
! 155: des_key_schedule schedule,des_cblock *ivec,
! 156: des_cblock *inw,des_cblock *outw,int enc);
! 157: void des_3cbc_encrypt(des_cblock *input,des_cblock *output,long length,
! 158: des_key_schedule sk1,des_key_schedule sk2,
! 159: des_cblock *ivec1,des_cblock *ivec2,int enc);
! 160: void des_cfb_encrypt(unsigned char *in,unsigned char *out,int numbits,
! 161: long length,des_key_schedule schedule,des_cblock *ivec,int enc);
! 162: void des_ecb_encrypt(des_cblock *input,des_cblock *output,
! 163: des_key_schedule ks,int enc);
! 164: void des_encrypt(DES_LONG *data,des_key_schedule ks, int enc);
! 165: void des_encrypt2(DES_LONG *data,des_key_schedule ks, int enc);
! 166: void des_encrypt3(DES_LONG *data, des_key_schedule ks1,
! 167: des_key_schedule ks2, des_key_schedule ks3);
! 168: void des_decrypt3(DES_LONG *data, des_key_schedule ks1,
! 169: des_key_schedule ks2, des_key_schedule ks3);
! 170: void des_ede3_cbc_encrypt(des_cblock *input, des_cblock *output,
! 171: long length, des_key_schedule ks1, des_key_schedule ks2,
! 172: des_key_schedule ks3, des_cblock *ivec, int enc);
! 173: void des_ede3_cfb64_encrypt(unsigned char *in, unsigned char *out,
! 174: long length, des_key_schedule ks1, des_key_schedule ks2,
! 175: des_key_schedule ks3, des_cblock *ivec, int *num, int encrypt);
! 176: void des_ede3_ofb64_encrypt(unsigned char *in, unsigned char *out,
! 177: long length, des_key_schedule ks1, des_key_schedule ks2,
! 178: des_key_schedule ks3, des_cblock *ivec, int *num);
! 179:
! 180: int des_enc_read(int fd,char *buf,int len,des_key_schedule sched,
! 181: des_cblock *iv);
! 182: int des_enc_write(int fd,char *buf,int len,des_key_schedule sched,
! 183: des_cblock *iv);
! 184: char *des_fcrypt(const char *buf,const char *salt, char *ret);
! 185: #ifdef PERL5
! 186: char *des_crypt(const char *buf,const char *salt);
! 187: #else
! 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: #endif
! 196: void des_ofb_encrypt(unsigned char *in,unsigned char *out,
! 197: int numbits,long length,des_key_schedule schedule,des_cblock *ivec);
! 198: void des_pcbc_encrypt(des_cblock *input,des_cblock *output,long length,
! 199: des_key_schedule schedule,des_cblock *ivec,int enc);
! 200: DES_LONG des_quad_cksum(des_cblock *input,des_cblock *output,
! 201: long length,int out_count,des_cblock *seed);
! 202: void des_random_seed(des_cblock key);
! 203: void des_random_key(des_cblock ret);
! 204: int des_read_password(des_cblock *key,char *prompt,int verify);
! 205: int des_read_2passwords(des_cblock *key1,des_cblock *key2,
! 206: char *prompt,int verify);
! 207: int des_read_pw_string(char *buf,int length,char *prompt,int verify);
! 208: void des_set_odd_parity(des_cblock *key);
! 209: int des_is_weak_key(des_cblock *key);
! 210: int des_set_key(des_cblock *key,des_key_schedule schedule);
! 211: int des_key_sched(des_cblock *key,des_key_schedule schedule);
! 212: void des_string_to_key(char *str,des_cblock *key);
! 213: void des_string_to_2keys(char *str,des_cblock *key1,des_cblock *key2);
! 214: void des_cfb64_encrypt(unsigned char *in, unsigned char *out, long length,
! 215: des_key_schedule schedule, des_cblock *ivec, int *num, int enc);
! 216: void des_ofb64_encrypt(unsigned char *in, unsigned char *out, long length,
! 217: des_key_schedule schedule, des_cblock *ivec, int *num);
! 218:
! 219: /* Extra functions from Mark Murray <mark@grondar.za> */
! 220: void des_cblock_print_file(des_cblock *cb, FILE *fp);
! 221: /* The following functions are not in the normal unix build or the
! 222: * SSLeay build. When using the SSLeay build, use RAND_seed()
! 223: * and RAND_bytes() instead. */
! 224: int des_new_random_key(des_cblock *key);
! 225: void des_init_random_number_generator(des_cblock *key);
! 226: void des_set_random_generator_seed(des_cblock *key);
! 227: void des_set_sequence_number(des_cblock new_sequence_number);
! 228: void des_generate_random_block(des_cblock *block);
! 229:
! 230: #else
! 231:
! 232: char *des_options();
! 233: void des_ecb3_encrypt();
! 234: DES_LONG des_cbc_cksum();
! 235: void des_cbc_encrypt();
! 236: void des_ncbc_encrypt();
! 237: void des_xcbc_encrypt();
! 238: void des_3cbc_encrypt();
! 239: void des_cfb_encrypt();
! 240: void des_ede3_cfb64_encrypt();
! 241: void des_ede3_ofb64_encrypt();
! 242: void des_ecb_encrypt();
! 243: void des_encrypt();
! 244: void des_encrypt2();
! 245: void des_encrypt3();
! 246: void des_decrypt3();
! 247: void des_ede3_cbc_encrypt();
! 248: int des_enc_read();
! 249: int des_enc_write();
! 250: char *des_fcrypt();
! 251: #ifdef PERL5
! 252: char *des_crypt();
! 253: #else
! 254: char *crypt();
! 255: #endif
! 256: void des_ofb_encrypt();
! 257: void des_pcbc_encrypt();
! 258: DES_LONG des_quad_cksum();
! 259: void des_random_seed();
! 260: void des_random_key();
! 261: int des_read_password();
! 262: int des_read_2passwords();
! 263: int des_read_pw_string();
! 264: void des_set_odd_parity();
! 265: int des_is_weak_key();
! 266: int des_set_key();
! 267: int des_key_sched();
! 268: void des_string_to_key();
! 269: void des_string_to_2keys();
! 270: void des_cfb64_encrypt();
! 271: void des_ofb64_encrypt();
! 272:
! 273: /* Extra functions from Mark Murray <mark@grondar.za> */
! 274: void des_cblock_print_file();
! 275: /* The following functions are not in the normal unix build or the
! 276: * SSLeay build. When using the SSLeay build, use RAND_seed()
! 277: * and RAND_bytes() instead. */
! 278: #ifdef FreeBSD
! 279: int des_new_random_key();
! 280: void des_init_random_number_generator();
! 281: void des_set_random_generator_seed();
! 282: void des_set_sequence_number();
! 283: void des_generate_random_block();
! 284: #endif
! 285:
! 286: #endif
! 287:
! 288: #ifdef __cplusplus
! 289: }
! 290: #endif
! 291:
! 292: #endif