Index: openssl/doc/crypto/BN_BLINDING_new.pod |
=================================================================== |
--- openssl/doc/crypto/BN_BLINDING_new.pod (revision 105093) |
+++ openssl/doc/crypto/BN_BLINDING_new.pod (working copy) |
@@ -22,8 +22,11 @@ |
BN_CTX *ctx); |
int BN_BLINDING_invert_ex(BIGNUM *n, const BIGNUM *r, BN_BLINDING *b, |
BN_CTX *ctx); |
+ #ifndef OPENSSL_NO_DEPRECATED |
unsigned long BN_BLINDING_get_thread_id(const BN_BLINDING *); |
void BN_BLINDING_set_thread_id(BN_BLINDING *, unsigned long); |
+ #endif |
+ CRYPTO_THREADID *BN_BLINDING_thread_id(BN_BLINDING *); |
unsigned long BN_BLINDING_get_flags(const BN_BLINDING *); |
void BN_BLINDING_set_flags(BN_BLINDING *, unsigned long); |
BN_BLINDING *BN_BLINDING_create_param(BN_BLINDING *b, |
@@ -54,11 +57,11 @@ |
functions for BN_BLINDING_convert_ex() and BN_BLINDING_invert_ex() |
with B<r> set to NULL. |
-BN_BLINDING_set_thread_id() and BN_BLINDING_get_thread_id() |
-set and get the "thread id" value of the B<BN_BLINDING> structure, |
-a field provided to users of B<BN_BLINDING> structure to help them |
-provide proper locking if needed for multi-threaded use. The |
-"thread id" of a newly allocated B<BN_BLINDING> structure is zero. |
+BN_BLINDING_thread_id() provides access to the B<CRYPTO_THREADID> |
+object within the B<BN_BLINDING> structure. This is to help users |
+provide proper locking if needed for multi-threaded use. The "thread |
+id" object of a newly allocated B<BN_BLINDING> structure is |
+initialised to the thread id in which BN_BLINDING_new() was called. |
BN_BLINDING_get_flags() returns the BN_BLINDING flags. Currently |
there are two supported flags: B<BN_BLINDING_NO_UPDATE> and |
@@ -83,8 +86,8 @@ |
BN_BLINDING_convert_ex() and BN_BLINDING_invert_ex() return 1 on |
success and 0 if an error occured. |
-BN_BLINDING_get_thread_id() returns the thread id (a B<unsigned long> |
-value) or 0 if not set. |
+BN_BLINDING_thread_id() returns a pointer to the thread id object |
+within a B<BN_BLINDING> object. |
BN_BLINDING_get_flags() returns the currently set B<BN_BLINDING> flags |
(a B<unsigned long> value). |
@@ -98,6 +101,9 @@ |
=head1 HISTORY |
+BN_BLINDING_thread_id was first introduced in OpenSSL 1.0.0, and it |
+deprecates BN_BLINDING_set_thread_id and BN_BLINDING_get_thread_id. |
+ |
BN_BLINDING_convert_ex, BN_BLINDIND_invert_ex, BN_BLINDING_get_thread_id, |
BN_BLINDING_set_thread_id, BN_BLINDING_set_flags, BN_BLINDING_get_flags |
and BN_BLINDING_create_param were first introduced in OpenSSL 0.9.8 |