DOKK / manpages / debian 12 / libkcapi-dev / kcapi_cipher_setkey.3.en
KCAPI_CIPHER_SETKEY(3) Programming Interface KCAPI_CIPHER_SETKEY(3)

kcapi_cipher_setkey - set the key for the cipher handle

int kcapi_cipher_setkey(struct kcapi_handle * handle, const uint8_t * key, uint32_t keylen);

handle

[in] cipher handle

key

[in] key buffer

keylen

[in] length of key buffer

With this function, the caller sets the key for subsequent encryption or decryption operations.

After the caller provided the key, the caller may securely destroy the key as it is now maintained by the kernel.

return 0 upon success (in case of an akcipher handle, a positive integer is returned that denominates the maximum output size of the cryptographic operation -- this value must be used as the size of the output buffer for one cryptographic operation); a negative errno-style error code if an error occurred

Stephan Mueller <smueller@chronox.de>

Author.

February 2022 libkcapi Manual 1.4.0