OLD | NEW |
1 =pod | 1 =pod |
2 | 2 |
3 =head1 NAME | 3 =head1 NAME |
4 | 4 |
5 BN_BLINDING_new, BN_BLINDING_free, BN_BLINDING_update, BN_BLINDING_convert, | 5 BN_BLINDING_new, BN_BLINDING_free, BN_BLINDING_update, BN_BLINDING_convert, |
6 BN_BLINDING_invert, BN_BLINDING_convert_ex, BN_BLINDING_invert_ex, | 6 BN_BLINDING_invert, BN_BLINDING_convert_ex, BN_BLINDING_invert_ex, |
7 BN_BLINDING_get_thread_id, BN_BLINDING_set_thread_id, BN_BLINDING_get_flags, | 7 BN_BLINDING_get_thread_id, BN_BLINDING_set_thread_id, BN_BLINDING_get_flags, |
8 BN_BLINDING_set_flags, BN_BLINDING_create_param - blinding related BIGNUM | 8 BN_BLINDING_set_flags, BN_BLINDING_create_param - blinding related BIGNUM |
9 functions. | 9 functions. |
10 | 10 |
11 =head1 SYNOPSIS | 11 =head1 SYNOPSIS |
12 | 12 |
13 #include <openssl/bn.h> | 13 #include <openssl/bn.h> |
14 | 14 |
15 BN_BLINDING *BN_BLINDING_new(const BIGNUM *A, const BIGNUM *Ai, | 15 BN_BLINDING *BN_BLINDING_new(const BIGNUM *A, const BIGNUM *Ai, |
16 BIGNUM *mod); | 16 BIGNUM *mod); |
17 void BN_BLINDING_free(BN_BLINDING *b); | 17 void BN_BLINDING_free(BN_BLINDING *b); |
18 int BN_BLINDING_update(BN_BLINDING *b,BN_CTX *ctx); | 18 int BN_BLINDING_update(BN_BLINDING *b,BN_CTX *ctx); |
19 int BN_BLINDING_convert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx); | 19 int BN_BLINDING_convert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx); |
20 int BN_BLINDING_invert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx); | 20 int BN_BLINDING_invert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx); |
21 int BN_BLINDING_convert_ex(BIGNUM *n, BIGNUM *r, BN_BLINDING *b, | 21 int BN_BLINDING_convert_ex(BIGNUM *n, BIGNUM *r, BN_BLINDING *b, |
22 BN_CTX *ctx); | 22 BN_CTX *ctx); |
23 int BN_BLINDING_invert_ex(BIGNUM *n, const BIGNUM *r, BN_BLINDING *b, | 23 int BN_BLINDING_invert_ex(BIGNUM *n, const BIGNUM *r, BN_BLINDING *b, |
24 BN_CTX *ctx); | 24 BN_CTX *ctx); |
| 25 #ifndef OPENSSL_NO_DEPRECATED |
25 unsigned long BN_BLINDING_get_thread_id(const BN_BLINDING *); | 26 unsigned long BN_BLINDING_get_thread_id(const BN_BLINDING *); |
26 void BN_BLINDING_set_thread_id(BN_BLINDING *, unsigned long); | 27 void BN_BLINDING_set_thread_id(BN_BLINDING *, unsigned long); |
| 28 #endif |
| 29 CRYPTO_THREADID *BN_BLINDING_thread_id(BN_BLINDING *); |
27 unsigned long BN_BLINDING_get_flags(const BN_BLINDING *); | 30 unsigned long BN_BLINDING_get_flags(const BN_BLINDING *); |
28 void BN_BLINDING_set_flags(BN_BLINDING *, unsigned long); | 31 void BN_BLINDING_set_flags(BN_BLINDING *, unsigned long); |
29 BN_BLINDING *BN_BLINDING_create_param(BN_BLINDING *b, | 32 BN_BLINDING *BN_BLINDING_create_param(BN_BLINDING *b, |
30 const BIGNUM *e, BIGNUM *m, BN_CTX *ctx, | 33 const BIGNUM *e, BIGNUM *m, BN_CTX *ctx, |
31 int (*bn_mod_exp)(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, | 34 int (*bn_mod_exp)(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, |
32 const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx), | 35 const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx), |
33 BN_MONT_CTX *m_ctx); | 36 BN_MONT_CTX *m_ctx); |
34 | 37 |
35 =head1 DESCRIPTION | 38 =head1 DESCRIPTION |
36 | 39 |
(...skipping 10 matching lines...) Expand all Loading... |
47 If B<r> is not NULL a copy the inverse blinding factor B<Ai> will be | 50 If B<r> is not NULL a copy the inverse blinding factor B<Ai> will be |
48 returned in B<r> (this is useful if a B<RSA> object is shared amoung | 51 returned in B<r> (this is useful if a B<RSA> object is shared amoung |
49 several threads). BN_BLINDING_invert_ex() multiplies B<n> with the | 52 several threads). BN_BLINDING_invert_ex() multiplies B<n> with the |
50 inverse blinding factor B<Ai>. If B<r> is not NULL it will be used as | 53 inverse blinding factor B<Ai>. If B<r> is not NULL it will be used as |
51 the inverse blinding. | 54 the inverse blinding. |
52 | 55 |
53 BN_BLINDING_convert() and BN_BLINDING_invert() are wrapper | 56 BN_BLINDING_convert() and BN_BLINDING_invert() are wrapper |
54 functions for BN_BLINDING_convert_ex() and BN_BLINDING_invert_ex() | 57 functions for BN_BLINDING_convert_ex() and BN_BLINDING_invert_ex() |
55 with B<r> set to NULL. | 58 with B<r> set to NULL. |
56 | 59 |
57 BN_BLINDING_set_thread_id() and BN_BLINDING_get_thread_id() | 60 BN_BLINDING_thread_id() provides access to the B<CRYPTO_THREADID> |
58 set and get the "thread id" value of the B<BN_BLINDING> structure, | 61 object within the B<BN_BLINDING> structure. This is to help users |
59 a field provided to users of B<BN_BLINDING> structure to help them | 62 provide proper locking if needed for multi-threaded use. The "thread |
60 provide proper locking if needed for multi-threaded use. The | 63 id" object of a newly allocated B<BN_BLINDING> structure is |
61 "thread id" of a newly allocated B<BN_BLINDING> structure is zero. | 64 initialised to the thread id in which BN_BLINDING_new() was called. |
62 | 65 |
63 BN_BLINDING_get_flags() returns the BN_BLINDING flags. Currently | 66 BN_BLINDING_get_flags() returns the BN_BLINDING flags. Currently |
64 there are two supported flags: B<BN_BLINDING_NO_UPDATE> and | 67 there are two supported flags: B<BN_BLINDING_NO_UPDATE> and |
65 B<BN_BLINDING_NO_RECREATE>. B<BN_BLINDING_NO_UPDATE> inhibits the | 68 B<BN_BLINDING_NO_RECREATE>. B<BN_BLINDING_NO_UPDATE> inhibits the |
66 automatic update of the B<BN_BLINDING> parameters after each use | 69 automatic update of the B<BN_BLINDING> parameters after each use |
67 and B<BN_BLINDING_NO_RECREATE> inhibits the automatic re-creation | 70 and B<BN_BLINDING_NO_RECREATE> inhibits the automatic re-creation |
68 of the B<BN_BLINDING> parameters after a fixed number of uses (currently | 71 of the B<BN_BLINDING> parameters after a fixed number of uses (currently |
69 32). In newly allocated B<BN_BLINDING> objects no flags are set. | 72 32). In newly allocated B<BN_BLINDING> objects no flags are set. |
70 BN_BLINDING_set_flags() sets the B<BN_BLINDING> parameters flags. | 73 BN_BLINDING_set_flags() sets the B<BN_BLINDING> parameters flags. |
71 | 74 |
72 BN_BLINDING_create_param() creates new B<BN_BLINDING> parameters | 75 BN_BLINDING_create_param() creates new B<BN_BLINDING> parameters |
73 using the exponent B<e> and the modulus B<m>. B<bn_mod_exp> and | 76 using the exponent B<e> and the modulus B<m>. B<bn_mod_exp> and |
74 B<m_ctx> can be used to pass special functions for exponentiation | 77 B<m_ctx> can be used to pass special functions for exponentiation |
75 (normally BN_mod_exp_mont() and B<BN_MONT_CTX>). | 78 (normally BN_mod_exp_mont() and B<BN_MONT_CTX>). |
76 | 79 |
77 =head1 RETURN VALUES | 80 =head1 RETURN VALUES |
78 | 81 |
79 BN_BLINDING_new() returns the newly allocated B<BN_BLINDING> structure | 82 BN_BLINDING_new() returns the newly allocated B<BN_BLINDING> structure |
80 or NULL in case of an error. | 83 or NULL in case of an error. |
81 | 84 |
82 BN_BLINDING_update(), BN_BLINDING_convert(), BN_BLINDING_invert(), | 85 BN_BLINDING_update(), BN_BLINDING_convert(), BN_BLINDING_invert(), |
83 BN_BLINDING_convert_ex() and BN_BLINDING_invert_ex() return 1 on | 86 BN_BLINDING_convert_ex() and BN_BLINDING_invert_ex() return 1 on |
84 success and 0 if an error occured. | 87 success and 0 if an error occured. |
85 | 88 |
86 BN_BLINDING_get_thread_id() returns the thread id (a B<unsigned long> | 89 BN_BLINDING_thread_id() returns a pointer to the thread id object |
87 value) or 0 if not set. | 90 within a B<BN_BLINDING> object. |
88 | 91 |
89 BN_BLINDING_get_flags() returns the currently set B<BN_BLINDING> flags | 92 BN_BLINDING_get_flags() returns the currently set B<BN_BLINDING> flags |
90 (a B<unsigned long> value). | 93 (a B<unsigned long> value). |
91 | 94 |
92 BN_BLINDING_create_param() returns the newly created B<BN_BLINDING> | 95 BN_BLINDING_create_param() returns the newly created B<BN_BLINDING> |
93 parameters or NULL on error. | 96 parameters or NULL on error. |
94 | 97 |
95 =head1 SEE ALSO | 98 =head1 SEE ALSO |
96 | 99 |
97 L<bn(3)|bn(3)> | 100 L<bn(3)|bn(3)> |
98 | 101 |
99 =head1 HISTORY | 102 =head1 HISTORY |
100 | 103 |
| 104 BN_BLINDING_thread_id was first introduced in OpenSSL 1.0.0, and it |
| 105 deprecates BN_BLINDING_set_thread_id and BN_BLINDING_get_thread_id. |
| 106 |
101 BN_BLINDING_convert_ex, BN_BLINDIND_invert_ex, BN_BLINDING_get_thread_id, | 107 BN_BLINDING_convert_ex, BN_BLINDIND_invert_ex, BN_BLINDING_get_thread_id, |
102 BN_BLINDING_set_thread_id, BN_BLINDING_set_flags, BN_BLINDING_get_flags | 108 BN_BLINDING_set_thread_id, BN_BLINDING_set_flags, BN_BLINDING_get_flags |
103 and BN_BLINDING_create_param were first introduced in OpenSSL 0.9.8 | 109 and BN_BLINDING_create_param were first introduced in OpenSSL 0.9.8 |
104 | 110 |
105 =head1 AUTHOR | 111 =head1 AUTHOR |
106 | 112 |
107 Nils Larsch for the OpenSSL project (http://www.openssl.org). | 113 Nils Larsch for the OpenSSL project (http://www.openssl.org). |
108 | 114 |
109 =cut | 115 =cut |
OLD | NEW |