NAME
EVP_CIPHER_CTX_get_cipher_data,
EVP_CIPHER_CTX_set_cipher_data,
EVP_CIPHER_CTX_buf_noconst —
inspect and modify EVP_CIPHER_CTX
objects
SYNOPSIS
#include
<openssl/evp.h>
void *
EVP_CIPHER_CTX_get_cipher_data(const
EVP_CIPHER_CTX *ctx);
void *
EVP_CIPHER_CTX_set_cipher_data(EVP_CIPHER_CTX
*ctx, void *cipher_data);
unsigned char *
EVP_CIPHER_CTX_buf_noconst(EVP_CIPHER_CTX
*ctx);
DESCRIPTION
EVP_CIPHER_CTX_get_cipher_data()
returns a pointer to the cipher data of ctx. The
format and content of this data is specific to the algorithm and to the
particular implementation of the cipher. For example, this data can be used
by engines to store engine specific information. The data is automatically
allocated and freed by OpenSSL, so applications and engines should not
normally free this directly (but see below).
EVP_CIPHER_CTX_set_cipher_data()
allows an application or engine to replace the existing cipher data with new
data, transferring ownership of cipher_data to the
ctx object. A pointer to any existing cipher data is
returned from this function. If the old data is no longer required, it
should be freed through a call to
free(3).
EVP_CIPHER_CTX_buf_noconst()
provides engines and custom cipher implementations with access to the
internal buffer that
EVP_EncryptUpdate(3) copies input data into before encrypting
it. This function can for example be used inside callback functions
installed with
EVP_CIPHER_meth_set_do_cipher(3).
RETURN VALUES
EVP_CIPHER_CTX_get_cipher_data() returns
an internal pointer owned by ctx.
EVP_CIPHER_CTX_set_cipher_data() returns a
pointer to the old cipher data of ctx and transfers
ownership to the caller.
EVP_CIPHER_CTX_buf_noconst() returns a
pointer to an internal buffer owned by ctx.
SEE ALSO
HISTORY
EVP_CIPHER_CTX_get_cipher_data(),
EVP_CIPHER_CTX_set_cipher_data(), and
EVP_CIPHER_CTX_buf_noconst() first appeared in
OpenSSL 1.1.0 and have been available since OpenBSD
7.1.