aboutsummaryrefslogtreecommitdiff
path: root/secure/lib/libcrypto/man/man3/EVP_EncryptInit.3
diff options
context:
space:
mode:
Diffstat (limited to 'secure/lib/libcrypto/man/man3/EVP_EncryptInit.3')
-rw-r--r--secure/lib/libcrypto/man/man3/EVP_EncryptInit.312
1 files changed, 10 insertions, 2 deletions
diff --git a/secure/lib/libcrypto/man/man3/EVP_EncryptInit.3 b/secure/lib/libcrypto/man/man3/EVP_EncryptInit.3
index b30b3d783b34..664b588d448b 100644
--- a/secure/lib/libcrypto/man/man3/EVP_EncryptInit.3
+++ b/secure/lib/libcrypto/man/man3/EVP_EncryptInit.3
@@ -58,7 +58,7 @@
.\" ========================================================================
.\"
.IX Title "EVP_ENCRYPTINIT 3ossl"
-.TH EVP_ENCRYPTINIT 3ossl 2026-01-27 3.5.5 OpenSSL
+.TH EVP_ENCRYPTINIT 3ossl 2026-04-07 3.5.6 OpenSSL
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -1341,6 +1341,9 @@ for failure.
.PP
\&\fBEVP_CIPHER_names_do_all()\fR returns 1 if the callback was called for all names.
A return value of 0 means that the callback was not called for any names.
+.PP
+\&\fBEVP_CIPHER_get_params()\fR, \fBEVP_CIPHER_CTX_get_params()\fR and
+\&\fBEVP_CIPHER_CTX_set_params()\fR return 1 for success and 0 for failure.
.SH "CIPHER LISTING"
.IX Header "CIPHER LISTING"
All algorithms have a fixed key length unless otherwise stated.
@@ -1359,7 +1362,12 @@ depending on the mode specified.
To specify additional authenticated data (AAD), a call to \fBEVP_CipherUpdate()\fR,
\&\fBEVP_EncryptUpdate()\fR or \fBEVP_DecryptUpdate()\fR should be made with the output
parameter \fIout\fR set to NULL. In this case, on success, the parameter
-\&\fIoutl\fR is set to the number of bytes authenticated.
+\&\fIoutl\fR is set to the number of AAD bytes processed in that call
+(that is, the value of \fIinl\fR), and does not include any plaintext
+or ciphertext bytes processed by other calls.
+.PP
+If no AAD is used, this call can be omitted. See the mode\-specific notes
+below for any exceptions.
.PP
When decrypting, the return value of \fBEVP_DecryptFinal()\fR or \fBEVP_CipherFinal()\fR
indicates whether the operation was successful. If it does not indicate success,