TLS Allocator ALLOC_TEMP_TLS, underlying allocator ALLOC_TEMP_MAIN has unfreed allocations, size 37

### 关于 `mbedtls_ssl_config_free` 的详细信息 `mbedtls_ssl_config_free` 是 MBED TLS 库中的一个重要函数，用于释放由 `mbedtls_ssl_config_alloc` 或其他配置初始化函数分配的资源。该函数的主要作用是清理 SSL 配置结构体所占用的内存和其他关联资源。 以下是其具体描述： #### 函数原型 ```c void mbedtls_ssl_config_free( mbedtls_ssl_config *conf ); ``` - 参数： - `mbedtls_ssl_config *conf`: 指向已初始化的 SSL 配置对象指针。 - 返回值：无返回值（`void`）。 此函数不会报告错误状态，因此调用者应确保传入的有效参数已经过适当初始化[^2]。 #### 使用场景 在使用 MBED TLS 进行安全通信时，通常会经历以下几个阶段： 1. 初始化 SSL 上下文和配置。 2. 设置证书、密钥以及其他必要的选项。 3. 执行握手过程并传输数据。 4. 清理上下文和释放资源。 当完成所有操作后，必须显式调用 `mbedtls_ssl_config_free` 来释放与配置相关的动态分配资源，从而避免内存泄漏。 --- ### 示例代码 以下是一个完整的示例程序片段，展示如何正确使用 `mbedtls_ssl_config_free`: ```c #include "mbedtls/ssl.h" #include "mbedtls/entropy.h" #include "mbedtls/ctr_drbg.h" int main() { mbedtls_entropy_context entropy; mbedtls_ctr_drbg_context ctr_drbg; mbedtls_ssl_config conf; // 初始化熵源和随机数生成器 mbedtls_entropy_init(&entropy); mbedtls_ctr_drbg_init(&ctr_drbg); if ((ret = mbedtls_ctr_drbg_seed(&ctr_drbg, mbedtls_entropy_func, &entropy, (const unsigned char *) "custom seed", strlen("custom seed"))) != 0) { printf("Failed to initialize random generator.\n"); goto exit; } // 初始化 SSL 配置 mbedtls_ssl_config_init(&conf); if ((ret = mbedtls_ssl_config_defaults(&conf, MBEDTLS_SSL_IS_CLIENT, MBEDTLS_SSL_TRANSPORT_STREAM, MBEDTLS_SSL_PRESET_DEFAULT)) != 0) { printf("Failed to set default configuration.\n"); goto exit; } // 设置认证模式及其他选项... mbedtls_ssl_conf_authmode(&conf, MBEDTLS_SSL_VERIFY_OPTIONAL); mbedtls_ssl_conf_rng(&conf, mbedtls_ctr_drbg_random, &ctr_drbg); // ...此处省略实际连接逻辑... exit: // 释放资源 mbedtls_ssl_config_free(&conf); // 释放 SSL 配置资源 mbedtls_ctr_drbg_free(&ctr_drbg); // 释放随机数生成器资源 mbedtls_entropy_free(&entropy); // 释放熵源资源 return 0; } ``` 在此示例中，可以看到 `mbedtls_ssl_config_free` 被放置在退出路径的最后一环，以确保所有资源都被妥善释放[^1]。 --- ### 注意事项 1. **仅能释放通过 `mbedtls_ssl_config_init` 初始化的对象**：如果尝试释放未经过初始化的配置对象，则可能导致不可预测的行为。 2. **顺序依赖性**：在调用 `mbedtls_ssl_config_free` 前，需先销毁任何与其绑定的子组件（如随机数生成器或上下文），否则可能引发双重释放问题。 3. **线程安全性**：MBED TLS 中大多数 API 不具备内在的线程保护机制，因此开发者应在多线程环境中自行管理同步逻辑[^2]。 ---