esp-idf/components/openssl/include/internal/ssl_pkey.h

// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at

//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#ifndef _SSL_PKEY_H_
#define _SSL_PKEY_H_

#ifdef __cplusplus
 extern "C" {
#endif

#include "ssl_types.h"

/**
 * @brief create a private key object according to input private key
 *
 * @param ipk - input private key point
 *
 * @return new private key object point
 */
EVP_PKEY* __EVP_PKEY_new(EVP_PKEY *ipk);

/**
 * @brief create a private key object
 *
 * @param none
 *
 * @return private key object point
 */
EVP_PKEY* EVP_PKEY_new(void);

/**
 * @brief load a character key context into system context. If '*a' is pointed to the
 *        private key, then load key into it. Or create a new private key object
 *
 * @param type   - private key type
 * @param a      - a point pointed to a private key point
 * @param pp     - a point pointed to the key context memory point
 * @param length - key bytes
 *
 * @return private key object point
 */
EVP_PKEY* d2i_PrivateKey(int type,
                         EVP_PKEY **a,
                         const unsigned char **pp,
                         long length);

/**
 * @brief decodes and load a buffer BIO into a EVP key context. If '*a' is pointed to the
 *        private key, then load key into it. Or create a new private key object
 *
 * @param bp BIO object containing the key
 * @param a Pointer to an existing EVP_KEY or NULL if a new key shall be created
 *
 * @return Created or updated EVP_PKEY
 */
EVP_PKEY *d2i_PrivateKey_bio(BIO *bp, EVP_PKEY **a);

/**
 * @brief Same as d2i_PrivateKey_bio
 *
 * @param bp BIO object containing the key
 * @param a Pointer to an existing EVP_KEY or NULL if a new key shall be created
 *
 * @return Created or updated EVP_PKEY
 */
RSA *d2i_RSAPrivateKey_bio(BIO *bp,RSA **rsa);

/**
 * @brief loads a private key in PEM format from BIO object
 *
 * @param bp BIO object containing the key
 * @param x  Pointer to an existent PKEY or NULL if a new key shall be created
 * @param cb Password callback (not used)
 * @param u User context (not used)
 *
 * @return Created or updated EVP_PKEY
 */
EVP_PKEY *PEM_read_bio_PrivateKey(BIO *bp, EVP_PKEY **x, pem_password_cb *cb, void *u);

/**
 * @brief RSA key in PEM format from BIO object
 *
 * @param bp BIO object containing the key
 * @param x  Pointer to an existent PKEY or NULL if a new key shall be created
 * @param cb Password callback (not used)
 * @param u User context (not used)
 *
 * @return Created or updated EVP_PKEY
 */

RSA *PEM_read_bio_RSAPrivateKey(BIO *bp, RSA **rsa, pem_password_cb *cb, void *u);

/**
 * @brief free a private key object
 *
 * @param pkey - private key object point
 *
 * @return none
 */
void EVP_PKEY_free(EVP_PKEY *x);

/**
 * @brief load private key into the SSL
 *
 * @param type - private key type
 * @param ssl  - SSL point
 * @param len  - data bytes
 * @param d    - data point
 *
 * @return result
 *     0 : failed
 *     1 : OK 
 */
 int SSL_use_PrivateKey_ASN1(int type, SSL *ssl, const unsigned char *d, long len);


#ifdef __cplusplus
}
#endif

#endif