Document EVP_Cipher() in code
authortb <tb@openbsd.org>
Fri, 15 Dec 2023 13:33:10 +0000 (13:33 +0000)
committertb <tb@openbsd.org>
Fri, 15 Dec 2023 13:33:10 +0000 (13:33 +0000)
commitcc7ca710fd65fef55a96b3324734f283b5efc135
tree3e068c95eabcc92f344e64b1a23677401aa58f1b
parent0dfd48690b2782a97b4f1f7262d7c148deb79271
Document EVP_Cipher() in code

EVP_Cipher() is an implementation detail of EVP_Cipher{Update,Final}().
Behavior depends on EVP_CIPH_FLAG_CUSTOM_CIPHER being set on ctx->cipher.

If the flag is set, do_cipher() operates in update mode if in != NULL and
in final mode if in == NULL. It returns the number of bytes written to out
(which may be 0) or -1 on error.

If the flag is not set, do_cipher() assumes properly aligned data and that
padding is handled correctly by the caller. Most do_cipher() methods will
silently produce garbage and succeed. Returns 1 on success, 0 on error.

ok jsing
lib/libcrypto/evp/evp_enc.c