32 #ifndef MBEDTLS_ECDH_H
33 #define MBEDTLS_ECDH_H
35 #if !defined(MBEDTLS_CONFIG_FILE)
38 #include MBEDTLS_CONFIG_FILE
43 #if defined(MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED)
44 #undef MBEDTLS_ECDH_LEGACY_CONTEXT
45 #include "everest/everest.h"
61 #if !defined(MBEDTLS_ECDH_LEGACY_CONTEXT)
70 MBEDTLS_ECDH_VARIANT_NONE = 0,
71 MBEDTLS_ECDH_VARIANT_MBEDTLS_2_0,
72 #if defined(MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED)
73 MBEDTLS_ECDH_VARIANT_EVEREST
75 } mbedtls_ecdh_variant;
84 typedef struct mbedtls_ecdh_context_mbed
91 #if defined(MBEDTLS_ECP_RESTARTABLE)
94 } mbedtls_ecdh_context_mbed;
106 #if defined(MBEDTLS_ECDH_LEGACY_CONTEXT)
116 #if defined(MBEDTLS_ECP_RESTARTABLE)
124 mbedtls_ecdh_variant var;
127 mbedtls_ecdh_context_mbed mbed_ecdh;
128 #if defined(MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED)
129 mbedtls_ecdh_context_everest everest_ecdh;
134 #if defined(MBEDTLS_ECP_RESTARTABLE)
135 uint8_t restart_enabled;
180 int (*f_rng)(
void *,
unsigned char *,
size_t),
219 int (*f_rng)(
void *,
unsigned char *,
size_t),
283 unsigned char *buf,
size_t blen,
284 int (*f_rng)(
void *,
unsigned char *,
size_t),
312 const unsigned char **buf,
313 const unsigned char *end );
365 unsigned char *buf,
size_t blen,
366 int (*f_rng)(
void *,
unsigned char *,
size_t),
389 const unsigned char *buf,
size_t blen );
422 unsigned char *buf,
size_t blen,
423 int (*f_rng)(
void *,
unsigned char *,
size_t),
426 #if defined(MBEDTLS_ECP_RESTARTABLE)
Configuration options (set of defines)
int mbedtls_ecdh_setup(mbedtls_ecdh_context *ctx, mbedtls_ecp_group_id grp_id)
This function sets up the ECDH context with the information given.
int mbedtls_ecdh_get_params(mbedtls_ecdh_context *ctx, const mbedtls_ecp_keypair *key, mbedtls_ecdh_side side)
This function sets up an ECDH context from an EC key.
int mbedtls_ecdh_gen_public(mbedtls_ecp_group *grp, mbedtls_mpi *d, mbedtls_ecp_point *Q, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function generates an ECDH keypair on an elliptic curve.
int mbedtls_ecdh_make_public(mbedtls_ecdh_context *ctx, size_t *olen, unsigned char *buf, size_t blen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function generates a public key and exports it as a TLS ClientKeyExchange payload.
int mbedtls_ecdh_calc_secret(mbedtls_ecdh_context *ctx, size_t *olen, unsigned char *buf, size_t blen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function derives and exports the shared secret.
int mbedtls_ecdh_can_do(mbedtls_ecp_group_id gid)
Check whether a given group can be used for ECDH.
int mbedtls_ecdh_make_params(mbedtls_ecdh_context *ctx, size_t *olen, unsigned char *buf, size_t blen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function generates an EC key pair and exports its in the format used in a TLS ServerKeyExchange ...
void mbedtls_ecdh_free(mbedtls_ecdh_context *ctx)
This function frees a context.
void mbedtls_ecdh_init(mbedtls_ecdh_context *ctx)
This function initializes an ECDH context.
int mbedtls_ecdh_read_public(mbedtls_ecdh_context *ctx, const unsigned char *buf, size_t blen)
This function parses and processes the ECDHE payload of a TLS ClientKeyExchange message.
struct mbedtls_ecdh_context mbedtls_ecdh_context
The ECDH context structure.
int mbedtls_ecdh_compute_shared(mbedtls_ecp_group *grp, mbedtls_mpi *z, const mbedtls_ecp_point *Q, const mbedtls_mpi *d, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function computes the shared secret.
int mbedtls_ecdh_read_params(mbedtls_ecdh_context *ctx, const unsigned char **buf, const unsigned char *end)
This function parses the ECDHE parameters in a TLS ServerKeyExchange handshake message.
This file provides an API for Elliptic Curves over GF(P) (ECP).
void mbedtls_ecp_restart_ctx
The ECDH context structure.
The ECP key-pair structure.
The ECP point structure, in Jacobian coordinates.