![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rsaref.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [rsaref] / rsaref / source|
Return to rsaref.h CVS log | Up to [rsaref] / rsaref / source |
1.1 root 1: /* RSAREF.H - header file for RSAREF cryptographic toolkit
2: */
3:
1.1.1.2 ! root 4: /* Copyright (C) RSA Laboratories, a division of RSA Data Security,
! 5: Inc., created 1991. All rights reserved.
1.1 root 6: */
7:
1.1.1.2 ! root 8: #ifndef _RSAREF_H_
! 9: #define _RSAREF_H_ 1
! 10:
! 11: #include "md2.h"
! 12: #include "md5.h"
! 13: #include "des.h"
! 14:
! 15: #ifdef __cplusplus
! 16: extern "C" {
! 17: #endif
! 18:
1.1 root 19: /* Message-digest algorithms.
20: */
21: #define DA_MD2 3
22: #define DA_MD5 5
23:
1.1.1.2 ! root 24: /* Encryption algorithms to be ored with digest algorithm in Seal and Open.
! 25: */
! 26: #define EA_DES_CBC 1
! 27: #define EA_DES_EDE2_CBC 2
! 28: #define EA_DES_EDE3_CBC 3
! 29: #define EA_DESX_CBC 4
! 30:
1.1 root 31: /* RSA key lengths.
32: */
33: #define MIN_RSA_MODULUS_BITS 508
34: #define MAX_RSA_MODULUS_BITS 1024
35: #define MAX_RSA_MODULUS_LEN ((MAX_RSA_MODULUS_BITS + 7) / 8)
36: #define MAX_RSA_PRIME_BITS ((MAX_RSA_MODULUS_BITS + 1) / 2)
37: #define MAX_RSA_PRIME_LEN ((MAX_RSA_PRIME_BITS + 7) / 8)
38:
39: /* Maximum lengths of encoded and encrypted content, as a function of
40: content length len. Also, inverse functions.
41: */
42: #define ENCODED_CONTENT_LEN(len) (4*(len)/3 + 3)
43: #define ENCRYPTED_CONTENT_LEN(len) ENCODED_CONTENT_LEN ((len)+8)
44: #define DECODED_CONTENT_LEN(len) (3*(len)/4 + 1)
1.1.1.2 ! root 45: #define DECRYPTED_CONTENT_LEN(len) (DECODED_CONTENT_LEN (len) - 1)
1.1 root 46:
47: /* Maximum lengths of signatures, encrypted keys, encrypted
48: signatures, and message digests.
49: */
50: #define MAX_SIGNATURE_LEN MAX_RSA_MODULUS_LEN
51: #define MAX_PEM_SIGNATURE_LEN ENCODED_CONTENT_LEN (MAX_SIGNATURE_LEN)
1.1.1.2 ! root 52: #define MAX_ENCRYPTED_KEY_LEN MAX_RSA_MODULUS_LEN
! 53: #define MAX_PEM_ENCRYPTED_KEY_LEN ENCODED_CONTENT_LEN (MAX_ENCRYPTED_KEY_LEN)
1.1 root 54: #define MAX_PEM_ENCRYPTED_SIGNATURE_LEN \
55: ENCRYPTED_CONTENT_LEN (MAX_SIGNATURE_LEN)
56: #define MAX_DIGEST_LEN 16
57:
1.1.1.2 ! root 58: /* Maximum length of Diffie-Hellman parameters.
! 59: */
! 60: #define DH_PRIME_LEN(bits) (((bits) + 7) / 8)
! 61:
1.1 root 62: /* Error codes.
63: */
64: #define RE_CONTENT_ENCODING 0x0400
65: #define RE_DATA 0x0401
66: #define RE_DIGEST_ALGORITHM 0x0402
67: #define RE_ENCODING 0x0403
68: #define RE_KEY 0x0404
69: #define RE_KEY_ENCODING 0x0405
70: #define RE_LEN 0x0406
71: #define RE_MODULUS_LEN 0x0407
72: #define RE_NEED_RANDOM 0x0408
73: #define RE_PRIVATE_KEY 0x0409
74: #define RE_PUBLIC_KEY 0x040a
75: #define RE_SIGNATURE 0x040b
76: #define RE_SIGNATURE_ENCODING 0x040c
1.1.1.2 ! root 77: #define RE_ENCRYPTION_ALGORITHM 0x040d
1.1 root 78:
79: /* Random structure.
80: */
81: typedef struct {
82: unsigned int bytesNeeded;
83: unsigned char state[16];
84: unsigned int outputAvailable;
85: unsigned char output[16];
86: } R_RANDOM_STRUCT;
87:
88: /* RSA public and private key.
89: */
90: typedef struct {
91: unsigned int bits; /* length in bits of modulus */
92: unsigned char modulus[MAX_RSA_MODULUS_LEN]; /* modulus */
93: unsigned char exponent[MAX_RSA_MODULUS_LEN]; /* public exponent */
94: } R_RSA_PUBLIC_KEY;
95:
96: typedef struct {
97: unsigned int bits; /* length in bits of modulus */
98: unsigned char modulus[MAX_RSA_MODULUS_LEN]; /* modulus */
99: unsigned char publicExponent[MAX_RSA_MODULUS_LEN]; /* public exponent */
100: unsigned char exponent[MAX_RSA_MODULUS_LEN]; /* private exponent */
101: unsigned char prime[2][MAX_RSA_PRIME_LEN]; /* prime factors */
102: unsigned char primeExponent[2][MAX_RSA_PRIME_LEN]; /* exponents for CRT */
103: unsigned char coefficient[MAX_RSA_PRIME_LEN]; /* CRT coefficient */
104: } R_RSA_PRIVATE_KEY;
105:
106: /* RSA prototype key.
107: */
108: typedef struct {
109: unsigned int bits; /* length in bits of modulus */
110: int useFermat4; /* public exponent (1 = F4, 0 = 3) */
111: } R_RSA_PROTO_KEY;
112:
1.1.1.2 ! root 113: /* Diffie-Hellman parameters.
! 114: */
! 115: typedef struct {
! 116: unsigned char *prime; /* prime */
! 117: unsigned int primeLen; /* length of prime */
! 118: unsigned char *generator; /* generator */
! 119: unsigned int generatorLen; /* length of generator */
! 120: } R_DH_PARAMS;
! 121:
! 122: typedef struct {
! 123: int digestAlgorithm;
! 124: union {
! 125: MD2_CTX md2;
! 126: MD5_CTX md5;
! 127: } context;
! 128: } R_DIGEST_CTX;
! 129:
! 130: typedef struct {
! 131: R_DIGEST_CTX digestContext;
! 132: } R_SIGNATURE_CTX;
! 133:
! 134: typedef struct {
! 135: int encryptionAlgorithm;
! 136: union {
! 137: DES_CBC_CTX des;
! 138: DES3_CBC_CTX des3;
! 139: DESX_CBC_CTX desx;
! 140: } cipherContext;
! 141:
! 142: unsigned char buffer[8];
! 143: unsigned int bufferLen;
! 144: } R_ENVELOPE_CTX;
! 145:
1.1 root 146: /* Random structures.
147: */
148: int R_RandomInit PROTO_LIST ((R_RANDOM_STRUCT *));
149: int R_RandomUpdate PROTO_LIST
150: ((R_RANDOM_STRUCT *, unsigned char *, unsigned int));
151: int R_GetRandomBytesNeeded PROTO_LIST ((unsigned int *, R_RANDOM_STRUCT *));
152: void R_RandomFinal PROTO_LIST ((R_RANDOM_STRUCT *));
153:
1.1.1.2 ! root 154: /* Cryptographic procedures "by parts"
! 155: */
! 156: int R_DigestInit PROTO_LIST ((R_DIGEST_CTX *, int));
! 157: int R_DigestUpdate PROTO_LIST
! 158: ((R_DIGEST_CTX *, unsigned char *, unsigned int));
! 159: int R_DigestFinal PROTO_LIST
! 160: ((R_DIGEST_CTX *, unsigned char *, unsigned int *));
! 161:
! 162: int R_SignInit PROTO_LIST ((R_SIGNATURE_CTX *, int));
! 163: int R_SignUpdate PROTO_LIST
! 164: ((R_SIGNATURE_CTX *, unsigned char *, unsigned int));
! 165: int R_SignFinal PROTO_LIST
! 166: ((R_SIGNATURE_CTX *, unsigned char *, unsigned int *, R_RSA_PRIVATE_KEY *));
! 167:
! 168: int R_VerifyInit PROTO_LIST ((R_SIGNATURE_CTX *, int));
! 169: int R_VerifyUpdate PROTO_LIST
! 170: ((R_SIGNATURE_CTX *, unsigned char *, unsigned int));
! 171: int R_VerifyFinal PROTO_LIST
! 172: ((R_SIGNATURE_CTX *, unsigned char *, unsigned int, R_RSA_PUBLIC_KEY *));
! 173:
! 174: int R_SealInit PROTO_LIST
! 175: ((R_ENVELOPE_CTX *, unsigned char **, unsigned int *, unsigned char [8],
! 176: unsigned int, R_RSA_PUBLIC_KEY **, int, R_RANDOM_STRUCT *));
! 177: int R_SealUpdate PROTO_LIST
! 178: ((R_ENVELOPE_CTX *, unsigned char *, unsigned int *, unsigned char *,
! 179: unsigned int));
! 180: int R_SealFinal PROTO_LIST
! 181: ((R_ENVELOPE_CTX *, unsigned char *, unsigned int *));
! 182:
! 183: int R_OpenInit PROTO_LIST
! 184: ((R_ENVELOPE_CTX *, int, unsigned char *, unsigned int, unsigned char [8],
! 185: R_RSA_PRIVATE_KEY *));
! 186: int R_OpenUpdate PROTO_LIST
! 187: ((R_ENVELOPE_CTX *, unsigned char *, unsigned int *, unsigned char *,
! 188: unsigned int));
! 189: int R_OpenFinal PROTO_LIST
! 190: ((R_ENVELOPE_CTX *, unsigned char *, unsigned int *));
! 191:
! 192: /* Cryptographic enhancements by block.
1.1 root 193: */
194: int R_SignPEMBlock PROTO_LIST
195: ((unsigned char *, unsigned int *, unsigned char *, unsigned int *,
196: unsigned char *, unsigned int, int, int, R_RSA_PRIVATE_KEY *));
1.1.1.2 ! root 197: int R_SignBlock PROTO_LIST
! 198: ((unsigned char *, unsigned int *, unsigned char *, unsigned int, int,
! 199: R_RSA_PRIVATE_KEY *));
1.1 root 200: int R_VerifyPEMSignature PROTO_LIST
201: ((unsigned char *, unsigned int *, unsigned char *, unsigned int,
202: unsigned char *, unsigned int, int, int, R_RSA_PUBLIC_KEY *));
203: int R_VerifyBlockSignature PROTO_LIST
204: ((unsigned char *, unsigned int, unsigned char *, unsigned int, int,
205: R_RSA_PUBLIC_KEY *));
206: int R_SealPEMBlock PROTO_LIST
207: ((unsigned char *, unsigned int *, unsigned char *, unsigned int *,
208: unsigned char *, unsigned int *, unsigned char [8], unsigned char *,
209: unsigned int, int, R_RSA_PUBLIC_KEY *, R_RSA_PRIVATE_KEY *,
210: R_RANDOM_STRUCT *));
211: int R_OpenPEMBlock PROTO_LIST
212: ((unsigned char *, unsigned int *, unsigned char *, unsigned int,
213: unsigned char *, unsigned int, unsigned char *, unsigned int,
214: unsigned char [8], int, R_RSA_PRIVATE_KEY *, R_RSA_PUBLIC_KEY *));
215: int R_DigestBlock PROTO_LIST
216: ((unsigned char *, unsigned int *, unsigned char *, unsigned int, int));
1.1.1.2 ! root 217:
! 218: /* Printable ASCII encoding and decoding.
! 219: */
! 220: int R_EncodePEMBlock PROTO_LIST
! 221: ((unsigned char *, unsigned int *, unsigned char *, unsigned int));
! 222: int R_DecodePEMBlock PROTO_LIST
! 223: ((unsigned char *, unsigned int *, unsigned char *, unsigned int));
1.1 root 224:
225: /* Key-pair generation.
226: */
227: int R_GeneratePEMKeys PROTO_LIST
228: ((R_RSA_PUBLIC_KEY *, R_RSA_PRIVATE_KEY *, R_RSA_PROTO_KEY *,
229: R_RANDOM_STRUCT *));
230:
1.1.1.2 ! root 231: /* Diffie-Hellman key agreement.
! 232: */
! 233: int R_GenerateDHParams PROTO_LIST
! 234: ((R_DH_PARAMS *, unsigned int, unsigned int, R_RANDOM_STRUCT *));
! 235: int R_SetupDHAgreement PROTO_LIST
! 236: ((unsigned char *, unsigned char *, unsigned int, R_DH_PARAMS *,
! 237: R_RANDOM_STRUCT *));
! 238: int R_ComputeDHAgreedKey PROTO_LIST
! 239: ((unsigned char *, unsigned char *, unsigned char *, unsigned int,
! 240: R_DH_PARAMS *));
! 241:
1.1 root 242: /* Routines supplied by the implementor.
243: */
244: void R_memset PROTO_LIST ((POINTER, int, unsigned int));
245: void R_memcpy PROTO_LIST ((POINTER, POINTER, unsigned int));
246: int R_memcmp PROTO_LIST ((POINTER, POINTER, unsigned int));
1.1.1.2 ! root 247:
! 248: #ifdef __cplusplus
! 249: }
! 250: #endif
! 251:
! 252: #endif
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.