]> git.ipfire.org Git - thirdparty/openssl.git/blame - include/openssl/rsa.h
Remove obsolete key formats.
[thirdparty/openssl.git] / include / openssl / rsa.h
CommitLineData
d02b48c6 1/* crypto/rsa/rsa.h */
58964a49 2/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
d02b48c6
RE
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.
0f113f3e 8 *
d02b48c6
RE
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).
0f113f3e 15 *
d02b48c6
RE
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.
0f113f3e 22 *
d02b48c6
RE
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 :-).
0f113f3e 37 * 4. If you include any Windows specific code (or a derivative thereof) from
d02b48c6
RE
38 * the apps directory (application code) you must include an acknowledgement:
39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
0f113f3e 40 *
d02b48c6
RE
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.
0f113f3e 52 *
d02b48c6
RE
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_RSA_H
0f113f3e 60# define HEADER_RSA_H
d02b48c6 61
0f113f3e 62# include <openssl/asn1.h>
78d3b819 63
a00ae6c4 64# include <openssl/bio.h>
0f113f3e
MC
65# include <openssl/crypto.h>
66# include <openssl/ossl_typ.h>
67# ifdef OPENSSL_USE_DEPRECATED
68# include <openssl/bn.h>
69# endif
d02b48c6 70
0f113f3e
MC
71# ifdef OPENSSL_NO_RSA
72# error RSA is disabled.
73# endif
f5d7a031 74
82271cee
RL
75#ifdef __cplusplus
76extern "C" {
77#endif
78
3a87a9b9
GT
79/* Declared already in ossl_typ.h */
80/* typedef struct rsa_st RSA; */
81/* typedef struct rsa_meth_st RSA_METHOD; */
03f8b042 82
0f113f3e
MC
83struct rsa_meth_st {
84 const char *name;
85 int (*rsa_pub_enc) (int flen, const unsigned char *from,
86 unsigned char *to, RSA *rsa, int padding);
87 int (*rsa_pub_dec) (int flen, const unsigned char *from,
88 unsigned char *to, RSA *rsa, int padding);
89 int (*rsa_priv_enc) (int flen, const unsigned char *from,
90 unsigned char *to, RSA *rsa, int padding);
91 int (*rsa_priv_dec) (int flen, const unsigned char *from,
92 unsigned char *to, RSA *rsa, int padding);
93 /* Can be null */
94 int (*rsa_mod_exp) (BIGNUM *r0, const BIGNUM *I, RSA *rsa, BN_CTX *ctx);
95 /* Can be null */
96 int (*bn_mod_exp) (BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
97 const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx);
98 /* called at new */
99 int (*init) (RSA *rsa);
100 /* called at free */
101 int (*finish) (RSA *rsa);
102 /* RSA_METHOD_FLAG_* things */
103 int flags;
104 /* may be needed! */
105 char *app_data;
106 /*
107 * New sign and verify functions: some libraries don't allow arbitrary
108 * data to be signed/verified: this allows them to be used. Note: for
109 * this to work the RSA_public_decrypt() and RSA_private_encrypt() should
110 * *NOT* be used RSA_sign(), RSA_verify() should be used instead. Note:
111 * for backwards compatibility this functionality is only enabled if the
112 * RSA_FLAG_SIGN_VER option is set in 'flags'.
113 */
114 int (*rsa_sign) (int type,
115 const unsigned char *m, unsigned int m_length,
116 unsigned char *sigret, unsigned int *siglen,
117 const RSA *rsa);
118 int (*rsa_verify) (int dtype, const unsigned char *m,
119 unsigned int m_length, const unsigned char *sigbuf,
120 unsigned int siglen, const RSA *rsa);
121 /*
122 * If this callback is NULL, the builtin software RSA key-gen will be
123 * used. This is for behavioural compatibility whilst the code gets
124 * rewired, but one day it would be nice to assume there are no such
125 * things as "builtin software" implementations.
126 */
127 int (*rsa_keygen) (RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb);
128};
129
130struct rsa_st {
131 /*
132 * The first parameter is used to pickup errors where this is passed
133 * instead of aEVP_PKEY, it is set to 0
134 */
135 int pad;
136 long version;
137 const RSA_METHOD *meth;
138 /* functional reference if 'meth' is ENGINE-provided */
139 ENGINE *engine;
140 BIGNUM *n;
141 BIGNUM *e;
142 BIGNUM *d;
143 BIGNUM *p;
144 BIGNUM *q;
145 BIGNUM *dmp1;
146 BIGNUM *dmq1;
147 BIGNUM *iqmp;
148 /* be careful using this if the RSA structure is shared */
149 CRYPTO_EX_DATA ex_data;
150 int references;
151 int flags;
152 /* Used to cache montgomery values */
153 BN_MONT_CTX *_method_mod_n;
154 BN_MONT_CTX *_method_mod_p;
155 BN_MONT_CTX *_method_mod_q;
156 /*
157 * all BIGNUM values are actually in the following data, if it is not
158 * NULL
159 */
160 char *bignum_data;
161 BN_BLINDING *blinding;
162 BN_BLINDING *mt_blinding;
163};
164
165# ifndef OPENSSL_RSA_MAX_MODULUS_BITS
166# define OPENSSL_RSA_MAX_MODULUS_BITS 16384
167# endif
168
169# define OPENSSL_RSA_FIPS_MIN_MODULUS_BITS 1024
170
171# ifndef OPENSSL_RSA_SMALL_MODULUS_BITS
172# define OPENSSL_RSA_SMALL_MODULUS_BITS 3072
173# endif
174# ifndef OPENSSL_RSA_MAX_PUBEXP_BITS
dbd87ffc
MC
175
176/* exponent limit enforced for "large" modulus only */
0f113f3e
MC
177# define OPENSSL_RSA_MAX_PUBEXP_BITS 64
178# endif
5e3225cc 179
0f113f3e
MC
180# define RSA_3 0x3L
181# define RSA_F4 0x10001L
d02b48c6 182
0f113f3e
MC
183# define RSA_METHOD_FLAG_NO_CHECK 0x0001/* don't check pub/private
184 * match */
dfeab068 185
0f113f3e
MC
186# define RSA_FLAG_CACHE_PUBLIC 0x0002
187# define RSA_FLAG_CACHE_PRIVATE 0x0004
188# define RSA_FLAG_BLINDING 0x0008
189# define RSA_FLAG_THREAD_SAFE 0x0010
190/*
191 * This flag means the private key operations will be handled by rsa_mod_exp
770d19b8 192 * and that they do not depend on the private key components being present:
0f113f3e
MC
193 * for example a key stored in external hardware. Without this flag
194 * bn_mod_exp gets called when private key components are absent.
770d19b8 195 */
0f113f3e 196# define RSA_FLAG_EXT_PKEY 0x0020
58964a49 197
0f113f3e
MC
198/*
199 * This flag in the RSA_METHOD enables the new rsa_sign, rsa_verify
200 * functions.
1c80019a 201 */
0f113f3e 202# define RSA_FLAG_SIGN_VER 0x0040
46a64376 203
dbd87ffc
MC
204/*
205 * new with 0.9.6j and 0.9.7b; the built-in
206 * RSA implementation now uses blinding by
207 * default (ignoring RSA_FLAG_BLINDING),
208 * but other engines might not need it
209 */
0f113f3e 210# define RSA_FLAG_NO_BLINDING 0x0080
dbd87ffc
MC
211/*
212 * new with 0.9.8f; the built-in RSA
213 * implementation now uses constant time
214 * operations by default in private key operations,
0f113f3e
MC
215 * e.g., constant time modular exponentiation,
216 * modular inverse without leaking branches,
217 * division without leaking branches. This
218 * flag disables these constant time
219 * operations and results in faster RSA
dbd87ffc 220 * private key operations.
0f113f3e
MC
221 */
222# define RSA_FLAG_NO_CONSTTIME 0x0100
223# ifdef OPENSSL_USE_DEPRECATED
dbd87ffc
MC
224/* deprecated name for the flag*/
225/*
226 * new with 0.9.7h; the built-in RSA
227 * implementation now uses constant time
228 * modular exponentiation for secret exponents
229 * by default. This flag causes the
230 * faster variable sliding window method to
231 * be used for all exponents.
232 */
0f113f3e
MC
233# define RSA_FLAG_NO_EXP_CONSTTIME RSA_FLAG_NO_CONSTTIME
234# endif
235
236# define EVP_PKEY_CTX_set_rsa_padding(ctx, pad) \
237 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, -1, EVP_PKEY_CTRL_RSA_PADDING, \
238 pad, NULL)
239
240# define EVP_PKEY_CTX_get_rsa_padding(ctx, ppad) \
241 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, -1, \
242 EVP_PKEY_CTRL_GET_RSA_PADDING, 0, ppad)
243
244# define EVP_PKEY_CTX_set_rsa_pss_saltlen(ctx, len) \
245 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \
246 (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \
247 EVP_PKEY_CTRL_RSA_PSS_SALTLEN, \
248 len, NULL)
249
250# define EVP_PKEY_CTX_get_rsa_pss_saltlen(ctx, plen) \
251 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \
252 (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \
253 EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN, \
254 0, plen)
255
256# define EVP_PKEY_CTX_set_rsa_keygen_bits(ctx, bits) \
257 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_KEYGEN, \
258 EVP_PKEY_CTRL_RSA_KEYGEN_BITS, bits, NULL)
259
260# define EVP_PKEY_CTX_set_rsa_keygen_pubexp(ctx, pubexp) \
261 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_KEYGEN, \
262 EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP, 0, pubexp)
263
264# define EVP_PKEY_CTX_set_rsa_mgf1_md(ctx, md) \
265 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \
266 EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \
267 EVP_PKEY_CTRL_RSA_MGF1_MD, 0, (void *)md)
268
269# define EVP_PKEY_CTX_set_rsa_oaep_md(ctx, md) \
270 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \
271 EVP_PKEY_CTRL_RSA_OAEP_MD, 0, (void *)md)
272
273# define EVP_PKEY_CTX_get_rsa_mgf1_md(ctx, pmd) \
274 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \
275 EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \
276 EVP_PKEY_CTRL_GET_RSA_MGF1_MD, 0, (void *)pmd)
277
278# define EVP_PKEY_CTX_get_rsa_oaep_md(ctx, pmd) \
279 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \
280 EVP_PKEY_CTRL_GET_RSA_OAEP_MD, 0, (void *)pmd)
281
282# define EVP_PKEY_CTX_set0_rsa_oaep_label(ctx, l, llen) \
283 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \
284 EVP_PKEY_CTRL_RSA_OAEP_LABEL, llen, (void *)l)
285
286# define EVP_PKEY_CTX_get0_rsa_oaep_label(ctx, l) \
287 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \
288 EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL, 0, (void *)l)
289
290# define EVP_PKEY_CTRL_RSA_PADDING (EVP_PKEY_ALG_CTRL + 1)
291# define EVP_PKEY_CTRL_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 2)
292
293# define EVP_PKEY_CTRL_RSA_KEYGEN_BITS (EVP_PKEY_ALG_CTRL + 3)
294# define EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP (EVP_PKEY_ALG_CTRL + 4)
295# define EVP_PKEY_CTRL_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 5)
296
297# define EVP_PKEY_CTRL_GET_RSA_PADDING (EVP_PKEY_ALG_CTRL + 6)
298# define EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 7)
299# define EVP_PKEY_CTRL_GET_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 8)
300
301# define EVP_PKEY_CTRL_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 9)
302# define EVP_PKEY_CTRL_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 10)
303
304# define EVP_PKEY_CTRL_GET_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 11)
305# define EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 12)
306
307# define RSA_PKCS1_PADDING 1
308# define RSA_SSLV23_PADDING 2
309# define RSA_NO_PADDING 3
310# define RSA_PKCS1_OAEP_PADDING 4
311# define RSA_X931_PADDING 5
29db322e 312/* EVP_PKEY_ only */
0f113f3e 313# define RSA_PKCS1_PSS_PADDING 6
58964a49 314
0f113f3e 315# define RSA_PKCS1_PADDING_SIZE 11
ba8ad074 316
0f113f3e
MC
317# define RSA_set_app_data(s,arg) RSA_set_ex_data(s,0,arg)
318# define RSA_get_app_data(s) RSA_get_ex_data(s,0)
d02b48c6 319
0f113f3e
MC
320RSA *RSA_new(void);
321RSA *RSA_new_method(ENGINE *engine);
26c79d56 322int RSA_bits(const RSA *rsa);
0f113f3e
MC
323int RSA_size(const RSA *rsa);
324int RSA_security_bits(const RSA *rsa);
e9224c71
GT
325
326/* Deprecated version */
0f113f3e
MC
327# ifdef OPENSSL_USE_DEPRECATED
328DECLARE_DEPRECATED(RSA *RSA_generate_key(int bits, unsigned long e, void
329 (*callback) (int, int, void *),
330 void *cb_arg));
331# endif /* defined(OPENSSL_USE_DEPRECATED) */
e9224c71
GT
332
333/* New version */
0f113f3e
MC
334int RSA_generate_key_ex(RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb);
335
336int RSA_X931_derive_ex(RSA *rsa, BIGNUM *p1, BIGNUM *p2, BIGNUM *q1,
337 BIGNUM *q2, const BIGNUM *Xp1, const BIGNUM *Xp2,
338 const BIGNUM *Xp, const BIGNUM *Xq1, const BIGNUM *Xq2,
339 const BIGNUM *Xq, const BIGNUM *e, BN_GENCB *cb);
340int RSA_X931_generate_key_ex(RSA *rsa, int bits, const BIGNUM *e,
341 BN_GENCB *cb);
342
343int RSA_check_key(const RSA *);
344int RSA_check_key_ex(const RSA *, BN_GENCB *cb);
345 /* next 4 return -1 on error */
346int RSA_public_encrypt(int flen, const unsigned char *from,
347 unsigned char *to, RSA *rsa, int padding);
348int RSA_private_encrypt(int flen, const unsigned char *from,
349 unsigned char *to, RSA *rsa, int padding);
350int RSA_public_decrypt(int flen, const unsigned char *from,
351 unsigned char *to, RSA *rsa, int padding);
352int RSA_private_decrypt(int flen, const unsigned char *from,
353 unsigned char *to, RSA *rsa, int padding);
354void RSA_free(RSA *r);
5cbc2e8b 355/* "up" the RSA object's reference count */
0f113f3e 356int RSA_up_ref(RSA *r);
d02b48c6 357
0f113f3e 358int RSA_flags(const RSA *r);
58964a49 359
cb78486d
GT
360void RSA_set_default_method(const RSA_METHOD *meth);
361const RSA_METHOD *RSA_get_default_method(void);
29c1f061 362const RSA_METHOD *RSA_get_method(const RSA *rsa);
cb78486d 363int RSA_set_method(RSA *rsa, const RSA_METHOD *meth);
d02b48c6 364
dfeab068
RE
365/* This function needs the memory locking malloc callbacks to be installed */
366int RSA_memory_lock(RSA *r);
367
d02b48c6 368/* these are the actual SSLeay RSA functions */
7be7c2ed 369const RSA_METHOD *RSA_PKCS1_SSLeay(void);
d02b48c6 370
7be7c2ed 371const RSA_METHOD *RSA_null_method(void);
c1cd88a0 372
78d3b819
DSH
373DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPublicKey)
374DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPrivateKey)
375
0f113f3e
MC
376typedef struct rsa_pss_params_st {
377 X509_ALGOR *hashAlgorithm;
378 X509_ALGOR *maskGenAlgorithm;
379 ASN1_INTEGER *saltLength;
380 ASN1_INTEGER *trailerField;
381} RSA_PSS_PARAMS;
ff04bbe3 382
63b825c9 383DECLARE_ASN1_FUNCTIONS(RSA_PSS_PARAMS)
ff04bbe3 384
0f113f3e
MC
385typedef struct rsa_oaep_params_st {
386 X509_ALGOR *hashFunc;
387 X509_ALGOR *maskGenFunc;
388 X509_ALGOR *pSourceFunc;
389} RSA_OAEP_PARAMS;
0574cadf
DSH
390
391DECLARE_ASN1_FUNCTIONS(RSA_OAEP_PARAMS)
392
0f113f3e
MC
393# ifndef OPENSSL_NO_STDIO
394int RSA_print_fp(FILE *fp, const RSA *r, int offset);
395# endif
d02b48c6 396
0f113f3e 397int RSA_print(BIO *bp, const RSA *r, int offset);
d02b48c6 398
0f113f3e
MC
399/*
400 * The following 2 functions sign and verify a X509_SIG ASN1 object inside
401 * PKCS#1 padded RSA encryption
402 */
3e83e686 403int RSA_sign(int type, const unsigned char *m, unsigned int m_length,
0f113f3e 404 unsigned char *sigret, unsigned int *siglen, RSA *rsa);
3e83e686 405int RSA_verify(int type, const unsigned char *m, unsigned int m_length,
0f113f3e 406 const unsigned char *sigbuf, unsigned int siglen, RSA *rsa);
d02b48c6 407
0f113f3e
MC
408/*
409 * The following 2 function sign and verify a ASN1_OCTET_STRING object inside
410 * PKCS#1 padded RSA encryption
411 */
29c1f061 412int RSA_sign_ASN1_OCTET_STRING(int type,
0f113f3e
MC
413 const unsigned char *m, unsigned int m_length,
414 unsigned char *sigret, unsigned int *siglen,
415 RSA *rsa);
416int RSA_verify_ASN1_OCTET_STRING(int type, const unsigned char *m,
417 unsigned int m_length, unsigned char *sigbuf,
418 unsigned int siglen, RSA *rsa);
d02b48c6 419
58964a49
RE
420int RSA_blinding_on(RSA *rsa, BN_CTX *ctx);
421void RSA_blinding_off(RSA *rsa);
800e400d 422BN_BLINDING *RSA_setup_blinding(RSA *rsa, BN_CTX *ctx);
58964a49 423
0f113f3e
MC
424int RSA_padding_add_PKCS1_type_1(unsigned char *to, int tlen,
425 const unsigned char *f, int fl);
426int RSA_padding_check_PKCS1_type_1(unsigned char *to, int tlen,
427 const unsigned char *f, int fl,
428 int rsa_len);
429int RSA_padding_add_PKCS1_type_2(unsigned char *to, int tlen,
430 const unsigned char *f, int fl);
431int RSA_padding_check_PKCS1_type_2(unsigned char *to, int tlen,
432 const unsigned char *f, int fl,
433 int rsa_len);
434int PKCS1_MGF1(unsigned char *mask, long len, const unsigned char *seed,
435 long seedlen, const EVP_MD *dgst);
436int RSA_padding_add_PKCS1_OAEP(unsigned char *to, int tlen,
437 const unsigned char *f, int fl,
438 const unsigned char *p, int pl);
439int RSA_padding_check_PKCS1_OAEP(unsigned char *to, int tlen,
440 const unsigned char *f, int fl, int rsa_len,
441 const unsigned char *p, int pl);
271fef0e 442int RSA_padding_add_PKCS1_OAEP_mgf1(unsigned char *to, int tlen,
0f113f3e
MC
443 const unsigned char *from, int flen,
444 const unsigned char *param, int plen,
445 const EVP_MD *md, const EVP_MD *mgf1md);
271fef0e 446int RSA_padding_check_PKCS1_OAEP_mgf1(unsigned char *to, int tlen,
0f113f3e
MC
447 const unsigned char *from, int flen,
448 int num, const unsigned char *param,
449 int plen, const EVP_MD *md,
450 const EVP_MD *mgf1md);
451int RSA_padding_add_SSLv23(unsigned char *to, int tlen,
452 const unsigned char *f, int fl);
453int RSA_padding_check_SSLv23(unsigned char *to, int tlen,
454 const unsigned char *f, int fl, int rsa_len);
455int RSA_padding_add_none(unsigned char *to, int tlen, const unsigned char *f,
456 int fl);
457int RSA_padding_check_none(unsigned char *to, int tlen,
458 const unsigned char *f, int fl, int rsa_len);
459int RSA_padding_add_X931(unsigned char *to, int tlen, const unsigned char *f,
460 int fl);
461int RSA_padding_check_X931(unsigned char *to, int tlen,
462 const unsigned char *f, int fl, int rsa_len);
499fca2d 463int RSA_X931_hash_id(int nid);
58964a49 464
c7aaf391 465int RSA_verify_PKCS1_PSS(RSA *rsa, const unsigned char *mHash,
0f113f3e
MC
466 const EVP_MD *Hash, const unsigned char *EM,
467 int sLen);
c7aaf391 468int RSA_padding_add_PKCS1_PSS(RSA *rsa, unsigned char *EM,
0f113f3e
MC
469 const unsigned char *mHash, const EVP_MD *Hash,
470 int sLen);
c7aaf391 471
c553721e 472int RSA_verify_PKCS1_PSS_mgf1(RSA *rsa, const unsigned char *mHash,
0f113f3e
MC
473 const EVP_MD *Hash, const EVP_MD *mgf1Hash,
474 const unsigned char *EM, int sLen);
c553721e
DSH
475
476int RSA_padding_add_PKCS1_PSS_mgf1(RSA *rsa, unsigned char *EM,
0f113f3e
MC
477 const unsigned char *mHash,
478 const EVP_MD *Hash, const EVP_MD *mgf1Hash,
479 int sLen);
c553721e 480
dd9d233e 481int RSA_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
0f113f3e
MC
482 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
483int RSA_set_ex_data(RSA *r, int idx, void *arg);
29c1f061 484void *RSA_get_ex_data(const RSA *r, int idx);
58964a49 485
40889b9c
LJ
486RSA *RSAPublicKey_dup(RSA *rsa);
487RSA *RSAPrivateKey_dup(RSA *rsa);
488
0f113f3e
MC
489/*
490 * If this flag is set the RSA method is FIPS compliant and can be used in
491 * FIPS mode. This is set in the validated module method. If an application
492 * sets this flag in its own methods it is its responsibility to ensure the
493 * result is compliant.
c553721e
DSH
494 */
495
0f113f3e 496# define RSA_FLAG_FIPS_METHOD 0x0400
c553721e 497
0f113f3e
MC
498/*
499 * If this flag is set the operations normally disabled in FIPS mode are
c553721e
DSH
500 * permitted it is then the applications responsibility to ensure that the
501 * usage is compliant.
502 */
503
0f113f3e
MC
504# define RSA_FLAG_NON_FIPS_ALLOW 0x0400
505/*
506 * Application has decided PRNG is good enough to generate a key: don't
cac4fb58
DSH
507 * check.
508 */
0f113f3e 509# define RSA_FLAG_CHECKED 0x0800
c553721e 510
d02b48c6 511/* BEGIN ERROR CODES */
0f113f3e
MC
512/*
513 * The following lines are auto generated by the script mkerr.pl. Any changes
6d311938
DSH
514 * made after this point may be overwritten when the script is next run.
515 */
24cff6ce 516void ERR_load_RSA_strings(void);
6d311938 517
d02b48c6
RE
518/* Error codes for the RSA functions. */
519
520/* Function codes. */
0f113f3e
MC
521# define RSA_F_CHECK_PADDING_MD 140
522# define RSA_F_DO_RSA_PRINT 146
523# define RSA_F_FIPS_RSA_SIGN_DIGEST 149
524# define RSA_F_FIPS_RSA_VERIFY 150
525# define RSA_F_FIPS_RSA_VERIFY_DIGEST 151
526# define RSA_F_INT_RSA_VERIFY 145
527# define RSA_F_MEMORY_LOCK 100
528# define RSA_F_OLD_RSA_PRIV_DECODE 147
529# define RSA_F_PKEY_RSA_CTRL 143
530# define RSA_F_PKEY_RSA_CTRL_STR 144
531# define RSA_F_PKEY_RSA_SIGN 142
532# define RSA_F_PKEY_RSA_VERIFYRECOVER 141
533# define RSA_F_RSA_ALGOR_TO_MD 156
534# define RSA_F_RSA_BUILTIN_KEYGEN 129
535# define RSA_F_RSA_CHECK_KEY 123
536# define RSA_F_RSA_CHECK_KEY_EX 160
537# define RSA_F_RSA_CMS_DECRYPT 159
538# define RSA_F_RSA_EAY_PRIVATE_DECRYPT 101
539# define RSA_F_RSA_EAY_PRIVATE_ENCRYPT 102
540# define RSA_F_RSA_EAY_PUBLIC_DECRYPT 103
541# define RSA_F_RSA_EAY_PUBLIC_ENCRYPT 104
542# define RSA_F_RSA_GENERATE_KEY 105
543# define RSA_F_RSA_ITEM_VERIFY 148
544# define RSA_F_RSA_MEMORY_LOCK 130
545# define RSA_F_RSA_MGF1_TO_MD 157
546# define RSA_F_RSA_NEW_METHOD 106
547# define RSA_F_RSA_NULL 124
548# define RSA_F_RSA_NULL_MOD_EXP 131
549# define RSA_F_RSA_NULL_PRIVATE_DECRYPT 132
550# define RSA_F_RSA_NULL_PRIVATE_ENCRYPT 133
551# define RSA_F_RSA_NULL_PUBLIC_DECRYPT 134
552# define RSA_F_RSA_NULL_PUBLIC_ENCRYPT 135
553# define RSA_F_RSA_OAEP_TO_CTX 158
554# define RSA_F_RSA_PADDING_ADD_NONE 107
555# define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP 121
556# define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP_MGF1 154
557# define RSA_F_RSA_PADDING_ADD_PKCS1_PSS 125
558# define RSA_F_RSA_PADDING_ADD_PKCS1_PSS_MGF1 152
559# define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_1 108
560# define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_2 109
561# define RSA_F_RSA_PADDING_ADD_SSLV23 110
562# define RSA_F_RSA_PADDING_ADD_X931 127
563# define RSA_F_RSA_PADDING_CHECK_NONE 111
564# define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP 122
565# define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP_MGF1 153
566# define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_1 112
567# define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_2 113
568# define RSA_F_RSA_PADDING_CHECK_SSLV23 114
569# define RSA_F_RSA_PADDING_CHECK_X931 128
570# define RSA_F_RSA_PRINT 115
571# define RSA_F_RSA_PRINT_FP 116
572# define RSA_F_RSA_PRIV_DECODE 137
573# define RSA_F_RSA_PRIV_ENCODE 138
574# define RSA_F_RSA_PSS_TO_CTX 155
575# define RSA_F_RSA_PUB_DECODE 139
576# define RSA_F_RSA_SETUP_BLINDING 136
577# define RSA_F_RSA_SIGN 117
578# define RSA_F_RSA_SIGN_ASN1_OCTET_STRING 118
579# define RSA_F_RSA_VERIFY 119
580# define RSA_F_RSA_VERIFY_ASN1_OCTET_STRING 120
581# define RSA_F_RSA_VERIFY_PKCS1_PSS_MGF1 126
d02b48c6
RE
582
583/* Reason codes. */
0f113f3e
MC
584# define RSA_R_ALGORITHM_MISMATCH 100
585# define RSA_R_BAD_E_VALUE 101
586# define RSA_R_BAD_FIXED_HEADER_DECRYPT 102
587# define RSA_R_BAD_PAD_BYTE_COUNT 103
588# define RSA_R_BAD_SIGNATURE 104
589# define RSA_R_BLOCK_TYPE_IS_NOT_01 106
590# define RSA_R_BLOCK_TYPE_IS_NOT_02 107
591# define RSA_R_DATA_GREATER_THAN_MOD_LEN 108
592# define RSA_R_DATA_TOO_LARGE 109
593# define RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE 110
594# define RSA_R_DATA_TOO_LARGE_FOR_MODULUS 132
595# define RSA_R_DATA_TOO_SMALL 111
596# define RSA_R_DATA_TOO_SMALL_FOR_KEY_SIZE 122
597# define RSA_R_DIGEST_DOES_NOT_MATCH 158
598# define RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY 112
599# define RSA_R_DMP1_NOT_CONGRUENT_TO_D 124
600# define RSA_R_DMQ1_NOT_CONGRUENT_TO_D 125
601# define RSA_R_D_E_NOT_CONGRUENT_TO_1 123
602# define RSA_R_FIRST_OCTET_INVALID 133
603# define RSA_R_ILLEGAL_OR_UNSUPPORTED_PADDING_MODE 144
604# define RSA_R_INVALID_DIGEST 157
605# define RSA_R_INVALID_DIGEST_LENGTH 143
606# define RSA_R_INVALID_HEADER 137
607# define RSA_R_INVALID_KEYBITS 145
608# define RSA_R_INVALID_LABEL 160
609# define RSA_R_INVALID_MESSAGE_LENGTH 131
610# define RSA_R_INVALID_MGF1_MD 156
611# define RSA_R_INVALID_OAEP_PARAMETERS 161
612# define RSA_R_INVALID_PADDING 138
613# define RSA_R_INVALID_PADDING_MODE 141
614# define RSA_R_INVALID_PSS_PARAMETERS 149
615# define RSA_R_INVALID_PSS_SALTLEN 146
616# define RSA_R_INVALID_SALT_LENGTH 150
617# define RSA_R_INVALID_TRAILER 139
618# define RSA_R_INVALID_X931_DIGEST 142
619# define RSA_R_IQMP_NOT_INVERSE_OF_Q 126
620# define RSA_R_KEY_SIZE_TOO_SMALL 120
621# define RSA_R_LAST_OCTET_INVALID 134
622# define RSA_R_MODULUS_TOO_LARGE 105
623# define RSA_R_NO_PUBLIC_EXPONENT 140
624# define RSA_R_NULL_BEFORE_BLOCK_MISSING 113
625# define RSA_R_N_DOES_NOT_EQUAL_P_Q 127
626# define RSA_R_OAEP_DECODING_ERROR 121
627# define RSA_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 148
628# define RSA_R_PADDING_CHECK_FAILED 114
629# define RSA_R_PKCS_DECODING_ERROR 159
630# define RSA_R_P_NOT_PRIME 128
631# define RSA_R_Q_NOT_PRIME 129
632# define RSA_R_RSA_OPERATIONS_NOT_SUPPORTED 130
633# define RSA_R_SLEN_CHECK_FAILED 136
634# define RSA_R_SLEN_RECOVERY_FAILED 135
635# define RSA_R_SSLV3_ROLLBACK_ATTACK 115
636# define RSA_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 116
637# define RSA_R_UNKNOWN_ALGORITHM_TYPE 117
638# define RSA_R_UNKNOWN_DIGEST 166
639# define RSA_R_UNKNOWN_MASK_DIGEST 151
640# define RSA_R_UNKNOWN_PADDING_TYPE 118
641# define RSA_R_UNKNOWN_PSS_DIGEST 152
642# define RSA_R_UNSUPPORTED_ENCRYPTION_TYPE 162
643# define RSA_R_UNSUPPORTED_LABEL_SOURCE 163
644# define RSA_R_UNSUPPORTED_MASK_ALGORITHM 153
645# define RSA_R_UNSUPPORTED_MASK_PARAMETER 154
646# define RSA_R_UNSUPPORTED_SIGNATURE_TYPE 155
647# define RSA_R_VALUE_MISSING 147
648# define RSA_R_WRONG_SIGNATURE_LENGTH 119
6d311938 649
d02b48c6
RE
650#ifdef __cplusplus
651}
652#endif
653#endif