qlog.h

Go to the documentation of this file.

 
#ifndef IMQUIC_QLOG_H
#define IMQUIC_QLOG_H
 
#include <glib.h>

gboolean imquic_qlog_is_supported(void);
 
#ifdef HAVE_QLOG
#include <jansson.h>
 
#include "refcount.h"


#define IMQUIC_QLOG_TRIGGER_INTERNAL_ERROR                      "internal_error"
#define IMQUIC_QLOG_TRIGGER_REJECTED                            "rejected"
#define IMQUIC_QLOG_TRIGGER_UNSUPPORTED                         "unsupported"
#define IMQUIC_QLOG_TRIGGER_INVALID                                     "invalid"
#define IMQUIC_QLOG_TRIGGER_DUPLICATE                           "duplicate"
#define IMQUIC_QLOG_TRIGGER_CONNECTION_UNKNOWN          "connection_unknown"
#define IMQUIC_QLOG_TRIGGER_DECRYPTION_FAILURE          "decryption_failure"
#define IMQUIC_QLOG_TRIGGER_KEY_UNAVAILABLE                     "key_unavailable"
#define IMQUIC_QLOG_TRIGGER_GENERAL                                     "general"


typedef struct imquic_qlog {
        char *id;
        gboolean sequential;
        gboolean is_server;
        gboolean quic, quic_stream, http3, roq, roq_packets, moq, moq_messages, moq_objects;
        json_t *root;
        json_t *common;
        json_t *events;
        char *filename;
        FILE *file;
        imquic_mutex mutex;
        volatile gint destroyed;
        imquic_refcount ref;
} imquic_qlog;

imquic_qlog *imquic_qlog_create(char *id, gboolean sequential, gboolean is_server,
        char *filename, gboolean quic, gboolean quic_stream, gboolean http3,
                gboolean roq, gboolean roq_packets,
                gboolean moq, gboolean moq_messages, gboolean moq_objects);
void imquic_qlog_set_odcid(imquic_qlog *qlog, void *odcid);
int imquic_qlog_save_to_file(imquic_qlog *qlog);
void imquic_qlog_destroy(imquic_qlog *qlog);


json_t *imquic_qlog_event_prepare(const char *name);
json_t *imquic_qlog_event_add_data(json_t *event);
void imquic_qlog_event_add_raw(json_t *parent, const char *name, uint8_t *bytes, size_t length);
void imquic_qlog_event_add_path_endpoint_info(json_t *parent, const char *name, const char *ip, uint16_t port);
void imquic_qlog_append_event(imquic_qlog *qlog, json_t *event);
void imquic_qlog_connection_started(imquic_qlog *qlog, const char *local_ip, uint16_t local_port, const char *remote_ip, uint16_t remote_port);
void imquic_qlog_connection_closed(imquic_qlog *qlog, gboolean local, uint32_t cc_code, uint32_t app_code, const char *reason);
void imquic_qlog_version_information(imquic_qlog *qlog, uint32_t version, uint32_t chosen);
void imquic_qlog_alpn_information(imquic_qlog *qlog, uint8_t *server_alpn, size_t server_alpn_len,
        uint8_t *client_alpn, size_t client_alpn_len, char *chosen);
json_t *imquic_qlog_prepare_parameters_set(imquic_qlog *qlog, gboolean local, gboolean resumption, gboolean early_data);
void imquic_qlog_parameters_set(imquic_qlog *qlog, json_t *params);
json_t *imquic_qlog_prepare_packet_header(const char *type, void *scid, void *dcid);
json_t *imquic_qlog_prepare_packet_frame(const char *type);
void imquic_qlog_packet_sent(imquic_qlog *qlog, json_t *header, json_t *frames, uint32_t id, size_t length);
void imquic_qlog_packet_received(imquic_qlog *qlog, json_t *header, json_t *frames, uint32_t id, size_t length);
void imquic_qlog_packet_dropped(imquic_qlog *qlog, json_t *header, uint32_t id, size_t length, const char *trigger);
void imquic_qlog_udp_datagrams_sent(imquic_qlog *qlog, uint32_t id, size_t length);
void imquic_qlog_udp_datagrams_received(imquic_qlog *qlog, uint32_t id, size_t length);
void imquic_qlog_udp_datagrams_dropped(imquic_qlog *qlog, uint32_t id, size_t length);
void imquic_qlog_stream_state_updated(imquic_qlog *qlog, uint64_t id, const char *type, const char *side, const char *state);
void imquic_qlog_key_updated(imquic_qlog *qlog, const char *type, uint8_t *key, size_t key_len, uint64_t key_phase);
 
#endif
 
#endif