quic.h

Go to the documentation of this file.

/*
 * Copyright (c) 2026 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_NET_QUIC_H_
#define ZEPHYR_INCLUDE_NET_QUIC_H_

 
#include <zephyr/types.h>
#include <stddef.h>
#include <stdbool.h>
#include <zephyr/net/net_ip.h>
 
#ifdef __cplusplus
extern "C" {
#endif

struct net_stats_quic {
        uint32_t handshake_init_rx;
        uint32_t handshake_init_tx;
        uint32_t handshake_resp_rx;
        uint32_t handshake_resp_tx;
        uint32_t invalid_handshake;
        uint32_t peer_not_found;
        uint32_t invalid_packet;
        uint32_t invalid_key;
        uint32_t invalid_packet_len;
        uint32_t decrypt_failed;
        uint32_t drop_rx;
        uint32_t drop_tx;
        uint32_t alloc_failed;
        uint32_t valid_rx;
        uint32_t valid_tx;
};

struct net_stats_quic_global {
        uint32_t packets_rx;
        uint32_t connections_opened;
        uint32_t connections_closed;
        uint32_t streams_opened;
        uint32_t streams_closed;
        uint32_t connection_open_failed;
        uint32_t stream_open_failed;
        uint32_t connection_close_failed;
        uint32_t stream_close_failed;
};

enum quic_stream_direction {
        QUIC_STREAM_BIDIRECTIONAL  = 0x00, 
        QUIC_STREAM_UNIDIRECTIONAL = 0x02, 
};

enum quic_stream_initiator {
        QUIC_STREAM_CLIENT = 0x00, 
        QUIC_STREAM_SERVER = 0x01, 
};

#define ZSOCK_SOL_QUIC 284

enum {
        ZSOCK_QUIC_SO_STREAM_TYPE = 1,

        ZSOCK_QUIC_SO_CERT_CHAIN_ADD = 2,

        ZSOCK_QUIC_SO_CERT_CHAIN_DEL = 3,

        ZSOCK_QUIC_SO_STOP_SENDING_CODE = 4,

        ZSOCK_QUIC_SO_SESSION_STATE = 5,

        ZSOCK_QUIC_SO_SESSION_TICKET_ENABLE = 6,

        ZSOCK_QUIC_SO_MAX_EARLY_DATA_SIZE = 7,

        ZSOCK_QUIC_SO_STREAM_EARLY_DATA = 8,
};

#define QUIC_SESSION_STATE_VERSION 2U

#define QUIC_MAX_SESSION_TICKET_LEN 256U

#define QUIC_MAX_RESUMPTION_PSK_LEN 48U

struct quic_session_transport_params {
        bool valid;
        uint64_t initial_max_data;
        uint64_t initial_max_stream_data_bidi_local;
        uint64_t initial_max_stream_data_bidi_remote;
        uint64_t initial_max_stream_data_uni;
        uint64_t initial_max_streams_bidi;
        uint64_t initial_max_streams_uni;
        uint64_t max_idle_timeout;
        uint16_t max_udp_payload_size;
};

struct quic_session_state {
        uint16_t version;
        uint16_t cipher_suite;
        uint32_t ticket_lifetime;
        uint32_t ticket_age_add;
        uint32_t max_early_data_size;
        uint64_t issue_time_ms;
        uint16_t ticket_len;
        uint16_t psk_len;
        uint8_t ticket[QUIC_MAX_SESSION_TICKET_LEN];
        uint8_t psk[QUIC_MAX_RESUMPTION_PSK_LEN];
        struct quic_session_transport_params transport_params;
};

int quic_connection_open(const struct net_sockaddr *remote_addr,
                         const struct net_sockaddr *local_addr);

int quic_connection_close(int sock);

int quic_stream_open(int connection_sock,
                     enum quic_stream_initiator initiator,
                     enum quic_stream_direction direction,
                     uint8_t priority);

int quic_stream_close(int sock);

bool quic_is_stream_socket(int sock);

bool quic_is_connection_socket(int sock);

int quic_stream_get_id(int sock, uint64_t *stream_id);
 
 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_NET_QUIC_H_ */