mirror of
https://github.com/yuzu-emu/mbedtls.git
synced 2024-12-24 01:55:39 +00:00
Update md.h
Changes based on review comments
This commit is contained in:
parent
8c9c794518
commit
f3e4736131
|
@ -108,8 +108,8 @@ const int *mbedtls_md_list( void );
|
||||||
*
|
*
|
||||||
* \param md_name The name of the digest to search for.
|
* \param md_name The name of the digest to search for.
|
||||||
*
|
*
|
||||||
* \return The message-digest information associated with \p md_name,
|
* \return The message-digest information associated with \p md_name.
|
||||||
* or NULL if not found.
|
* \return NULL if the associated message-digest information is not found.
|
||||||
*/
|
*/
|
||||||
const mbedtls_md_info_t *mbedtls_md_info_from_string( const char *md_name );
|
const mbedtls_md_info_t *mbedtls_md_info_from_string( const char *md_name );
|
||||||
|
|
||||||
|
@ -168,9 +168,10 @@ void mbedtls_md_free( mbedtls_md_context_t *ctx );
|
||||||
* \param md_info The information structure of the message-digest algorithm
|
* \param md_info The information structure of the message-digest algorithm
|
||||||
* to use.
|
* to use.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter failure.
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* \returns #MBEDTLS_ERR_MD_ALLOC_FAILED memory allocation failure.
|
* failure.
|
||||||
|
* \return #MBEDTLS_ERR_MD_ALLOC_FAILED on memory-allocation failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_init_ctx( mbedtls_md_context_t *ctx, const mbedtls_md_info_t *md_info ) MBEDTLS_DEPRECATED;
|
int mbedtls_md_init_ctx( mbedtls_md_context_t *ctx, const mbedtls_md_info_t *md_info ) MBEDTLS_DEPRECATED;
|
||||||
#undef MBEDTLS_DEPRECATED
|
#undef MBEDTLS_DEPRECATED
|
||||||
|
@ -190,9 +191,10 @@ int mbedtls_md_init_ctx( mbedtls_md_context_t *ctx, const mbedtls_md_info_t *md_
|
||||||
* \param hmac Defines if HMAC is used. 0: HMAC is not used (saves some memory),
|
* \param hmac Defines if HMAC is used. 0: HMAC is not used (saves some memory),
|
||||||
* or non-zero: HMAC is used with this context.
|
* or non-zero: HMAC is used with this context.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter failure.
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* \returns #MBEDTLS_ERR_MD_ALLOC_FAILED on memory allocation failure.
|
* failure.
|
||||||
|
* \return #MBEDTLS_ERR_MD_ALLOC_FAILED on memory-allocation failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_setup( mbedtls_md_context_t *ctx, const mbedtls_md_info_t *md_info, int hmac );
|
int mbedtls_md_setup( mbedtls_md_context_t *ctx, const mbedtls_md_info_t *md_info, int hmac );
|
||||||
|
|
||||||
|
@ -213,7 +215,7 @@ int mbedtls_md_setup( mbedtls_md_context_t *ctx, const mbedtls_md_info_t *md_inf
|
||||||
* \param src The context to be cloned.
|
* \param src The context to be cloned.
|
||||||
*
|
*
|
||||||
* \return \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter failure.
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_clone( mbedtls_md_context_t *dst,
|
int mbedtls_md_clone( mbedtls_md_context_t *dst,
|
||||||
const mbedtls_md_context_t *src );
|
const mbedtls_md_context_t *src );
|
||||||
|
@ -260,9 +262,9 @@ const char *mbedtls_md_get_name( const mbedtls_md_info_t *md_info );
|
||||||
*
|
*
|
||||||
* \param ctx The generic message-digest context.
|
* \param ctx The generic message-digest context.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_starts( mbedtls_md_context_t *ctx );
|
int mbedtls_md_starts( mbedtls_md_context_t *ctx );
|
||||||
|
|
||||||
|
@ -278,9 +280,9 @@ int mbedtls_md_starts( mbedtls_md_context_t *ctx );
|
||||||
* \param input The buffer holding the input data.
|
* \param input The buffer holding the input data.
|
||||||
* \param ilen The length of the input data.
|
* \param ilen The length of the input data.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_update( mbedtls_md_context_t *ctx, const unsigned char *input, size_t ilen );
|
int mbedtls_md_update( mbedtls_md_context_t *ctx, const unsigned char *input, size_t ilen );
|
||||||
|
|
||||||
|
@ -298,9 +300,9 @@ int mbedtls_md_update( mbedtls_md_context_t *ctx, const unsigned char *input, si
|
||||||
* \param ctx The generic message-digest context.
|
* \param ctx The generic message-digest context.
|
||||||
* \param output The buffer for the generic message-digest checksum result.
|
* \param output The buffer for the generic message-digest checksum result.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_finish( mbedtls_md_context_t *ctx, unsigned char *output );
|
int mbedtls_md_finish( mbedtls_md_context_t *ctx, unsigned char *output );
|
||||||
|
|
||||||
|
@ -318,9 +320,9 @@ int mbedtls_md_finish( mbedtls_md_context_t *ctx, unsigned char *output );
|
||||||
* \param ilen The length of the input data.
|
* \param ilen The length of the input data.
|
||||||
* \param output The generic message-digest checksum result.
|
* \param output The generic message-digest checksum result.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md( const mbedtls_md_info_t *md_info, const unsigned char *input, size_t ilen,
|
int mbedtls_md( const mbedtls_md_info_t *md_info, const unsigned char *input, size_t ilen,
|
||||||
unsigned char *output );
|
unsigned char *output );
|
||||||
|
@ -339,8 +341,9 @@ int mbedtls_md( const mbedtls_md_info_t *md_info, const unsigned char *input, si
|
||||||
* \param output The generic message-digest checksum result.
|
* \param output The generic message-digest checksum result.
|
||||||
*
|
*
|
||||||
* \return \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_FILE_IO_ERROR if file input failed.
|
* \return #MBEDTLS_ERR_MD_FILE_IO_ERROR on an I/O error accessing
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if \p md_info was NULL.
|
* the file pointed by \p path.
|
||||||
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA if \p md_info was NULL.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_file( const mbedtls_md_info_t *md_info, const char *path,
|
int mbedtls_md_file( const mbedtls_md_info_t *md_info, const char *path,
|
||||||
unsigned char *output );
|
unsigned char *output );
|
||||||
|
@ -360,9 +363,9 @@ int mbedtls_md_file( const mbedtls_md_info_t *md_info, const char *path,
|
||||||
* \param key The HMAC secret key.
|
* \param key The HMAC secret key.
|
||||||
* \param keylen The length of the HMAC key in Bytes.
|
* \param keylen The length of the HMAC key in Bytes.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_hmac_starts( mbedtls_md_context_t *ctx, const unsigned char *key,
|
int mbedtls_md_hmac_starts( mbedtls_md_context_t *ctx, const unsigned char *key,
|
||||||
size_t keylen );
|
size_t keylen );
|
||||||
|
@ -382,9 +385,9 @@ int mbedtls_md_hmac_starts( mbedtls_md_context_t *ctx, const unsigned char *key,
|
||||||
* \param input The buffer holding the input data.
|
* \param input The buffer holding the input data.
|
||||||
* \param ilen The length of the input data.
|
* \param ilen The length of the input data.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_hmac_update( mbedtls_md_context_t *ctx, const unsigned char *input,
|
int mbedtls_md_hmac_update( mbedtls_md_context_t *ctx, const unsigned char *input,
|
||||||
size_t ilen );
|
size_t ilen );
|
||||||
|
@ -403,9 +406,9 @@ int mbedtls_md_hmac_update( mbedtls_md_context_t *ctx, const unsigned char *inpu
|
||||||
* context.
|
* context.
|
||||||
* \param output The generic HMAC checksum result.
|
* \param output The generic HMAC checksum result.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_hmac_finish( mbedtls_md_context_t *ctx, unsigned char *output);
|
int mbedtls_md_hmac_finish( mbedtls_md_context_t *ctx, unsigned char *output);
|
||||||
|
|
||||||
|
@ -420,9 +423,9 @@ int mbedtls_md_hmac_finish( mbedtls_md_context_t *ctx, unsigned char *output);
|
||||||
* \param ctx The message digest context containing an embedded HMAC
|
* \param ctx The message digest context containing an embedded HMAC
|
||||||
* context.
|
* context.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_hmac_reset( mbedtls_md_context_t *ctx );
|
int mbedtls_md_hmac_reset( mbedtls_md_context_t *ctx );
|
||||||
|
|
||||||
|
@ -444,9 +447,9 @@ int mbedtls_md_hmac_reset( mbedtls_md_context_t *ctx );
|
||||||
* \param ilen The length of the input data.
|
* \param ilen The length of the input data.
|
||||||
* \param output The generic HMAC result.
|
* \param output The generic HMAC result.
|
||||||
*
|
*
|
||||||
* \returns \c 0 on success.
|
* \return \c 0 on success.
|
||||||
* \returns #MBEDTLS_ERR_MD_BAD_INPUT_DATA if parameter verification
|
* \return #MBEDTLS_ERR_MD_BAD_INPUT_DATA on parameter-verification
|
||||||
* fails.
|
* failure.
|
||||||
*/
|
*/
|
||||||
int mbedtls_md_hmac( const mbedtls_md_info_t *md_info, const unsigned char *key, size_t keylen,
|
int mbedtls_md_hmac( const mbedtls_md_info_t *md_info, const unsigned char *key, size_t keylen,
|
||||||
const unsigned char *input, size_t ilen,
|
const unsigned char *input, size_t ilen,
|
||||||
|
|
Loading…
Reference in a new issue