4e5f2c4007
Add key-agreement protocol primitives (kpp) API which allows to implement primitives required by protocols such as DH and ECDH. The API is composed mainly by the following functions * set_secret() - It allows the user to set his secret, also referred to as his private key, along with the parameters known to both parties involved in the key-agreement session. * generate_public_key() - It generates the public key to be sent to the other counterpart involved in the key-agreement session. The function has to be called after set_params() and set_secret() * generate_secret() - It generates the shared secret for the session Other functions such as init() and exit() are provided for allowing cryptographic hardware to be inizialized properly before use Signed-off-by: Salvatore Benedetto <salvatore.benedetto@intel.com> Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
65 lines
1.5 KiB
C
65 lines
1.5 KiB
C
/*
|
|
* Key-agreement Protocol Primitives (KPP)
|
|
*
|
|
* Copyright (c) 2016, Intel Corporation
|
|
* Authors: Salvatore Benedetto <salvatore.benedetto@intel.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the Free
|
|
* Software Foundation; either version 2 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
*/
|
|
#ifndef _CRYPTO_KPP_INT_H
|
|
#define _CRYPTO_KPP_INT_H
|
|
#include <crypto/kpp.h>
|
|
#include <crypto/algapi.h>
|
|
|
|
/*
|
|
* Transform internal helpers.
|
|
*/
|
|
static inline void *kpp_request_ctx(struct kpp_request *req)
|
|
{
|
|
return req->__ctx;
|
|
}
|
|
|
|
static inline void *kpp_tfm_ctx(struct crypto_kpp *tfm)
|
|
{
|
|
return tfm->base.__crt_ctx;
|
|
}
|
|
|
|
static inline void kpp_request_complete(struct kpp_request *req, int err)
|
|
{
|
|
req->base.complete(&req->base, err);
|
|
}
|
|
|
|
static inline const char *kpp_alg_name(struct crypto_kpp *tfm)
|
|
{
|
|
return crypto_kpp_tfm(tfm)->__crt_alg->cra_name;
|
|
}
|
|
|
|
/**
|
|
* crypto_register_kpp() -- Register key-agreement protocol primitives algorithm
|
|
*
|
|
* Function registers an implementation of a key-agreement protocol primitive
|
|
* algorithm
|
|
*
|
|
* @alg: algorithm definition
|
|
*
|
|
* Return: zero on success; error code in case of error
|
|
*/
|
|
int crypto_register_kpp(struct kpp_alg *alg);
|
|
|
|
/**
|
|
* crypto_unregister_kpp() -- Unregister key-agreement protocol primitive
|
|
* algorithm
|
|
*
|
|
* Function unregisters an implementation of a key-agreement protocol primitive
|
|
* algorithm
|
|
*
|
|
* @alg: algorithm definition
|
|
*/
|
|
void crypto_unregister_kpp(struct kpp_alg *alg);
|
|
|
|
#endif
|