diff options
| author | Pauli <pauli@openssl.org> | 2021-04-28 05:01:22 +0200 |
|---|---|---|
| committer | Pauli <pauli@openssl.org> | 2021-05-05 14:11:04 +0200 |
| commit | a59c69724d7cbc3a4ec9f7774da9da83871ea944 (patch) | |
| tree | 26f9f3e50df4ea2c925b88c5d5557711dc0cc862 /doc | |
| parent | Add .includedir pragma (diff) | |
| download | openssl-a59c69724d7cbc3a4ec9f7774da9da83871ea944.tar.xz openssl-a59c69724d7cbc3a4ec9f7774da9da83871ea944.zip | |
doc: document EVP_MAC_finalXOF()
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15061)
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/man3/EVP_MAC.pod | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/doc/man3/EVP_MAC.pod b/doc/man3/EVP_MAC.pod index b6b5430a35..27930eb89a 100644 --- a/doc/man3/EVP_MAC.pod +++ b/doc/man3/EVP_MAC.pod @@ -8,7 +8,7 @@ EVP_MAC_provider, EVP_MAC_get_params, EVP_MAC_gettable_params, EVP_MAC_CTX, EVP_MAC_CTX_new, EVP_MAC_CTX_free, EVP_MAC_CTX_dup, EVP_MAC_CTX_mac, EVP_MAC_CTX_get_params, EVP_MAC_CTX_set_params, EVP_MAC_CTX_get_mac_size, EVP_MAC_init, EVP_MAC_update, EVP_MAC_final, -EVP_MAC_gettable_ctx_params, EVP_MAC_settable_ctx_params, +EVP_MAC_finalXOF, EVP_MAC_gettable_ctx_params, EVP_MAC_settable_ctx_params, EVP_MAC_CTX_gettable_params, EVP_MAC_CTX_settable_params, EVP_MAC_do_all_provided - EVP MAC routines @@ -46,6 +46,7 @@ EVP_MAC_do_all_provided - EVP MAC routines int EVP_MAC_update(EVP_MAC_CTX *ctx, const unsigned char *data, size_t datalen); int EVP_MAC_final(EVP_MAC_CTX *ctx, unsigned char *out, size_t *outl, size_t outsize); + int EVP_MAC_finalXOF(EVP_MAC_CTX *ctx, unsigned char *out, size_t outsize); const OSSL_PARAM *EVP_MAC_gettable_params(const EVP_MAC *mac); const OSSL_PARAM *EVP_MAC_gettable_ctx_params(const EVP_MAC *mac); @@ -140,6 +141,9 @@ dynamically, simply call with I<out> being NULL and I<outl> pointing at a valid location, then allocate space and make a second call with I<out> pointing at the allocated space. +EVP_MAC_finalXOF() does the final computation for an XOF based MAC and stores +the result in the memory pointed at by I<out> of size I<outsize>. + EVP_MAC_get_params() retrieves details about the implementation I<mac>. The set of parameters given with I<params> determine exactly what @@ -347,8 +351,8 @@ EVP_MAC_CTX_free() returns nothing at all. EVP_MAC_CTX_get_params() and EVP_MAC_CTX_set_params() return 1 on success, 0 on error. -EVP_MAC_init(), EVP_MAC_update(), and EVP_MAC_final() return 1 on success, 0 -on error. +EVP_MAC_init(), EVP_MAC_update(), EVP_MAC_final() and EVP_MAC_finalXOF() +return 1 on success, 0 on error. EVP_MAC_CTX_get_mac_size() returns the expected output size, or 0 if it isn't set. If it isn't set, a call to EVP_MAC_init() should get it set. |