*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0)
* @retval #YACA_ERROR_INTERNAL Internal error
*/
int yaca_rand_bytes(char *data, size_t data_len);
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context, invalid param)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context or param)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_ex_param_e
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context, invalid param)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context or param)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_ex_param_e
* @see yaca_ctx_set_param()
+ * @see yaca_free()
*/
int yaca_ctx_get_param(const yaca_ctx_h ctx,
yaca_ex_param_e param,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context, invalid input_len)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context or input_len)
* @retval #YACA_ERROR_INTERNAL Internal error
*/
int yaca_get_output_length(const yaca_ctx_h ctx, size_t input_len, size_t *output_len);
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_digest_algo_e
* @see yaca_digest_update()
* @see yaca_digest_final()
+ * @see yaca_ctx_free()
*/
int yaca_digest_init(yaca_ctx_h *ctx, yaca_digest_algo_e algo);
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_digest_init()
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_digest_init()
* @see yaca_digest_update()
+ * @see yaca_get_digest_length()
*/
int yaca_digest_final(yaca_ctx_h ctx, char *digest, size_t *digest_len);
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, bcm, invalid sym_key or iv)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo, bcm, sym_key or iv)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_block_cipher_mode_e
* @see yaca_encrypt_update()
* @see yaca_encrypt_final()
+ * @see yaca_ctx_free()
*/
int yaca_encrypt_init(yaca_ctx_h *ctx,
yaca_enc_algo_e algo,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_encrypt_init()
* @see yaca_encrypt_final()
+ * @see yaca_get_output_length()
*/
int yaca_encrypt_update(yaca_ctx_h ctx,
const char *plain,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_encrypt_init()
* @see yaca_encrypt_update()
+ * @see yaca_get_output_length()
*/
int yaca_encrypt_final(yaca_ctx_h ctx,
char *cipher,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, bcm, invalid sym_key or iv)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo, bcm, sym_key or iv)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_block_cipher_mode_e
* @see yaca_decrypt_update()
* @see yaca_decrypt_final()
+ * @see yaca_ctx_free()
*/
int yaca_decrypt_init(yaca_ctx_h *ctx,
yaca_enc_algo_e algo,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_decrypt_init()
* @see yaca_decrypt_final()
+ * @see yaca_get_output_length()
*/
int yaca_decrypt_update(yaca_ctx_h ctx,
const char *cipher,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_decrypt_init()
* @see yaca_decrypt_update()
+ * @see yaca_get_block_length()
*/
int yaca_decrypt_final(yaca_ctx_h ctx,
char *plain,
size_t *plain_len);
/**
- * @brief Returns the recomended/default length of the IV for a given encryption configuration.
+ * @brief Returns the recommended/default length of the IV for a given encryption configuration.
*
* @since_tizen 3.0
*
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
* invalid algo, bcm or key_bits)
* @retval #YACA_ERROR_INTERNAL Internal error
*
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect key_type or data_len too big)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid key_type or data_len too big)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
* @retval #YACA_ERROR_PASSWORD_INVALID Invalid password given or password was required
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect key formats or data_len too big)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid key/file format or data_len too big)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT prv_key is of incorrect type or pub_key is NULL
+ * @retval #YACA_ERROR_INVALID_ARGUMENT prv_key is of invalid type or pub_key is NULL
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect algo or key_bits not dividable by 8)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid algo or key_bits not dividable by 8)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
+ *
+ * @see #yaca_digest_algo_e
+ * @see yaca_key_free()
*/
int yaca_key_derive_pbkdf2(const char *password,
const char *salt,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, bcm, sym_key_bits, invalid pub_key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo, bcm, sym_key_bits or pub_key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_seal_update()
* @see yaca_seal_final()
* @see yaca_key_free()
+ * @see yaca_ctx_free()
*/
int yaca_seal_init(yaca_ctx_h *ctx,
const yaca_key_h pub_key,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_seal_init()
* @see yaca_seal_final()
+ * @see yaca_get_output_length()
*/
int yaca_seal_update(yaca_ctx_h ctx,
const char *plain,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_seal_init()
* @see yaca_seal_update()
+ * @see yaca_get_block_length()
*/
int yaca_seal_final(yaca_ctx_h ctx,
char *cipher,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, bcm, sym_key_bits,
- * invalid prv_key, sym_key or iv)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo, bcm, sym_key_bits, prv_key, sym_key or iv)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_block_cipher_mode_e
* @see yaca_open_update()
* @see yaca_open_final()
+ * @see yaca_ctx_free()
*/
int yaca_open_init(yaca_ctx_h *ctx,
const yaca_key_h prv_key,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_open_init()
* @see yaca_open_final()
+ * @see yaca_get_output_length()
*/
int yaca_open_update(yaca_ctx_h ctx,
const char *cipher,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_open_init()
* @see yaca_open_update()
+ * @see yaca_get_block_length()
*/
int yaca_open_final(yaca_ctx_h ctx,
char *plain,
* on key type, supported key types:
* - #YACA_KEY_TYPE_RSA_PRIV,
* - #YACA_KEY_TYPE_DSA_PRIV,
- * - #YACA_KEY_TYPE_EC_PRIV
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_verify_init()
* @see yaca_verify_update()
* @see yaca_verify_final()
+ * @see yaca_ctx_free()
*/
int yaca_sign_init(yaca_ctx_h *ctx,
yaca_digest_algo_e algo,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_sign_update()
* @see yaca_sign_final()
* @see yaca_memcmp()
+ * @see yaca_ctx_free()
*/
int yaca_sign_hmac_init(yaca_ctx_h *ctx,
yaca_digest_algo_e algo,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_sign_update()
* @see yaca_sign_final()
* @see yaca_memcmp()
+ * @see yaca_ctx_free()
*/
int yaca_sign_cmac_init(yaca_ctx_h *ctx,
yaca_enc_algo_e algo,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_sign_init()
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_sign_init()
* @see yaca_sign_update()
* @see yaca_sign_hmac_init()
* @see yaca_sign_cmac_init()
+ * @see yaca_get_sign_length()
*/
int yaca_sign_final(yaca_ctx_h ctx,
char *signature,
* key type, supported key types:
* - #YACA_KEY_TYPE_RSA_PUB,
* - #YACA_KEY_TYPE_DSA_PUB,
- * - #YACA_KEY_TYPE_EC_PUB
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_digest_algo_e
* @see yaca_verify_update()
* @see yaca_verify_final()
+ * @see yaca_ctx_free()
*/
int yaca_verify_init(yaca_ctx_h *ctx,
yaca_digest_algo_e algo,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_verify_init()
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
- * incorrect context)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL,
+ * invalid context)
* @retval #YACA_ERROR_INTERNAL Internal error
* @retval #YACA_ERROR_DATA_MISMATCH The verification failed
*
* @see yaca_verify_init()
* @see yaca_verify_update()
+ * @see yaca_sign_final()
*/
int yaca_verify_final(yaca_ctx_h ctx,
const char *signature,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_digest_algo_e
+ * @see yaca_free()
*/
int yaca_digest_calc(yaca_digest_algo_e algo,
const char *data,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo, bcm, invalid sym_key, iv)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo, bcm, sym_key or iv)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_enc_algo_e
* @see #yaca_block_cipher_mode_e
* @see yaca_decrypt()
+ * @see yaca_free()
*/
int yaca_encrypt(yaca_enc_algo_e algo,
yaca_block_cipher_mode_e bcm,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo, bcm, invalid sym_key, iv)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo, bcm, sym_key or iv)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_enc_algo_e
* @see #yaca_block_cipher_mode_e
* @see yaca_encrypt()
+ * @see yaca_free()
*/
int yaca_decrypt(yaca_enc_algo_e algo,
yaca_block_cipher_mode_e bcm,
* deduced based on key type, supported key types:
* - #YACA_KEY_TYPE_RSA_PRIV,
* - #YACA_KEY_TYPE_DSA_PRIV,
- * - #YACA_KEY_TYPE_EC_PRIV
* @param[in] data Data to be signed
* @param[in] data_len Length of the data
* @param[out] signature Message signature, will be allocated by the
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_key_type_e
* @see #yaca_digest_algo_e
* @see yaca_verify()
+ * @see yaca_free()
*/
int yaca_sign(yaca_digest_algo_e algo,
const yaca_key_h key,
* deduced based on key type, supported key types:
* - #YACA_KEY_TYPE_RSA_PUB,
* - #YACA_KEY_TYPE_DSA_PUB,
- * - #YACA_KEY_TYPE_EC_PUB
* @param[in] data Signed data
* @param[in] data_len Length of the data
* @param[in] signature Message signature
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
* @retval #YACA_ERROR_DATA_MISMATCH The verification failed
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_key_type_e
* @see #yaca_digest_algo_e
* @see yaca_memcmp()
+ * @see yaca_free()
*/
int yaca_hmac(yaca_digest_algo_e algo,
const yaca_key_h key,
*
* @return #YACA_ERROR_NONE on success, negative on error
* @retval #YACA_ERROR_NONE Successful
- * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0
- * incorrect algo, invalid key)
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have incorrect values (NULL, 0
+ * invalid algo or key)
* @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
* @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_key_type_e
* @see #yaca_enc_algo_e
* @see yaca_memcmp()
+ * @see yaca_free()
*/
int yaca_cmac(yaca_enc_algo_e algo,
const yaca_key_h key,