|
|
@@ -0,0 +1,154 @@
|
|
|
+// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
|
|
|
+//
|
|
|
+// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
+// you may not use this file except in compliance with the License.
|
|
|
+// You may obtain a copy of the License at
|
|
|
+
|
|
|
+// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
+//
|
|
|
+// Unless required by applicable law or agreed to in writing, software
|
|
|
+// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
+// See the License for the specific language governing permissions and
|
|
|
+
|
|
|
+#pragma once
|
|
|
+
|
|
|
+#include "esp_rom_md5.h"
|
|
|
+
|
|
|
+#ifdef __cplusplus
|
|
|
+extern "C" {
|
|
|
+#endif
|
|
|
+
|
|
|
+typedef struct MD5Context mbedtls_md5_context;
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief Initialize MD5 context
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context to be initialized
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+int esp_md5_init_ret( mbedtls_md5_context *ctx );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief Clear MD5 context
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context to be cleared
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+void esp_md5_free( mbedtls_md5_context *ctx );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief Clone (the state of) an MD5 context
|
|
|
+ *
|
|
|
+ * \param dst The destination context
|
|
|
+ * \param src The context to be cloned
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+void esp_md5_clone( mbedtls_md5_context *dst, const mbedtls_md5_context *src );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief MD5 process buffer
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context
|
|
|
+ * \param input buffer holding the data
|
|
|
+ * \param ilen length of the input data
|
|
|
+ *
|
|
|
+ * \return 0 if successful
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+int esp_md5_update_ret( mbedtls_md5_context *ctx, const unsigned char *input, size_t ilen );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief MD5 final digest
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context
|
|
|
+ * \param output MD5 checksum result
|
|
|
+ *
|
|
|
+ * \return 0 if successful
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+int esp_md5_finish_ret( mbedtls_md5_context *ctx, unsigned char output[16] );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief MD5 process data block (internal use only)
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context
|
|
|
+ * \param data buffer holding one block of data
|
|
|
+ *
|
|
|
+ * \return 0 if successful
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+int esp_md5_process( mbedtls_md5_context *ctx, const unsigned char data[64] );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief MD5 context setup
|
|
|
+ *
|
|
|
+ * \deprecated Superseded by mbedtls_md5_starts_ret() in 2.7.0
|
|
|
+ *
|
|
|
+ * \param ctx context to be initialized
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+void esp_md5_init( mbedtls_md5_context *ctx );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief MD5 process buffer
|
|
|
+ *
|
|
|
+ * \deprecated Superseded by mbedtls_md5_update_ret() in 2.7.0
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context
|
|
|
+ * \param input buffer holding the data
|
|
|
+ * \param ilen length of the input data
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+void esp_md5_update( mbedtls_md5_context *ctx, const unsigned char *input, size_t ilen );
|
|
|
+
|
|
|
+/**
|
|
|
+ * \brief MD5 final digest
|
|
|
+ *
|
|
|
+ * \deprecated Superseded by mbedtls_md5_finish_ret() in 2.7.0
|
|
|
+ *
|
|
|
+ * \param ctx MD5 context
|
|
|
+ * \param output MD5 checksum result
|
|
|
+ *
|
|
|
+ * \warning MD5 is considered a weak message digest and its use
|
|
|
+ * constitutes a security risk. We recommend considering
|
|
|
+ * stronger message digests instead.
|
|
|
+ *
|
|
|
+ */
|
|
|
+void esp_md5_finish( mbedtls_md5_context *ctx, unsigned char output[16] );
|
|
|
+
|
|
|
+#ifdef __cplusplus
|
|
|
+}
|
|
|
+#endif
|