api: add he_enable_debugging function

Author: expressvpn-raihaan-m

3rd_party_deps.yml

@@ -11,6 +11,7 @@
       --disable-dilithium
       --enable-aes-bitsliced
       --enable-curve25519
+      --enable-debug
       --enable-dtls
       --enable-dtls13
       --enable-dtls-frag-ch

ios/autotools-ios-helper.sh

@@ -66,7 +66,9 @@ build() {
         --enable-aes-bitsliced \
         --enable-experimental \
         --enable-sha3 \
-        --enable-kyber=all,original,ml-kem
+        --enable-kyber=all,original,ml-kem \
+        --enable-debug
+
     make clean
     mkdir -p "${EXEC_PREFIX}"
     make V=1 -j"${MAKE_JOBS}" --debug=j

public/he.h

@@ -644,6 +644,14 @@ he_return_code_t he_init(void);
  */
 he_return_code_t he_cleanup(void);
 
+typedef void (*he_log_cb_t)(const int log_level, const char *const log_msg);
+
+/**
+ * @brief Enable WolfSSL debug logging and set the log callback
+ * @return HE_SUCCESS on success, HE_ERR_FAILED on any error.
+ */
+he_return_code_t he_enable_debugging(he_log_cb_t log_cb);
+
 /**
  * @brief Checks whether the client context has the basic configuration to allow Helium to connect.
  * @param ctx A pointer to a valid SSL context configuration

src/he/ssl_ctx.c

@@ -52,6 +52,19 @@ he_return_code_t he_cleanup() {
   return HE_SUCCESS;
 }
 
+he_return_code_t he_enable_debugging(he_log_cb_t log_cb) {
+  int rc = wolfSSL_Debugging_ON();
+  if(rc) {
+    return HE_ERR_FAILED;
+  }
+  if(log_cb) {
+    if(wolfSSL_SetLoggingCb(log_cb)) {
+      return HE_ERR_FAILED;
+    }
+  };
+  return HE_SUCCESS;
+}
+
 static he_return_code_t he_ssl_ctx_is_valid_common(he_ssl_ctx_t *ctx) {
   if(!ctx) {
     return HE_ERR_NULL_POINTER;

src/he/ssl_ctx.h

@@ -55,6 +55,14 @@ he_return_code_t he_init(void);
  */
 he_return_code_t he_cleanup(void);
 
+typedef void (*he_log_cb_t)(const int log_level, const char *const log_msg);
+
+/**
+ * @brief Enable WolfSSL debug logging and set the log callback
+ * @return HE_SUCCESS on success, HE_ERR_FAILED on any error.
+ */
+he_return_code_t he_enable_debugging(he_log_cb_t log_cb);
+
 /**
  * @brief Checks whether the client context has the basic configuration to allow Helium to connect.
  * @param ctx A pointer to a valid SSL context configuration