THUAI6/CAPI/cpp/grpc/include/openssl/params.h

/*
 * Copyright 2019-2021 The OpenSSL Project Authors. All Rights Reserved.
 * Copyright (c) 2019, Oracle and/or its affiliates.  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
 */

#ifndef OPENSSL_PARAMS_H
#define OPENSSL_PARAMS_H
#pragma once

#include <openssl/core.h>
#include <openssl/bn.h>

#ifdef __cplusplus
extern "C"
{
#endif

#define OSSL_PARAM_UNMODIFIED ((size_t)-1)

#define OSSL_PARAM_END      \
    {                       \
        NULL, 0, NULL, 0, 0 \
    }

#define OSSL_PARAM_DEFN(key, type, addr, sz)               \
    {                                                      \
        (key), (type), (addr), (sz), OSSL_PARAM_UNMODIFIED \
    }

/* Basic parameter types without return sizes */
#define OSSL_PARAM_int(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(int))
#define OSSL_PARAM_uint(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), sizeof(unsigned int))
#define OSSL_PARAM_long(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(long int))
#define OSSL_PARAM_ulong(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), sizeof(unsigned long int))
#define OSSL_PARAM_int32(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(int32_t))
#define OSSL_PARAM_uint32(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), sizeof(uint32_t))
#define OSSL_PARAM_int64(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(int64_t))
#define OSSL_PARAM_uint64(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), sizeof(uint64_t))
#define OSSL_PARAM_size_t(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), sizeof(size_t))
#define OSSL_PARAM_time_t(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(time_t))
#define OSSL_PARAM_double(key, addr) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_REAL, (addr), sizeof(double))

#define OSSL_PARAM_BN(key, bn, sz) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (bn), (sz))
#define OSSL_PARAM_utf8_string(key, addr, sz) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UTF8_STRING, (addr), sz)
#define OSSL_PARAM_octet_string(key, addr, sz) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_OCTET_STRING, (addr), sz)

#define OSSL_PARAM_utf8_ptr(key, addr, sz) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UTF8_PTR, (addr), sz)
#define OSSL_PARAM_octet_ptr(key, addr, sz) \
    OSSL_PARAM_DEFN((key), OSSL_PARAM_OCTET_PTR, (addr), sz)

    /* Search an OSSL_PARAM array for a matching name */
    OSSL_PARAM* OSSL_PARAM_locate(OSSL_PARAM* p, const char* key);
    const OSSL_PARAM* OSSL_PARAM_locate_const(const OSSL_PARAM* p, const char* key);

    /* Basic parameter type run-time construction */
    OSSL_PARAM OSSL_PARAM_construct_int(const char* key, int* buf);
    OSSL_PARAM OSSL_PARAM_construct_uint(const char* key, unsigned int* buf);
    OSSL_PARAM OSSL_PARAM_construct_long(const char* key, long int* buf);
    OSSL_PARAM OSSL_PARAM_construct_ulong(const char* key, unsigned long int* buf);
    OSSL_PARAM OSSL_PARAM_construct_int32(const char* key, int32_t* buf);
    OSSL_PARAM OSSL_PARAM_construct_uint32(const char* key, uint32_t* buf);
    OSSL_PARAM OSSL_PARAM_construct_int64(const char* key, int64_t* buf);
    OSSL_PARAM OSSL_PARAM_construct_uint64(const char* key, uint64_t* buf);
    OSSL_PARAM OSSL_PARAM_construct_size_t(const char* key, size_t* buf);
    OSSL_PARAM OSSL_PARAM_construct_time_t(const char* key, time_t* buf);
    OSSL_PARAM OSSL_PARAM_construct_BN(const char* key, unsigned char* buf, size_t bsize);
    OSSL_PARAM OSSL_PARAM_construct_double(const char* key, double* buf);
    OSSL_PARAM OSSL_PARAM_construct_utf8_string(const char* key, char* buf, size_t bsize);
    OSSL_PARAM OSSL_PARAM_construct_utf8_ptr(const char* key, char** buf, size_t bsize);
    OSSL_PARAM OSSL_PARAM_construct_octet_string(const char* key, void* buf, size_t bsize);
    OSSL_PARAM OSSL_PARAM_construct_octet_ptr(const char* key, void** buf, size_t bsize);
    OSSL_PARAM OSSL_PARAM_construct_end(void);

    int OSSL_PARAM_allocate_from_text(OSSL_PARAM* to, const OSSL_PARAM* paramdefs, const char* key, const char* value, size_t value_n, int* found);

    int OSSL_PARAM_get_int(const OSSL_PARAM* p, int* val);
    int OSSL_PARAM_get_uint(const OSSL_PARAM* p, unsigned int* val);
    int OSSL_PARAM_get_long(const OSSL_PARAM* p, long int* val);
    int OSSL_PARAM_get_ulong(const OSSL_PARAM* p, unsigned long int* val);
    int OSSL_PARAM_get_int32(const OSSL_PARAM* p, int32_t* val);
    int OSSL_PARAM_get_uint32(const OSSL_PARAM* p, uint32_t* val);
    int OSSL_PARAM_get_int64(const OSSL_PARAM* p, int64_t* val);
    int OSSL_PARAM_get_uint64(const OSSL_PARAM* p, uint64_t* val);
    int OSSL_PARAM_get_size_t(const OSSL_PARAM* p, size_t* val);
    int OSSL_PARAM_get_time_t(const OSSL_PARAM* p, time_t* val);

    int OSSL_PARAM_set_int(OSSL_PARAM* p, int val);
    int OSSL_PARAM_set_uint(OSSL_PARAM* p, unsigned int val);
    int OSSL_PARAM_set_long(OSSL_PARAM* p, long int val);
    int OSSL_PARAM_set_ulong(OSSL_PARAM* p, unsigned long int val);
    int OSSL_PARAM_set_int32(OSSL_PARAM* p, int32_t val);
    int OSSL_PARAM_set_uint32(OSSL_PARAM* p, uint32_t val);
    int OSSL_PARAM_set_int64(OSSL_PARAM* p, int64_t val);
    int OSSL_PARAM_set_uint64(OSSL_PARAM* p, uint64_t val);
    int OSSL_PARAM_set_size_t(OSSL_PARAM* p, size_t val);
    int OSSL_PARAM_set_time_t(OSSL_PARAM* p, time_t val);

    int OSSL_PARAM_get_double(const OSSL_PARAM* p, double* val);
    int OSSL_PARAM_set_double(OSSL_PARAM* p, double val);

    int OSSL_PARAM_get_BN(const OSSL_PARAM* p, BIGNUM** val);
    int OSSL_PARAM_set_BN(OSSL_PARAM* p, const BIGNUM* val);

    int OSSL_PARAM_get_utf8_string(const OSSL_PARAM* p, char** val, size_t max_len);
    int OSSL_PARAM_set_utf8_string(OSSL_PARAM* p, const char* val);

    int OSSL_PARAM_get_octet_string(const OSSL_PARAM* p, void** val, size_t max_len, size_t* used_len);
    int OSSL_PARAM_set_octet_string(OSSL_PARAM* p, const void* val, size_t len);

    int OSSL_PARAM_get_utf8_ptr(const OSSL_PARAM* p, const char** val);
    int OSSL_PARAM_set_utf8_ptr(OSSL_PARAM* p, const char* val);

    int OSSL_PARAM_get_octet_ptr(const OSSL_PARAM* p, const void** val, size_t* used_len);
    int OSSL_PARAM_set_octet_ptr(OSSL_PARAM* p, const void* val, size_t used_len);

    int OSSL_PARAM_get_utf8_string_ptr(const OSSL_PARAM* p, const char** val);
    int OSSL_PARAM_get_octet_string_ptr(const OSSL_PARAM* p, const void** val, size_t* used_len);

    int OSSL_PARAM_modified(const OSSL_PARAM* p);
    void OSSL_PARAM_set_all_unmodified(OSSL_PARAM* p);

    OSSL_PARAM* OSSL_PARAM_dup(const OSSL_PARAM* p);
    OSSL_PARAM* OSSL_PARAM_merge(const OSSL_PARAM* p1, const OSSL_PARAM* p2);
    void OSSL_PARAM_free(OSSL_PARAM* p);

#ifdef __cplusplus
}
#endif
#endif