imquic.h

Go to the documentation of this file.

 
#ifndef IMQUIC_IMQUIC_H
#define IMQUIC_IMQUIC_H
 
#include "debug.h"
 
/* Opaque structures */
typedef struct imquic_connection imquic_connection;
typedef struct imquic_network_endpoint imquic_server;
typedef struct imquic_network_endpoint imquic_client;
typedef struct imquic_network_endpoint imquic_endpoint;
 
 
int imquic_init(const char *secrets_log);
void imquic_deinit(void);
 
 
uint32_t imquic_get_version(void);
int imquic_get_version_major(void);
int imquic_get_version_minor(void);
int imquic_get_version_patch(void);
const char *imquic_get_version_release(void);
const char *imquic_get_version_string(void);
const char *imquic_get_version_string_full(void);
const char *imquic_get_build_time(void);
const char *imquic_get_build_sha(void);
 
 
void imquic_set_log_level(int level);
 
 
gboolean imquic_is_qlog_supported(void);
 
 
void imquic_set_lock_debugging(gboolean enabled);
void imquic_set_refcount_debugging(gboolean enabled);
 
typedef enum imquic_config {
        IMQUIC_CONFIG_INIT = 0,
        IMQUIC_CONFIG_LOCAL_BIND,
        IMQUIC_CONFIG_LOCAL_PORT,
        IMQUIC_CONFIG_REMOTE_HOST,
        IMQUIC_CONFIG_REMOTE_PORT,
        IMQUIC_CONFIG_TLS_CERT,
        IMQUIC_CONFIG_TLS_KEY,
        IMQUIC_CONFIG_TLS_PASSWORD,
        IMQUIC_CONFIG_EARLY_DATA,
        IMQUIC_CONFIG_TICKET_FILE,
        IMQUIC_CONFIG_SNI,
        IMQUIC_CONFIG_ALPN,
        IMQUIC_CONFIG_RAW_QUIC,
        IMQUIC_CONFIG_WEBTRANSPORT,
        IMQUIC_CONFIG_HTTP3_PATH,
        IMQUIC_CONFIG_SUBPROTOCOL,
        IMQUIC_CONFIG_QLOG_PATH,
        IMQUIC_CONFIG_QLOG_QUIC,
        IMQUIC_CONFIG_QLOG_HTTP3,
        IMQUIC_CONFIG_QLOG_ROQ,
        IMQUIC_CONFIG_QLOG_MOQ,
        IMQUIC_CONFIG_QLOG_SEQUENTIAL,
        IMQUIC_CONFIG_USER_DATA,
        IMQUIC_CONFIG_DONE,
} imquic_config;
const char *imquic_config_str(imquic_config type);
 
 
imquic_server *imquic_create_server(const char *name, ...);
imquic_client *imquic_create_client(const char *name, ...);
 
const char *imquic_get_endpoint_name(imquic_endpoint *endpoint);
gboolean imquic_is_endpoint_server(imquic_endpoint *endpoint);
const char *imquic_get_endpoint_alpn(imquic_endpoint *endpoint);
const char *imquic_get_endpoint_subprotocol(imquic_endpoint *endpoint);
uint16_t imquic_get_endpoint_port(imquic_endpoint *endpoint);
 
void imquic_start_endpoint(imquic_endpoint *endpoint);
void imquic_shutdown_endpoint(imquic_endpoint *endpoint);
 
void imquic_set_new_connection_cb(imquic_endpoint *endpoint,
        void (* new_connection)(imquic_connection *conn, void *user_data));
void imquic_set_stream_incoming_cb(imquic_endpoint *endpoint,
        void (* stream_incoming)(imquic_connection *conn, uint64_t stream_id,
                uint8_t *bytes, uint64_t offset, uint64_t length, gboolean complete));
void imquic_set_datagram_incoming_cb(imquic_endpoint *endpoint,
        void (* datagram_incoming)(imquic_connection *conn, uint8_t *bytes, uint64_t length));
void imquic_set_connection_gone_cb(imquic_endpoint *endpoint,
        void (* connection_gone)(imquic_connection *conn));
 
 
const char *imquic_get_connection_alpn(imquic_connection *conn);
const char *imquic_get_connection_name(imquic_connection *conn);
int imquic_new_stream_id(imquic_connection *conn, gboolean bidirectional, uint64_t *stream_id);
int imquic_send_on_stream(imquic_connection *conn, uint64_t stream_id,
        uint8_t *bytes, uint64_t offset, uint64_t length, gboolean complete);
int imquic_send_on_datagram(imquic_connection *conn, uint8_t *bytes, uint64_t length);
void imquic_close_connection(imquic_connection *conn, uint64_t error, const char *reason);
 
 
void imquic_connection_ref(imquic_connection *conn);
void imquic_connection_unref(imquic_connection *conn);
 
void imquic_stream_id_parse(uint64_t stream_id, uint64_t *id, gboolean *client_initiated, gboolean *bidirectional);
uint64_t imquic_stream_id_build(uint64_t id, gboolean client_initiated, gboolean bidirectional);
 
uint64_t imquic_varint_read(uint8_t *bytes, size_t blen, uint8_t *length);
uint8_t imquic_varint_write(uint64_t number, uint8_t *bytes, size_t blen);
 
uint64_t imquic_uint64_random(void);
uint64_t *imquic_uint64_dup(uint64_t num);
#endif