kcapi_cipher_setkey - Man Page

set the key for the cipher handle

Synopsis

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

Arguments

handle

[in] cipher handle

key

[in] key buffer

keylen

[in] length of key buffer

Description

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

Author

Stephan Mueller <​smueller@chronox.de​>

Author.

Info

August 2026 libkcapi Manual 1.5.1 Programming Interface