/*

 * Copyright 2023-2026 The OpenSSL Project Authors. All Rights Reserved.

 *

 * Licensed under the Apache License 2.0 (the "License").  You may not use

 * this file except in compliance with the License.  You can obtain a copy

 * in the file LICENSE in the source distribution or at

 * https://www.openssl.org/source/license.html

 */

#include "internal/quic_lcidm.h"

#include "internal/quic_types.h"

#include "internal/quic_vlint.h"

#include "internal/common.h"

#include "crypto/siphash.h"

#include <openssl/lhash.h>

#include <openssl/rand.h>

#include <openssl/err.h>

/*

 * QUIC Local Connection ID Manager

 * ================================

 */

typedef struct quic_lcidm_conn_st QUIC_LCIDM_CONN;

enum {

    LCID_TYPE_ODCID, /* This LCID is the ODCID from the peer */

    LCID_TYPE_INITIAL, /* This is our Initial SCID */

    LCID_TYPE_NCID /* This LCID was issued via a NCID frame */

};

typedef struct quic_lcid_st {

    QUIC_CONN_ID cid;

    uint64_t seq_num;

    /* copy of the hash key from lcidm */

    uint64_t *hash_key;

    /* Back-pointer to the owning QUIC_LCIDM_CONN structure. */

    QUIC_LCIDM_CONN *conn;

    /* LCID_TYPE_* */

    unsigned int type : 2;

} QUIC_LCID;

DEFINE_LHASH_OF_EX(QUIC_LCID);

DEFINE_LHASH_OF_EX(QUIC_LCIDM_CONN);

struct quic_lcidm_conn_st {

    size_t num_active_lcid;

    LHASH_OF(QUIC_LCID) *lcids;

    void *opaque;

    QUIC_LCID *odcid_lcid_obj;

    uint64_t next_seq_num;

    /* Have we enrolled an ODCID? */

    unsigned int done_odcid : 1;

};

struct quic_lcidm_st {

    OSSL_LIB_CTX *libctx;

    uint64_t hash_key[2]; /* random key for siphash */

    LHASH_OF(QUIC_LCID) *lcids; /* (QUIC_CONN_ID) -> (QUIC_LCID *)  */

    LHASH_OF(QUIC_LCIDM_CONN) *conns; /* (void *opaque) -> (QUIC_LCIDM_CONN *) */

    size_t lcid_len; /* Length in bytes for all LCIDs */

#ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION

    QUIC_CONN_ID next_lcid;

#endif

};

static unsigned long lcid_hash(const QUIC_LCID *lcid_obj)

{

    SIPHASH siphash = {

        0,

    };

    unsigned long hashval = 0;

    unsigned char digest[SIPHASH_MIN_DIGEST_SIZE];

    /* Use a supported SipHash digest size (8 or 16); 8 is sufficient here. */

    if (!SipHash_set_hash_size(&siphash, SIPHASH_MIN_DIGEST_SIZE))

        goto out;

    if (!SipHash_Init(&siphash, (uint8_t *)lcid_obj->hash_key, 0, 0))

        goto out;

    SipHash_Update(&siphash, lcid_obj->cid.id, lcid_obj->cid.id_len);

    if (!SipHash_Final(&siphash, digest, SIPHASH_MIN_DIGEST_SIZE))

        goto out;

    /*

     * Truncate the 64-bit SipHash digest into an unsigned long.

     */

    memcpy(&hashval, digest, sizeof(hashval) < sizeof(digest) ? sizeof(hashval) : sizeof(digest));

out:

    return hashval;

}

static int lcid_comp(const QUIC_LCID *a, const QUIC_LCID *b)

{

    return !ossl_quic_conn_id_eq(&a->cid, &b->cid);

}

static unsigned long lcidm_conn_hash(const QUIC_LCIDM_CONN *conn)

{

    return (unsigned long)(uintptr_t)conn->opaque;

}

static int lcidm_conn_comp(const QUIC_LCIDM_CONN *a, const QUIC_LCIDM_CONN *b)

{

    return a->opaque != b->opaque;

}

QUIC_LCIDM *ossl_quic_lcidm_new(OSSL_LIB_CTX *libctx, size_t lcid_len)

{

    QUIC_LCIDM *lcidm = NULL;

    if (lcid_len > QUIC_MAX_CONN_ID_LEN)

        goto err;

    if ((lcidm = OPENSSL_zalloc(sizeof(*lcidm))) == NULL)

        goto err;

    /* generate a random key for the hash tables hash function */

    if (!RAND_bytes_ex(libctx, (unsigned char *)&lcidm->hash_key,

            sizeof(uint64_t) * 2, 0))

        goto err;

    if ((lcidm->lcids = lh_QUIC_LCID_new(lcid_hash, lcid_comp)) == NULL)

        goto err;

    if ((lcidm->conns = lh_QUIC_LCIDM_CONN_new(lcidm_conn_hash,

             lcidm_conn_comp))

        == NULL)

        goto err;

    lcidm->libctx = libctx;

    lcidm->lcid_len = lcid_len;

    return lcidm;

err:

    if (lcidm != NULL) {

        lh_QUIC_LCID_free(lcidm->lcids);

        lh_QUIC_LCIDM_CONN_free(lcidm->conns);

        OPENSSL_free(lcidm);

    }

    return NULL;

}

static void lcidm_delete_conn(QUIC_LCIDM *lcidm, QUIC_LCIDM_CONN *conn);

static void lcidm_delete_conn_(QUIC_LCIDM_CONN *conn, void *arg)

{

    lcidm_delete_conn((QUIC_LCIDM *)arg, conn);

}

void ossl_quic_lcidm_free(QUIC_LCIDM *lcidm)

{

    if (lcidm == NULL)

        return;

    /*

     * Calling OPENSSL_lh_delete during a doall call is unsafe with our

     * current LHASH implementation for several reasons:

     *

     * - firstly, because deletes can cause the hashtable to be contracted,

     *   resulting in rehashing which might cause items in later buckets to

     *   move to earlier buckets, which might cause doall to skip an item,

     *   resulting in a memory leak;

     *

     * - secondly, because doall in general is not safe across hashtable

     *   size changes, as it caches hashtable size and pointer values

     *   while operating.

     *

     * The fix for this is to disable hashtable contraction using the following

     * call, which guarantees that no rehashing will occur so long as we only

     * call delete and not insert.

     */

    lh_QUIC_LCIDM_CONN_set_down_load(lcidm->conns, 0);

    lh_QUIC_LCIDM_CONN_doall_arg(lcidm->conns, lcidm_delete_conn_, lcidm);

    lh_QUIC_LCID_free(lcidm->lcids);

    lh_QUIC_LCIDM_CONN_free(lcidm->conns);

    OPENSSL_free(lcidm);

}

static QUIC_LCID *lcidm_get0_lcid(const QUIC_LCIDM *lcidm, const QUIC_CONN_ID *lcid)

{

    QUIC_LCID key;

    key.cid = *lcid;

    key.hash_key = (uint64_t *)lcidm->hash_key;

    if (key.cid.id_len > QUIC_MAX_CONN_ID_LEN)

        return NULL;

    return lh_QUIC_LCID_retrieve(lcidm->lcids, &key);

}

static QUIC_LCIDM_CONN *lcidm_get0_conn(const QUIC_LCIDM *lcidm, void *opaque)

{

    QUIC_LCIDM_CONN key;

    key.opaque = opaque;

    return lh_QUIC_LCIDM_CONN_retrieve(lcidm->conns, &key);

}

static QUIC_LCIDM_CONN *lcidm_upsert_conn(const QUIC_LCIDM *lcidm, void *opaque)

{

    QUIC_LCIDM_CONN *conn = lcidm_get0_conn(lcidm, opaque);

    if (conn != NULL)

        return conn;

    if ((conn = OPENSSL_zalloc(sizeof(*conn))) == NULL)

        goto err;

    if ((conn->lcids = lh_QUIC_LCID_new(lcid_hash, lcid_comp)) == NULL)

        goto err;

    conn->opaque = opaque;

    lh_QUIC_LCIDM_CONN_insert(lcidm->conns, conn);

    if (lh_QUIC_LCIDM_CONN_error(lcidm->conns))

        goto err;

    return conn;

err:

    if (conn != NULL) {

        lh_QUIC_LCID_free(conn->lcids);

        OPENSSL_free(conn);

    }

    return NULL;

}

static void lcidm_delete_conn_lcid(QUIC_LCIDM *lcidm, QUIC_LCID *lcid_obj)

{

    lh_QUIC_LCID_delete(lcidm->lcids, lcid_obj);

    lh_QUIC_LCID_delete(lcid_obj->conn->lcids, lcid_obj);

    assert(lcid_obj->conn->num_active_lcid > 0);

    --lcid_obj->conn->num_active_lcid;

    OPENSSL_free(lcid_obj);

}

/* doall_arg wrapper */

static void lcidm_delete_conn_lcid_(QUIC_LCID *lcid_obj, void *arg)

{

    lcidm_delete_conn_lcid((QUIC_LCIDM *)arg, lcid_obj);

}

static void lcidm_delete_conn(QUIC_LCIDM *lcidm, QUIC_LCIDM_CONN *conn)

{

    /* See comment in ossl_quic_lcidm_free */

    lh_QUIC_LCID_set_down_load(conn->lcids, 0);

    lh_QUIC_LCID_doall_arg(conn->lcids, lcidm_delete_conn_lcid_, lcidm);

    lh_QUIC_LCIDM_CONN_delete(lcidm->conns, conn);

    lh_QUIC_LCID_free(conn->lcids);

    OPENSSL_free(conn);

}

static QUIC_LCID *lcidm_conn_new_lcid(QUIC_LCIDM *lcidm, QUIC_LCIDM_CONN *conn,

    const QUIC_CONN_ID *lcid)

{

    QUIC_LCID *lcid_obj = NULL;

    if (lcid->id_len > QUIC_MAX_CONN_ID_LEN)

        return NULL;

    if ((lcid_obj = OPENSSL_zalloc(sizeof(*lcid_obj))) == NULL)

        goto err;

    lcid_obj->cid = *lcid;

    lcid_obj->conn = conn;

    lcid_obj->hash_key = lcidm->hash_key;

    lh_QUIC_LCID_insert(conn->lcids, lcid_obj);

    if (lh_QUIC_LCID_error(conn->lcids))

        goto err;

    lh_QUIC_LCID_insert(lcidm->lcids, lcid_obj);

    if (lh_QUIC_LCID_error(lcidm->lcids)) {

        lh_QUIC_LCID_delete(conn->lcids, lcid_obj);

        goto err;

    }

    ++conn->num_active_lcid;

    return lcid_obj;

err:

    OPENSSL_free(lcid_obj);

    return NULL;

}

size_t ossl_quic_lcidm_get_lcid_len(const QUIC_LCIDM *lcidm)

{

    return lcidm->lcid_len;

}

size_t ossl_quic_lcidm_get_num_active_lcid(const QUIC_LCIDM *lcidm,

    void *opaque)

{

    QUIC_LCIDM_CONN *conn;

    conn = lcidm_get0_conn(lcidm, opaque);

    if (conn == NULL)

        return 0;

    return conn->num_active_lcid;

}

static int lcidm_generate_cid(QUIC_LCIDM *lcidm,

    QUIC_CONN_ID *cid)

{

#ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION

    int i;

    lcidm->next_lcid.id_len = (unsigned char)lcidm->lcid_len;

    *cid = lcidm->next_lcid;

    for (i = lcidm->lcid_len - 1; i >= 0; --i)

        if (++lcidm->next_lcid.id[i] != 0)

            break;

    return 1;

#else

    return ossl_quic_gen_rand_conn_id(lcidm->libctx, lcidm->lcid_len, cid);

#endif

}

static int lcidm_generate(QUIC_LCIDM *lcidm,

    void *opaque,

    unsigned int type,

    QUIC_CONN_ID *lcid_out,

    uint64_t *seq_num)

{

    QUIC_LCIDM_CONN *conn;

    QUIC_LCID key, *lcid_obj;

    size_t i;

#define MAX_RETRIES 8

    if ((conn = lcidm_upsert_conn(lcidm, opaque)) == NULL)

        return 0;

    if ((type == LCID_TYPE_INITIAL && conn->next_seq_num > 0)

        || conn->next_seq_num > OSSL_QUIC_VLINT_MAX)

        return 0;

    i = 0;

    do {

        if (i++ >= MAX_RETRIES)

            /*

             * Too many retries; should not happen but if it does, don't loop

             * endlessly.

             */

            return 0;

        if (!lcidm_generate_cid(lcidm, lcid_out))

            return 0;

        key.cid = *lcid_out;

        key.hash_key = lcidm->hash_key;

        /* If a collision occurs, retry. */

    } while (lh_QUIC_LCID_retrieve(lcidm->lcids, &key) != NULL);

    if ((lcid_obj = lcidm_conn_new_lcid(lcidm, conn, lcid_out)) == NULL)

        return 0;

    lcid_obj->seq_num = conn->next_seq_num;

    lcid_obj->type = type;

    if (seq_num != NULL)

        *seq_num = lcid_obj->seq_num;

    ++conn->next_seq_num;

    return 1;

}

int ossl_quic_lcidm_enrol_odcid(QUIC_LCIDM *lcidm,

    void *opaque,

    const QUIC_CONN_ID *initial_odcid)

{

    QUIC_LCIDM_CONN *conn;

    QUIC_LCID key, *lcid_obj;

    if (initial_odcid == NULL || initial_odcid->id_len < QUIC_MIN_ODCID_LEN

        || initial_odcid->id_len > QUIC_MAX_CONN_ID_LEN)

        return 0;

    if ((conn = lcidm_upsert_conn(lcidm, opaque)) == NULL)

        return 0;

    if (conn->done_odcid)

        return 0;

    key.cid = *initial_odcid;

    key.hash_key = lcidm->hash_key;

    if (lh_QUIC_LCID_retrieve(lcidm->lcids, &key) != NULL)

        return 0;

    if ((lcid_obj = lcidm_conn_new_lcid(lcidm, conn, initial_odcid)) == NULL)

        return 0;

    lcid_obj->seq_num = LCIDM_ODCID_SEQ_NUM;

    lcid_obj->type = LCID_TYPE_ODCID;

    conn->odcid_lcid_obj = lcid_obj;

    conn->done_odcid = 1;

    return 1;

}

int ossl_quic_lcidm_generate_initial(QUIC_LCIDM *lcidm,

    void *opaque,

    QUIC_CONN_ID *initial_lcid)

{

    return lcidm_generate(lcidm, opaque, LCID_TYPE_INITIAL,

        initial_lcid, NULL);

}

int ossl_quic_lcidm_bind_channel(QUIC_LCIDM *lcidm, void *opaque,

    const QUIC_CONN_ID *lcid)

{

    QUIC_LCIDM_CONN *conn;

    QUIC_LCID *lcid_obj;

    /*

     * the plan is simple:

     *   make sure the lcid is still unused.

     *   do the same business as ossl_quic_lcidm_gnerate_initial() does,

     *   except we will use lcid instead of generating a new one.

     */

    if (ossl_quic_lcidm_lookup(lcidm, lcid, NULL, NULL) != 0)

        return 0;

    if ((conn = lcidm_upsert_conn(lcidm, opaque)) == NULL)

        return 0;

    if ((lcid_obj = lcidm_conn_new_lcid(lcidm, conn, lcid)) == NULL) {

        lcidm_delete_conn(lcidm, conn);

        return 0;

    }

    lcid_obj->seq_num = conn->next_seq_num;

    lcid_obj->type = LCID_TYPE_INITIAL;

    conn->next_seq_num++;

    return 1;

}

int ossl_quic_lcidm_generate(QUIC_LCIDM *lcidm,

    void *opaque,

    OSSL_QUIC_FRAME_NEW_CONN_ID *ncid_frame)

{

    ncid_frame->seq_num = 0;

    ncid_frame->retire_prior_to = 0;

    return lcidm_generate(lcidm, opaque, LCID_TYPE_NCID,

        &ncid_frame->conn_id,

        &ncid_frame->seq_num);

}

int ossl_quic_lcidm_retire_odcid(QUIC_LCIDM *lcidm, void *opaque)

{

    QUIC_LCIDM_CONN *conn;

    if ((conn = lcidm_upsert_conn(lcidm, opaque)) == NULL)

        return 0;

    if (conn->odcid_lcid_obj == NULL)

        return 0;

    lcidm_delete_conn_lcid(lcidm, conn->odcid_lcid_obj);

    conn->odcid_lcid_obj = NULL;

    return 1;

}

struct retire_args {

    QUIC_LCID *earliest_seq_num_lcid_obj;

    uint64_t earliest_seq_num, retire_prior_to;

};

static void retire_for_conn(QUIC_LCID *lcid_obj, void *arg)

{

    struct retire_args *args = arg;

    /* ODCID LCID cannot be retired via this API */

    if (lcid_obj->type == LCID_TYPE_ODCID

        || lcid_obj->seq_num >= args->retire_prior_to)

        return;

    if (lcid_obj->seq_num < args->earliest_seq_num) {

        args->earliest_seq_num = lcid_obj->seq_num;

        args->earliest_seq_num_lcid_obj = lcid_obj;

    }

}

int ossl_quic_lcidm_retire(QUIC_LCIDM *lcidm,

    void *opaque,

    uint64_t retire_prior_to,

    const QUIC_CONN_ID *containing_pkt_dcid,

    QUIC_CONN_ID *retired_lcid,

    uint64_t *retired_seq_num,

    int *did_retire)

{

    QUIC_LCIDM_CONN key, *conn;

    struct retire_args args = { 0 };

    key.opaque = opaque;

    if (did_retire == NULL)

        return 0;

    *did_retire = 0;

    if ((conn = lh_QUIC_LCIDM_CONN_retrieve(lcidm->conns, &key)) == NULL)

        return 1;

    args.retire_prior_to = retire_prior_to;

    args.earliest_seq_num = UINT64_MAX;

    lh_QUIC_LCID_doall_arg(conn->lcids, retire_for_conn, &args);

    if (args.earliest_seq_num_lcid_obj == NULL)

        return 1;

    if (containing_pkt_dcid != NULL

        && ossl_quic_conn_id_eq(&args.earliest_seq_num_lcid_obj->cid,

            containing_pkt_dcid))

        return 0;

    *did_retire = 1;

    if (retired_lcid != NULL)

        *retired_lcid = args.earliest_seq_num_lcid_obj->cid;

    if (retired_seq_num != NULL)

        *retired_seq_num = args.earliest_seq_num_lcid_obj->seq_num;

    lcidm_delete_conn_lcid(lcidm, args.earliest_seq_num_lcid_obj);

    return 1;

}

int ossl_quic_lcidm_cull(QUIC_LCIDM *lcidm, void *opaque)

{

    QUIC_LCIDM_CONN key, *conn;

    key.opaque = opaque;

    if ((conn = lh_QUIC_LCIDM_CONN_retrieve(lcidm->conns, &key)) == NULL)

        return 0;

    lcidm_delete_conn(lcidm, conn);

    return 1;

}

int ossl_quic_lcidm_lookup(QUIC_LCIDM *lcidm,

    const QUIC_CONN_ID *lcid,

    uint64_t *seq_num,

    void **opaque)

{

    QUIC_LCID *lcid_obj;

    if (lcid == NULL)

        return 0;

    if ((lcid_obj = lcidm_get0_lcid(lcidm, lcid)) == NULL)

        return 0;

    if (seq_num != NULL)

        *seq_num = lcid_obj->seq_num;

    if (opaque != NULL)

        *opaque = lcid_obj->conn->opaque;

    return 1;

}

int ossl_quic_lcidm_debug_remove(QUIC_LCIDM *lcidm,

    const QUIC_CONN_ID *lcid)

{

    QUIC_LCID key, *lcid_obj;

    key.cid = *lcid;

    key.hash_key = lcidm->hash_key;

    if ((lcid_obj = lh_QUIC_LCID_retrieve(lcidm->lcids, &key)) == NULL)

        return 0;

    lcidm_delete_conn_lcid(lcidm, lcid_obj);

    return 1;

}

int ossl_quic_lcidm_debug_add(QUIC_LCIDM *lcidm, void *opaque,

    const QUIC_CONN_ID *lcid,

    uint64_t seq_num)

{

    QUIC_LCIDM_CONN *conn;

    QUIC_LCID key, *lcid_obj;

    if (lcid == NULL || lcid->id_len > QUIC_MAX_CONN_ID_LEN)

        return 0;

    if ((conn = lcidm_upsert_conn(lcidm, opaque)) == NULL)

        return 0;

    key.cid = *lcid;

    key.hash_key = lcidm->hash_key;

    if (lh_QUIC_LCID_retrieve(lcidm->lcids, &key) != NULL)

        return 0;

    if ((lcid_obj = lcidm_conn_new_lcid(lcidm, conn, lcid)) == NULL)

        return 0;

    lcid_obj->seq_num = seq_num;

    lcid_obj->type = LCID_TYPE_NCID;

    return 1;

}

int ossl_quic_lcidm_get_unused_cid(QUIC_LCIDM *lcidm, QUIC_CONN_ID *cid)

{

    int i;

    for (i = 0; i < 10; i++) {

        if (lcidm_generate_cid(lcidm, cid)

            && lcidm_get0_lcid(lcidm, cid) == NULL)

            return 1; /* not found <=> radomly generated cid is unused */

    }

    return 0;

}