diff options
Diffstat (limited to 'upstream/archlinux/man3/EVP_DigestInit.3ssl')
| -rw-r--r-- | upstream/archlinux/man3/EVP_DigestInit.3ssl | 29 |
1 files changed, 20 insertions, 9 deletions
diff --git a/upstream/archlinux/man3/EVP_DigestInit.3ssl b/upstream/archlinux/man3/EVP_DigestInit.3ssl index e0417ebf..89d4bad8 100644 --- a/upstream/archlinux/man3/EVP_DigestInit.3ssl +++ b/upstream/archlinux/man3/EVP_DigestInit.3ssl @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "EVP_DIGESTINIT 3ssl" -.TH EVP_DIGESTINIT 3ssl 2024-01-30 3.2.1 OpenSSL +.TH EVP_DIGESTINIT 3ssl 2024-04-28 3.3.0 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -71,6 +71,7 @@ EVP_MD_CTX_settable_params, EVP_MD_CTX_gettable_params, EVP_MD_CTX_set_flags, EVP_MD_CTX_clear_flags, EVP_MD_CTX_test_flags, EVP_Q_digest, EVP_Digest, EVP_DigestInit_ex2, EVP_DigestInit_ex, EVP_DigestInit, EVP_DigestUpdate, EVP_DigestFinal_ex, EVP_DigestFinalXOF, EVP_DigestFinal, +EVP_DigestSqueeze, EVP_MD_is_a, EVP_MD_get0_name, EVP_MD_get0_description, EVP_MD_names_do_all, EVP_MD_get0_provider, EVP_MD_get_type, EVP_MD_get_pkey_type, EVP_MD_get_size, EVP_MD_get_block_size, EVP_MD_get_flags, @@ -120,7 +121,8 @@ EVP_MD_CTX_type, EVP_MD_CTX_pkey_ctx, EVP_MD_CTX_md_data \& int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type, ENGINE *impl); \& int EVP_DigestUpdate(EVP_MD_CTX *ctx, const void *d, size_t cnt); \& int EVP_DigestFinal_ex(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *s); -\& int EVP_DigestFinalXOF(EVP_MD_CTX *ctx, unsigned char *md, size_t len); +\& int EVP_DigestFinalXOF(EVP_MD_CTX *ctx, unsigned char *out, size_t outlen); +\& int EVP_DigestSqueeze(EVP_MD_CTX *ctx, unsigned char *out, size_t outlen); \& \& EVP_MD_CTX *EVP_MD_CTX_dup(const EVP_MD_CTX *in); \& int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out, const EVP_MD_CTX *in); @@ -329,9 +331,15 @@ initialize a new digest operation. .IP \fBEVP_DigestFinalXOF()\fR 4 .IX Item "EVP_DigestFinalXOF()" Interfaces to extendable-output functions, XOFs, such as SHAKE128 and SHAKE256. -It retrieves the digest value from \fIctx\fR and places it in \fIlen\fR\-sized \fImd\fR. +It retrieves the digest value from \fIctx\fR and places it in \fIoutlen\fR\-sized \fIout\fR. After calling this function no additional calls to \fBEVP_DigestUpdate()\fR can be made, but \fBEVP_DigestInit_ex2()\fR can be called to initialize a new operation. +\&\fBEVP_DigestFinalXOF()\fR may only be called once +.IP \fBEVP_DigestSqueeze()\fR 4 +.IX Item "EVP_DigestSqueeze()" +Similar to \fBEVP_DigestFinalXOF()\fR but allows multiple calls to be made to +squeeze variable length output data. +\&\fBEVP_DigestFinalXOF()\fR should not be called after this. .IP \fBEVP_MD_CTX_dup()\fR 4 .IX Item "EVP_MD_CTX_dup()" Can be used to duplicate the message digest state from \fIin\fR. This is useful @@ -480,16 +488,17 @@ See \fBOSSL_PARAM\fR\|(3) for information about passing parameters. .IP """xoflen"" (\fBOSSL_DIGEST_PARAM_XOFLEN\fR) <unsigned integer>" 4 .IX Item """xoflen"" (OSSL_DIGEST_PARAM_XOFLEN) <unsigned integer>" Sets the digest length for extendable output functions. -It is used by the SHAKE algorithm and should not exceed what can be given -using a \fBsize_t\fR. +The value should not exceed what can be given using a \fBsize_t\fR. +It may be used by BLAKE2B\-512, SHAKE\-128 and SHAKE\-256 to set the +output length used by \fBEVP_DigestFinal_ex()\fR and \fBEVP_DigestFinal()\fR. .IP """pad-type"" (\fBOSSL_DIGEST_PARAM_PAD_TYPE\fR) <unsigned integer>" 4 .IX Item """pad-type"" (OSSL_DIGEST_PARAM_PAD_TYPE) <unsigned integer>" Sets the padding type. It is used by the MDC2 algorithm. .PP \&\fBEVP_MD_CTX_get_params()\fR can be used with the following OSSL_PARAM keys: -.IP """micalg"" (\fBOSSL_PARAM_DIGEST_KEY_MICALG\fR) <UTF8 string>." 4 -.IX Item """micalg"" (OSSL_PARAM_DIGEST_KEY_MICALG) <UTF8 string>." +.IP """micalg"" (\fBOSSL_DIGEST_PARAM_MICALG\fR) <UTF8 string>." 4 +.IX Item """micalg"" (OSSL_DIGEST_PARAM_MICALG) <UTF8 string>." Gets the digest Message Integrity Check algorithm string. This is used when creating S/MIME multipart/signed messages, as specified in RFC 3851. It may be used by external engines or providers. @@ -731,10 +740,12 @@ The \fBEVP_MD_CTX_md()\fR function was deprecated in OpenSSL 3.0; use \&\fBEVP_MD_CTX_update_fn()\fR and \fBEVP_MD_CTX_set_update_fn()\fR were deprecated in OpenSSL 3.0. .PP -\&\fBEVP_MD_CTX_dup()\fR was added in OpenSSL 3.2. +The \fBEVP_MD_CTX_dup()\fR function was added in OpenSSL 3.1. +.PP +The \fBEVP_DigestSqueeze()\fR function was added in OpenSSL 3.3. .SH COPYRIGHT .IX Header "COPYRIGHT" -Copyright 2000\-2023 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2000\-2024 The OpenSSL Project Authors. All Rights Reserved. .PP Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy |