| KCAPI_CIPHER_INIT(3) | Programming Interface | KCAPI_CIPHER_INIT(3) |
NAME¶
kcapi_cipher_init - initialize cipher handle
SYNOPSIS¶
int kcapi_cipher_init(struct kcapi_handle ** handle, const char * ciphername, uint32_t flags);
ARGUMENTS¶
handle
[out] cipher handle filled during the call
ciphername
[in] kernel crypto API cipher name as specified in
/proc/crypto
flags
[in] flags specifying the type of cipher handle
DESCRIPTION¶
This function provides the initialization of a symmetric cipher handle and establishes the connection to the kernel.
On success, a pointer to kcapi_handle object is returned in *handle. Function kcapi_cipher_destroy should be called afterwards to free resources.
return 0 upon success; -ENOENT - algorithm not available; -EOPNOTSUPP - AF_ALG family not available; -EINVAL - accept syscall failed -ENOMEM - cipher handle cannot be allocated
AUTHOR¶
Stephan Mueller <smueller@chronox.de>
Author.
COPYRIGHT¶
| October 2024 | libkcapi Manual 1.4.0 |