[+] Export SSL handler of HTTP/3 connection for ssl_protocol, ssl_cip…

…her, etc. (#310)

* [+] Export SSL handler of HTTP/3 connection for ssl_protocol, ssl_cipher, etc.

* [!] fix format of function return

docs/API.md

@@ -464,6 +464,13 @@ xqc_int_t xqc_conn_get_errno(xqc_connection_t *conn);
 Get error code of specified connection.
 
 
+#### xqc_conn_get_ssl
+```
+void *xqc_conn_get_ssl(xqc_connection_t *conn);
+```
+Get ssl handler of specified connection.
+
+
 #### xqc_conn_set_transport_user_data
 ```
 void xqc_conn_set_transport_user_data(xqc_connection_t *conn, void *user_data);
@@ -839,6 +846,13 @@ xqc_int_t xqc_h3_conn_get_errno(xqc_h3_conn_t *h3c);
 Get connection error code.
 
 
+#### xqc_h3_conn_get_ssl
+```
+void *xqc_h3_conn_get_ssl(xqc_h3_conn_t *h3c);
+```
+Get ssl handler of http3 connection.
+
+
 #### xqc_h3_conn_set_user_data
 ```
 void xqc_h3_conn_set_user_data(xqc_h3_conn_t *h3c, void *user_data);

include/xquic/xqc_http3.h

@@ -461,6 +461,16 @@ XQC_EXPORT_PUBLIC_API
 xqc_int_t xqc_h3_conn_get_errno(xqc_h3_conn_t *h3c);
 
 
+/**
+ * @brief get ssl handler of http3 connection
+ * 
+ * @param h3c handler of http3 connection
+ * @return ssl handler of http3 connection
+ */
+XQC_EXPORT_PUBLIC_API
+void *xqc_h3_conn_get_ssl(xqc_h3_conn_t *h3c);
+
+
 /**
  * @brief set user_data for http3 connection, user_data could be the application layer context of 
  * http3 connection
@@ -480,7 +490,7 @@ void xqc_h3_conn_set_user_data(xqc_h3_conn_t *h3c, void *user_data);
  * @return user_data 
  */
 XQC_EXPORT_PUBLIC_API
-void* xqc_h3_conn_get_user_data(xqc_h3_conn_t *h3_conn);
+void *xqc_h3_conn_get_user_data(xqc_h3_conn_t *h3_conn);
 
 
 /**
@@ -742,7 +752,7 @@ void xqc_h3_ext_bytestream_set_user_data(xqc_h3_ext_bytestream_t *h3_ext_bs,
  * @return the pointer of user data
  */
 XQC_EXPORT_PUBLIC_API
-void* xqc_h3_ext_bytestream_get_user_data(xqc_h3_ext_bytestream_t *h3_ext_bs);
+void *xqc_h3_ext_bytestream_get_user_data(xqc_h3_ext_bytestream_t *h3_ext_bs);
 
 /**
  * @brief get statistics of a bytestream
@@ -809,7 +819,7 @@ void xqc_h3_ext_datagram_set_user_data(xqc_h3_conn_t *conn, void *user_data);
  * @return the user_data of all datagram callbacks
  */
 XQC_EXPORT_PUBLIC_API
-void* xqc_h3_ext_datagram_get_user_data(xqc_h3_conn_t *conn);
+void *xqc_h3_ext_datagram_get_user_data(xqc_h3_conn_t *conn);
 
 
 /**

include/xquic/xquic.h

@@ -1427,6 +1427,13 @@ XQC_EXPORT_PUBLIC_API
 xqc_int_t xqc_conn_get_errno(xqc_connection_t *conn);
 
 
+/**
+ * Get ssl handler of specified connection
+ */
+XQC_EXPORT_PUBLIC_API
+void *xqc_conn_get_ssl(xqc_connection_t *conn);
+
+
 /**
  * @brief get latest rtt sample of the initial path
  * 
@@ -1613,7 +1620,7 @@ void xqc_datagram_set_user_data(xqc_connection_t *conn, void *dgram_data);
  * @dgram_data: the user_data of all datagram callbacks
  */
 XQC_EXPORT_PUBLIC_API
-void* xqc_datagram_get_user_data(xqc_connection_t *conn);
+void *xqc_datagram_get_user_data(xqc_connection_t *conn);
 
 /**
  * @brief the API to send a datagram over the QUIC connection

scripts/xquic.lds

@@ -8,6 +8,7 @@ XQUIC_VERS_1.0 {
         xqc_h3_conn_close;
         xqc_scid_str;
         xqc_h3_conn_get_errno;
+        xqc_h3_conn_get_ssl;
         xqc_h3_conn_set_user_data;
         xqc_h3_conn_get_peer_addr;
         xqc_h3_conn_get_local_addr;
@@ -34,6 +35,7 @@ XQUIC_VERS_1.0 {
         xqc_connect;
         xqc_conn_close;
         xqc_conn_get_errno;
+        xqc_conn_get_ssl;
         xqc_conn_set_transport_user_data;
         xqc_conn_get_peer_addr;
         xqc_conn_get_local_addr;

src/http3/xqc_h3_conn.c

@@ -146,6 +146,17 @@ xqc_h3_conn_get_errno(xqc_h3_conn_t *h3_conn)
 }
 
 
+void *
+xqc_h3_conn_get_ssl(xqc_h3_conn_t *h3_conn)
+{
+    if (h3_conn->conn) {
+        return xqc_conn_get_ssl(h3_conn->conn);
+    }
+
+   return NULL;
+}
+
+
 void
 xqc_h3_conn_set_user_data(xqc_h3_conn_t *h3_conn,
                           void *user_data)

src/http3/xqc_h3_ext_bytestream.c

@@ -388,7 +388,7 @@ xqc_h3_ext_bytestream_set_user_data(xqc_h3_ext_bytestream_t *h3_ext_bs,
 
 
 
-void* 
+void *
 xqc_h3_ext_bytestream_get_user_data(xqc_h3_ext_bytestream_t *h3_ext_bs)
 {
     return h3_ext_bs->user_data;

src/http3/xqc_h3_ext_dgram.c

@@ -82,7 +82,7 @@ xqc_h3_ext_datagram_set_user_data(xqc_h3_conn_t *conn, void *user_data)
     xqc_datagram_set_user_data(conn->conn, user_data);
 }
 
-void* 
+void *
 xqc_h3_ext_datagram_get_user_data(xqc_h3_conn_t *conn)
 {
     return xqc_datagram_get_user_data(conn->conn);

src/tls/babassl/xqc_crypto.c

@@ -7,7 +7,7 @@
 #include <openssl/ssl.h>
 #include <openssl/err.h>
 
-void*
+void *
 xqc_aead_ctx_new(const xqc_pkt_protect_aead_t *pp_aead, xqc_key_type_t type,
     const uint8_t *key, size_t noncelen)
 {
@@ -176,7 +176,7 @@ xqc_ossl_aead_decrypt(const xqc_pkt_protect_aead_t *pp_aead, void *aead_ctx,
     return -XQC_TLS_DECRYPT_DATA_ERROR;
 }
 
-void*
+void *
 xqc_hp_ctx_new(const xqc_hdr_protect_cipher_t *hp_cipher, const uint8_t *key)
 {
     EVP_CIPHER_CTX *ctx = EVP_CIPHER_CTX_new();

src/tls/boringssl/xqc_crypto.c

@@ -6,7 +6,7 @@
 #include <openssl/chacha.h>
 
 
-void*
+void *
 xqc_aead_ctx_new(const xqc_pkt_protect_aead_t *pp_aead, xqc_key_type_t type,
                  const uint8_t *key, size_t noncelen)
 {
@@ -86,7 +86,7 @@ xqc_bssl_aead_decrypt(const xqc_pkt_protect_aead_t *pp_aead, void *aead_ctx,
 }
 
 
-void*
+void *
 xqc_hp_ctx_new(const xqc_hdr_protect_cipher_t *hp_cipher, const uint8_t *key)
 {
     EVP_CIPHER_CTX *ctx = EVP_CIPHER_CTX_new();

src/tls/xqc_tls.c

@@ -1124,6 +1124,16 @@ xqc_tls_get_selected_alpn(xqc_tls_t *tls, const char **out_alpn,
                            (unsigned *)out_len);
 }
 
+void *
+xqc_tls_get_ssl(xqc_tls_t *tls)
+{
+    if (!tls) {
+        return NULL;
+    }
+
+    return tls->ssl;
+}
+
 
 /**
  * ============================================================================

src/tls/xqc_tls.h

@@ -200,6 +200,10 @@ void xqc_tls_get_selected_alpn(xqc_tls_t *tls, const char **out_alpn,
 
 xqc_int_t xqc_tls_update_tp(xqc_tls_t *tls, uint8_t *tp_buf, size_t tp_len);
 
+/**
+ * @brief get SSL handler
+ */
+void *xqc_tls_get_ssl(xqc_tls_t *tls);
 
 
 #endif

src/transport/xqc_conn.c

@@ -2156,6 +2156,16 @@ xqc_conn_get_errno(xqc_connection_t *conn)
     return conn->conn_err;
 }
 
+void *
+xqc_conn_get_ssl(xqc_connection_t *conn)
+{
+    if (conn->tls) {
+        return xqc_tls_get_ssl(conn->tls);
+    }
+
+    return NULL;
+}
+
 xqc_int_t
 xqc_conn_immediate_close(xqc_connection_t *conn)
 {

src/transport/xqc_datagram.c

@@ -493,7 +493,7 @@ xqc_datagram_set_user_data(xqc_connection_t *conn, void *dgram_data)
     conn->dgram_data = dgram_data;
 }
 
-void* 
+void *
 xqc_datagram_get_user_data(xqc_connection_t *conn)
 {
     return conn->dgram_data;