Warn if some returned value are not read

include/ox_aes.h

@@ -92,7 +92,7 @@ typedef struct cx_aes_key_s cx_aes_key_t;
  *                 - CX_OK on success
  *                 - CX_INVALID_PARAMETER
  */
-SYSCALL cx_err_t cx_aes_set_key_hw(const cx_aes_key_t *key PLENGTH(sizeof(cx_aes_key_t)), uint32_t mode);
+WARN_UNUSED_RESULT SYSCALL cx_err_t cx_aes_set_key_hw(const cx_aes_key_t *key PLENGTH(sizeof(cx_aes_key_t)), uint32_t mode);
 
 /**
  * @brief   Resets the AES context.
@@ -110,7 +110,7 @@ SYSCALL void cx_aes_reset_hw(void);
  *                      - CX_OK on success
  *                      - INVALID_PARAMETER
  */
-SYSCALL cx_err_t cx_aes_block_hw(const unsigned char *inblock PLENGTH(16), unsigned char  *outblock PLENGTH(16));
+WARN_UNUSED_RESULT SYSCALL cx_err_t cx_aes_block_hw(const unsigned char *inblock PLENGTH(16), unsigned char  *outblock PLENGTH(16));
 
 
 #endif

include/ox_vss.h

@@ -68,7 +68,7 @@ SYSCALL cx_err_t cx_vss_generate_shares(cx_vss_share_t *shares PLENGTH(shares_nu
  * @param[in]  threshold  Threshold of the secret sharing.
  * @return Error code
  */
-SYSCALL cx_err_t cx_vss_combine_shares(uint8_t *secret PLENGTH(secret_len),
+WARN_UNUSED_RESULT SYSCALL cx_err_t cx_vss_combine_shares(uint8_t *secret PLENGTH(secret_len),
                                        size_t secret_len,
                                        cx_vss_share_t *shares PLENGTH(sizeof(cx_vss_share_t)),
                                        uint8_t threshold);
@@ -85,7 +85,7 @@ SYSCALL cx_err_t cx_vss_combine_shares(uint8_t *secret PLENGTH(secret_len),
  * @param[out] verified         The commitments match.
  * @return Error code.
  */
-SYSCALL cx_err_t cx_vss_verify_commits(cx_vss_commitment_t *commitments,
+WARN_UNUSED_RESULT SYSCALL cx_err_t cx_vss_verify_commits(cx_vss_commitment_t *commitments,
                                        uint8_t threshold,
                                        cx_vss_commitment_t *share_commitment,
                                        uint32_t share_index,

lib_cxng/include/lcx_aes.h

@@ -54,7 +54,7 @@
  *                     - CX_OK on success
  *                     - CX_INVALID_PARAMETER
  */
-cx_err_t cx_aes_init_key_no_throw(const uint8_t *rawkey, size_t key_len, cx_aes_key_t *key);
+WARN_UNUSED_RESULT cx_err_t cx_aes_init_key_no_throw(const uint8_t *rawkey, size_t key_len, cx_aes_key_t *key);
 
 
 /**
@@ -111,7 +111,7 @@ DEPRECATED static inline size_t cx_aes_init_key ( const unsigned char * rawkey,
  *                    - CX_INVALID_PARAMETER
  *                    - INVALID_PARAMETER
  */
-cx_err_t cx_aes_iv_no_throw(const cx_aes_key_t *key,
+WARN_UNUSED_RESULT cx_err_t cx_aes_iv_no_throw(const cx_aes_key_t *key,
                             uint32_t            mode,
                             const uint8_t *     iv,
                             size_t              iv_len,
@@ -171,7 +171,7 @@ DEPRECATED static inline size_t cx_aes_iv ( const cx_aes_key_t * key, uint32_t m
  *                    - CX_INVALID_PARAMETER
  *                    - INVALID_PARAMETER
  */
-cx_err_t cx_aes_no_throw(const cx_aes_key_t *key, uint32_t mode, const uint8_t *in, size_t in_len, uint8_t *out, size_t *out_len);
+WARN_UNUSED_RESULT cx_err_t cx_aes_no_throw(const cx_aes_key_t *key, uint32_t mode, const uint8_t *in, size_t in_len, uint8_t *out, size_t *out_len);
 
 /**
  * @deprecated
@@ -198,7 +198,7 @@ DEPRECATED static inline size_t cx_aes ( const cx_aes_key_t * key, uint32_t mode
  *                      - CX_INVALID_PARAMETER
  *                      - INVALID_PARAMETER
  */
-cx_err_t cx_aes_enc_block(const cx_aes_key_t *key, const uint8_t *inblock, uint8_t *outblock);
+WARN_UNUSED_RESULT cx_err_t cx_aes_enc_block(const cx_aes_key_t *key, const uint8_t *inblock, uint8_t *outblock);
 
 /**
  * @brief   Decrypts a 16-byte block using AES algorithm.
@@ -214,7 +214,7 @@ cx_err_t cx_aes_enc_block(const cx_aes_key_t *key, const uint8_t *inblock, uint8
  *                      - CX_INVALID_PARAMETER
  *                      - INVALID_PARAMETER
  */
-cx_err_t cx_aes_dec_block(const cx_aes_key_t *key, const uint8_t *inblock, uint8_t *outblock);
+WARN_UNUSED_RESULT cx_err_t cx_aes_dec_block(const cx_aes_key_t *key, const uint8_t *inblock, uint8_t *outblock);
 
 #endif
 

lib_cxng/include/lcx_aes_gcm.h

@@ -54,18 +54,18 @@ typedef struct {
 } cx_aes_gcm_context_t;
 
 void cx_aes_gcm_init(cx_aes_gcm_context_t *ctx);
-cx_err_t cx_aes_gcm_set_key(cx_aes_gcm_context_t *ctx, const uint8_t *raw_key, size_t key_len);
-cx_err_t cx_aes_gcm_start(cx_aes_gcm_context_t *ctx, uint32_t mode,
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_set_key(cx_aes_gcm_context_t *ctx, const uint8_t *raw_key, size_t key_len);
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_start(cx_aes_gcm_context_t *ctx, uint32_t mode,
                           const uint8_t *iv, size_t iv_len);
-cx_err_t cx_aes_gcm_update_aad(cx_aes_gcm_context_t *ctx, const uint8_t *aad, size_t aad_len);
-cx_err_t cx_aes_gcm_update(cx_aes_gcm_context_t *ctx, const uint8_t *in, uint8_t *out, size_t len);
-cx_err_t cx_aes_gcm_finish(cx_aes_gcm_context_t *ctx, uint8_t *tag, size_t tag_len);
-cx_err_t cx_aes_gcm_encrypt_and_tag(cx_aes_gcm_context_t *ctx, uint8_t *in, size_t len,
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_update_aad(cx_aes_gcm_context_t *ctx, const uint8_t *aad, size_t aad_len);
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_update(cx_aes_gcm_context_t *ctx, const uint8_t *in, uint8_t *out, size_t len);
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_finish(cx_aes_gcm_context_t *ctx, uint8_t *tag, size_t tag_len);
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_encrypt_and_tag(cx_aes_gcm_context_t *ctx, uint8_t *in, size_t len,
                                     const uint8_t *iv, size_t iv_len, const uint8_t *aad, size_t aad_len,
                                     uint8_t *out, uint8_t *tag, size_t tag_len);
-cx_err_t cx_aes_gcm_decrypt_and_auth(cx_aes_gcm_context_t *ctx, uint8_t *in, size_t len,
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_decrypt_and_auth(cx_aes_gcm_context_t *ctx, uint8_t *in, size_t len,
                                      const uint8_t *iv, size_t iv_len, const uint8_t *aad,
                                      size_t aad_len, uint8_t *out, const uint8_t *tag, size_t tag_len);
-cx_err_t cx_aes_gcm_check_tag(cx_aes_gcm_context_t *ctx, const uint8_t *tag, size_t tag_len);
+WARN_UNUSED_RESULT cx_err_t cx_aes_gcm_check_tag(cx_aes_gcm_context_t *ctx, const uint8_t *tag, size_t tag_len);
 #endif
 #endif // HAVE_AES && HAVE_AES_GCM

lib_cxng/include/lcx_aes_siv.h

@@ -70,7 +70,7 @@ cx_err_t cx_aes_siv_init(cx_aes_siv_context_t *ctx);
  * @param[in] key_bitlen Size of the key in bits.
  * @return               Error code
  */
-cx_err_t cx_aes_siv_set_key(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_set_key(cx_aes_siv_context_t *ctx,
                             const uint8_t *key,
                             size_t key_bitlen);
 
@@ -86,7 +86,7 @@ cx_err_t cx_aes_siv_set_key(cx_aes_siv_context_t *ctx,
  *                   be 16 bytes.
  * @return           Error code
  */
-cx_err_t cx_aes_siv_start(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_start(cx_aes_siv_context_t *ctx,
                           uint32_t mode,
                           const uint8_t *iv,
                           size_t iv_len);
@@ -99,7 +99,7 @@ cx_err_t cx_aes_siv_start(cx_aes_siv_context_t *ctx,
  * @param[in] aad_len Length of the additional data.
  * @return            Error code.
  */
-cx_err_t cx_aes_siv_update_aad(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_update_aad(cx_aes_siv_context_t *ctx,
                                const uint8_t *aad,
                                size_t aad_len);
 
@@ -113,7 +113,7 @@ cx_err_t cx_aes_siv_update_aad(cx_aes_siv_context_t *ctx,
  * @param[in]  len    Length of the input.
  * @return            Error code.
  */
-cx_err_t cx_aes_siv_update(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_update(cx_aes_siv_context_t *ctx,
                            const uint8_t *input,
                            uint8_t *output,
                            size_t len);
@@ -129,7 +129,7 @@ cx_err_t cx_aes_siv_update(cx_aes_siv_context_t *ctx,
  *                       is given by the caller in case of decryption.
  * @return               Error code.
  */
-cx_err_t cx_aes_siv_finish(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_finish(cx_aes_siv_context_t *ctx,
                            const uint8_t *input,
                            size_t in_len,
                            uint8_t *tag);
@@ -148,7 +148,7 @@ cx_err_t cx_aes_siv_finish(cx_aes_siv_context_t *ctx,
  *                     will contain *16* bytes.
  * @return             Error code.
  */
-cx_err_t cx_aes_siv_encrypt(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_encrypt(cx_aes_siv_context_t *ctx,
                             const uint8_t *input,
                             size_t in_len,
                             const uint8_t *aad,
@@ -170,7 +170,7 @@ cx_err_t cx_aes_siv_encrypt(cx_aes_siv_context_t *ctx,
  *                     The buffer must contain *16* bytes.
  * @return             Error code
  */
-cx_err_t cx_aes_siv_decrypt(cx_aes_siv_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_aes_siv_decrypt(cx_aes_siv_context_t *ctx,
                             const uint8_t *input,
                             size_t in_len,
                             const uint8_t *aad,

lib_cxng/include/lcx_blake2.h

@@ -78,7 +78,7 @@ typedef struct cx_blake2b_s cx_blake2b_t;
  *                     - CX_OK
  *                     - CX_INVALID_PARAMETER
  */
-cx_err_t cx_blake2b_init_no_throw(cx_blake2b_t *hash, size_t out_len);
+WARN_UNUSED_RESULT cx_err_t cx_blake2b_init_no_throw(cx_blake2b_t *hash, size_t out_len);
 
 /**
  * @deprecated
@@ -111,7 +111,7 @@ DEPRECATED static inline int cx_blake2b_init ( cx_blake2b_t * hash, unsigned int
  *                      - CX_OK on success
  *                      - CX_INVALID_PARAMETER
  */
-cx_err_t cx_blake2b_init2_no_throw(cx_blake2b_t *hash,
+WARN_UNUSED_RESULT cx_err_t cx_blake2b_init2_no_throw(cx_blake2b_t *hash,
                                     size_t        out_len,
                                     uint8_t *     salt,
                                     size_t        salt_len,

lib_cxng/include/lcx_blake3.h

@@ -101,7 +101,7 @@ typedef struct {
  *
  * @return                Error code.
  */
-cx_err_t cx_blake3_init(cx_blake3_t *hash, uint8_t mode, const unsigned char *key,
+WARN_UNUSED_RESULT cx_err_t cx_blake3_init(cx_blake3_t *hash, uint8_t mode, const unsigned char *key,
                         const void *context, unsigned int context_len);
 
 /**
@@ -121,7 +121,7 @@ cx_err_t cx_blake3_init(cx_blake3_t *hash, uint8_t mode, const unsigned char *ke
  *
  * @return               Error code
  */
-cx_err_t cx_blake3(cx_blake3_t *hash, uint8_t mode, const void *input,
+WARN_UNUSED_RESULT cx_err_t cx_blake3(cx_blake3_t *hash, uint8_t mode, const void *input,
                    size_t input_len, uint8_t *out, size_t out_len);
 
 /**
@@ -135,7 +135,7 @@ cx_err_t cx_blake3(cx_blake3_t *hash, uint8_t mode, const void *input,
  *
  * @return              Error code.
  */
-cx_err_t cx_blake3_update(cx_blake3_t *hash, const void *input, size_t input_len);
+WARN_UNUSED_RESULT cx_err_t cx_blake3_update(cx_blake3_t *hash, const void *input, size_t input_len);
 
 /**
  * @brief Finalizes the hash.
@@ -148,7 +148,7 @@ cx_err_t cx_blake3_update(cx_blake3_t *hash, const void *input, size_t input_len
  *
  * @return             Error code.
  */
-cx_err_t cx_blake3_final(cx_blake3_t *hash, uint8_t *output, size_t out_len);
+WARN_UNUSED_RESULT cx_err_t cx_blake3_final(cx_blake3_t *hash, uint8_t *output, size_t out_len);
 
 #endif // LCX_BLAKE3_H
 #endif // HAVE_BLAKE3

lib_cxng/include/lcx_cmac.h

@@ -13,18 +13,18 @@
 #include "lcx_cipher.h"
 #include "cx_errors.h"
 
-cx_err_t cx_cmac_start(cx_cipher_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_cmac_start(cx_cipher_context_t *ctx,
                        const uint8_t *key,
                        size_t key_bitlen);
 
-cx_err_t cx_cmac_update(cx_cipher_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_cmac_update(cx_cipher_context_t *ctx,
                         const uint8_t *input,
                         size_t in_len);
 
-cx_err_t cx_cmac_finish(cx_cipher_context_t *ctx,
+WARN_UNUSED_RESULT cx_err_t cx_cmac_finish(cx_cipher_context_t *ctx,
                         uint8_t *output);
 
-cx_err_t cx_cmac(const cx_cipher_id_t type,
+WARN_UNUSED_RESULT cx_err_t cx_cmac(const cx_cipher_id_t type,
                  const uint8_t *key,
                  size_t key_bitlen,
                  const uint8_t *input,

lib_cxng/include/lcx_ecdh.h

@@ -72,7 +72,7 @@
  *                          - CX_INVALID_PARAMETER_SIZE
  *                          - CX_EC_INFINITE_POINT
  */
-cx_err_t cx_ecdh_no_throw(const cx_ecfp_private_key_t *pvkey,
+WARN_UNUSED_RESULT cx_err_t cx_ecdh_no_throw(const cx_ecfp_private_key_t *pvkey,
                  uint32_t                     mode,
                  const uint8_t *              P,
                  size_t                       P_len,

lib_cxng/include/lcx_ecdsa.h

@@ -78,7 +78,7 @@
  *                      - CX_EC_INFINITE_POINT
  *                      - CX_INVALID_PARAMETER_VALUE
  */
-cx_err_t cx_ecdsa_sign_no_throw(const cx_ecfp_private_key_t *pvkey,
+WARN_UNUSED_RESULT cx_err_t cx_ecdsa_sign_no_throw(const cx_ecfp_private_key_t *pvkey,
                        uint32_t                     mode,
                        cx_md_t                      hashID,
                        const uint8_t *              hash,
@@ -120,7 +120,7 @@ DEPRECATED static inline size_t cx_ecdsa_sign ( const cx_ecfp_private_key_t * pv
  *
  * @return             1 if the signature is verified, 0 otherwise.
  */
-bool cx_ecdsa_verify_no_throw(const cx_ecfp_public_key_t *pukey,
+WARN_UNUSED_RESULT bool cx_ecdsa_verify_no_throw(const cx_ecfp_public_key_t *pukey,
                      const uint8_t *             hash,
                      size_t                      hash_len,
                      const uint8_t *             sig,
@@ -148,7 +148,7 @@ bool cx_ecdsa_verify_no_throw(const cx_ecfp_public_key_t *pukey,
  *
  * @return             1 if the signature is verified, 0 otherwise.
  */
-static inline bool cx_ecdsa_verify ( const cx_ecfp_public_key_t * pukey, int mode, cx_md_t hashID, const unsigned char * hash, unsigned int hash_len, const unsigned char * sig, unsigned int sig_len)
+WARN_UNUSED_RESULT static inline bool cx_ecdsa_verify ( const cx_ecfp_public_key_t * pukey, int mode, cx_md_t hashID, const unsigned char * hash, unsigned int hash_len, const unsigned char * sig, unsigned int sig_len)
 {
   UNUSED(mode);
   UNUSED(hashID);

lib_cxng/include/lcx_ecfp.h

@@ -160,7 +160,7 @@ typedef struct cx_ecfp_640_private_key_s cx_ecfp_640_private_key_t;
  *                   - CX_EC_INVALID_POINT
  *                   - CX_EC_INFINITE_POINT
  */
-cx_err_t cx_ecfp_add_point_no_throw(cx_curve_t curve, uint8_t *R, const uint8_t *P, const uint8_t *Q);
+WARN_UNUSED_RESULT cx_err_t cx_ecfp_add_point_no_throw(cx_curve_t curve, uint8_t *R, const uint8_t *P, const uint8_t *Q);
 
 /**
  * @deprecated
@@ -203,7 +203,7 @@ DEPRECATED static inline size_t cx_ecfp_add_point ( cx_curve_t curve, unsigned c
  *                       - CX_INVALID_PARAMETER
  *                       - CX_EC_INFINITE_POINT
  */
-cx_err_t cx_ecfp_scalar_mult_no_throw(cx_curve_t curve, uint8_t *P, const uint8_t *k, size_t k_len);
+WARN_UNUSED_RESULT cx_err_t cx_ecfp_scalar_mult_no_throw(cx_curve_t curve, uint8_t *P, const uint8_t *k, size_t k_len);
 
 /**
  * @deprecated
@@ -244,7 +244,7 @@ DEPRECATED static inline size_t cx_ecfp_scalar_mult ( cx_curve_t curve, unsigned
  *                     - CX_EC_INVALID_CURVE
  *                     - INVALID_PARAMETER
  */
-cx_err_t cx_ecfp_init_public_key_no_throw(cx_curve_t            curve,
+WARN_UNUSED_RESULT cx_err_t cx_ecfp_init_public_key_no_throw(cx_curve_t            curve,
                                  const uint8_t *       rawkey,
                                  size_t                key_len,
                                  cx_ecfp_public_key_t *key);
@@ -279,7 +279,7 @@ DEPRECATED static inline size_t cx_ecfp_init_public_key ( cx_curve_t curve, cons
  *                     - CX_EC_INVALID_CURVE
  *                     - CX_INVALID_PARAMETER
  */
-cx_err_t cx_ecfp_init_private_key_no_throw(cx_curve_t             curve,
+WARN_UNUSED_RESULT cx_err_t cx_ecfp_init_private_key_no_throw(cx_curve_t             curve,
                                   const uint8_t *        rawkey,
                                   size_t                 key_len,
                                   cx_ecfp_private_key_t *pvkey);
@@ -319,7 +319,7 @@ DEPRECATED static inline size_t cx_ecfp_init_private_key ( cx_curve_t curve, con
  *                         - CX_EC_INVALID_POINT
  *                         - CX_EC_INFINITE_POINT
  */
-cx_err_t cx_ecfp_generate_pair_no_throw(cx_curve_t             curve,
+WARN_UNUSED_RESULT cx_err_t cx_ecfp_generate_pair_no_throw(cx_curve_t             curve,
                                cx_ecfp_public_key_t * pubkey,
                                cx_ecfp_private_key_t *privkey,
                                bool                   keepprivate);
@@ -361,7 +361,7 @@ DEPRECATED static inline int cx_ecfp_generate_pair ( cx_curve_t curve, cx_ecfp_p
  *                         - CX_EC_INVALID_POINT
  *                         - CX_EC_INFINITE_POINT
  */
-cx_err_t cx_ecfp_generate_pair2_no_throw(cx_curve_t             curve,
+WARN_UNUSED_RESULT cx_err_t cx_ecfp_generate_pair2_no_throw(cx_curve_t             curve,
                                 cx_ecfp_public_key_t * pubkey,
                                 cx_ecfp_private_key_t *privkey,
                                 bool                   keepprivate,
@@ -413,7 +413,7 @@ DEPRECATED static inline int cx_ecfp_generate_pair2 ( cx_curve_t curve, cx_ecfp_
  *                    - CX_INTERNAL_ERROR
  *
  */
-cx_err_t cx_eddsa_get_public_key_no_throw(const cx_ecfp_private_key_t *pvkey,
+WARN_UNUSED_RESULT cx_err_t cx_eddsa_get_public_key_no_throw(const cx_ecfp_private_key_t *pvkey,
                                  cx_md_t                      hashID,
                                  cx_ecfp_public_key_t *       pukey,
                                  uint8_t *                    a,
@@ -452,7 +452,7 @@ DEPRECATED static inline void cx_eddsa_get_public_key ( const cx_ecfp_private_ke
  *                       - CX_INVALID_PARAMETER
  *                       - CX_EC_INFINITE_POINT
  */
-cx_err_t cx_edwards_compress_point_no_throw(cx_curve_t curve, uint8_t *p, size_t p_len);
+WARN_UNUSED_RESULT cx_err_t cx_edwards_compress_point_no_throw(cx_curve_t curve, uint8_t *p, size_t p_len);
 
 /**
  * @deprecated
@@ -487,7 +487,7 @@ DEPRECATED static inline void cx_edwards_compress_point(cx_curve_t curve, uint8_
  *                       - CX_NO_RESIDUE
  *                       - INVALID_PARAMETER
  */
-cx_err_t cx_edwards_decompress_point_no_throw(cx_curve_t curve, uint8_t *p, size_t p_len);
+WARN_UNUSED_RESULT cx_err_t cx_edwards_decompress_point_no_throw(cx_curve_t curve, uint8_t *p, size_t p_len);
 
 /**
  * @deprecated

lib_cxng/include/lcx_ecschnorr.h

@@ -71,7 +71,7 @@
  *                     - CX_EC_INFINITE_POINT
  *                     - CX_INVALID_PARAMETER_VALUE
  */
-cx_err_t cx_ecschnorr_sign_no_throw(const cx_ecfp_private_key_t *pvkey,
+WARN_UNUSED_RESULT cx_err_t cx_ecschnorr_sign_no_throw(const cx_ecfp_private_key_t *pvkey,
                            uint32_t                     mode,
                            cx_md_t                      hashID,
                            const uint8_t *              msg,
@@ -121,7 +121,7 @@ DEPRECATED static inline size_t cx_ecschnorr_sign ( const cx_ecfp_private_key_t
  *
  * @return            1 if signature is verified, 0 otherwise.
  */
-bool cx_ecschnorr_verify(const cx_ecfp_public_key_t *pukey,
+WARN_UNUSED_RESULT bool cx_ecschnorr_verify(const cx_ecfp_public_key_t *pukey,
                          uint32_t                    mode,
                          cx_md_t                     hashID,
                          const uint8_t *             msg,