diff options
Diffstat (limited to 'doc/man7/provider-base.pod')
-rw-r--r-- | doc/man7/provider-base.pod | 26 |
1 files changed, 19 insertions, 7 deletions
diff --git a/doc/man7/provider-base.pod b/doc/man7/provider-base.pod index eb9e8d3575..5dcbbed221 100644 --- a/doc/man7/provider-base.pod +++ b/doc/man7/provider-base.pod @@ -81,6 +81,8 @@ provider-base size_t min_len, size_t max_len); void cleanup_entropy(const OSSL_CORE_HANDLE *handle, unsigned char *buf, size_t len); + void cleanup_user_entropy(const OSSL_CORE_HANDLE *handle, + unsigned char *buf, size_t len); size_t get_nonce(const OSSL_CORE_HANDLE *handle, unsigned char **pout, size_t min_len, size_t max_len, const void *salt, size_t salt_len); @@ -89,6 +91,8 @@ provider-base const void *salt, size_t salt_len); void cleanup_nonce(const OSSL_CORE_HANDLE *handle, unsigned char *buf, size_t len); + void cleanup_user_nonce(const OSSL_CORE_HANDLE *handle, + unsigned char *buf, size_t len); /* Functions for querying the providers in the application library context */ int provider_register_child_cb(const OSSL_CORE_HANDLE *handle, @@ -179,9 +183,11 @@ provider): ossl_rand_get_entropy OSSL_FUNC_GET_ENTROPY ossl_rand_get_user_entropy OSSL_FUNC_GET_USER_ENTROPY ossl_rand_cleanup_entropy OSSL_FUNC_CLEANUP_ENTROPY + ossl_rand_cleanup_user_entropy OSSL_FUNC_CLEANUP_USER_ENTROPY ossl_rand_get_nonce OSSL_FUNC_GET_NONCE ossl_rand_get_user_nonce OSSL_FUNC_GET_USER_NONCE ossl_rand_cleanup_nonce OSSL_FUNC_CLEANUP_NONCE + ossl_rand_cleanup_user_nonce OSSL_FUNC_CLEANUP_USER_NONCE provider_register_child_cb OSSL_FUNC_PROVIDER_REGISTER_CHILD_CB provider_deregister_child_cb OSSL_FUNC_PROVIDER_DEREGISTER_CHILD_CB provider_name OSSL_FUNC_PROVIDER_NAME @@ -315,9 +321,12 @@ attempt to gather seed material via the seed source specified by a call to L<RAND_set_seed_source_type(3)> or via L<config(5)/Random Configuration>. cleanup_entropy() is used to clean up and free the buffer returned by -get_entropy() or get_user_entropy(). The entropy pointer returned by -get_entropy() or get_user_entropy() is passed in B<buf> and its length -in B<len>. +get_entropy(). The entropy pointer returned by get_entropy() +is passed in B<buf> and its length in B<len>. + +cleanup_user_entropy() is used to clean up and free the buffer returned by +get_user_entropy(). The entropy pointer returned by get_user_entropy() +is passed in B<buf> and its length in B<len>. get_nonce() retrieves a nonce using the passed I<salt> parameter of length I<salt_len> and operating system specific information. @@ -331,10 +340,13 @@ get_user_nonce() is the same as get_nonce() except that it will attempt to gather seed material via the seed source specified by a call to L<RAND_set_seed_source_type(3)> or via L<config(5)/Random Configuration>. -cleanup_nonce() is used to clean up and free the buffer returned -by get_nonce() or get_user_nonce(). The nonce pointer returned by -get_nonce() or get_user_nonce() is passed in B<buf> and its length -in B<len>. +cleanup_nonce() is used to clean up and free the buffer returned by +get_nonce(). The nonce pointer returned by get_nonce() +is passed in B<buf> and its length in B<len>. + +cleanup_user_nonce() is used to clean up and free the buffer returned by +get_user_nonce(). The nonce pointer returned by get_user_nonce() +is passed in B<buf> and its length in B<len>. provider_register_child_cb() registers callbacks for being informed about the loading and unloading of providers in the application's library context. |