kopenssl.h

/* This file is part of the KDE libraries
   Copyright (C) 2001-2003 George Staikos <staikos@kde.org>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.
 
   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
 
 
// IF YOU ARE USING THIS CLASS, YOU ARE MAKING A MISTAKE.
 
#ifndef __KOPENSSLPROXY_H 
#define __KOPENSSLPROXY_H
 
#define KOSSL KOpenSSLProxy
class KOpenSSLProxyPrivate;
 
#include <klibloader.h>
 
#ifdef TQ_WS_WIN
#include "ksslconfig_win.h"
#else
#include "ksslconfig.h"
#endif
 
#ifdef KSSL_HAVE_SSL
#define crypt _openssl_crypt
#include <openssl/ssl.h>
#include <openssl/x509.h>
#include <openssl/x509v3.h>
#include <openssl/pem.h>
#include <openssl/bio.h>
#include <openssl/rand.h>
#include <openssl/asn1.h>
#include <openssl/pkcs7.h>
#include <openssl/pkcs12.h>
#include <openssl/evp.h>
#include <openssl/stack.h>
#include <openssl/bn.h>
#undef crypt
 
#if !defined(LIBRESSL_VERSION_NUMBER)
#define STACK OPENSSL_STACK
#else
#define STACK _STACK
#endif
 
#endif // KSSL_HAVE_SSL
 
#include <kstaticdeleter.h>
 
class TDEIO_EXPORT KOpenSSLProxy {
friend class KStaticDeleter<KOpenSSLProxy>;
public:
 
   static KOpenSSLProxy *self();
 
   bool hasLibCrypto() const;
 
   bool hasLibSSL() const;
 
   void destroy();
 
   // Here are the symbols that we need.
#ifdef KSSL_HAVE_SSL
 
   /*
    *   SSL_connect - initiate the TLS/SSL handshake with an TLS/SSL server
    */
   int SSL_connect(SSL *ssl);
 
   /*
    *   SSL_accept - initiate the TLS/SSL handshake with an TLS/SSL server
    */
   int SSL_accept(SSL *ssl);
 
   /*
    *   SSL_get_error - get the error code
    */
   int SSL_get_error(SSL *ssl, int rc);
 
   /*
    *   SSL_read - read bytes from a TLS/SSL connection.
    */
   int SSL_read(SSL *ssl, void *buf, int num);
 
   /*
    *   SSL_write - write bytes to a TLS/SSL connection.
    */
   int SSL_write(SSL *ssl, const void *buf, int num);
 
   /*
    *   SSL_new - create a new SSL structure for a connection
    */
   SSL *SSL_new(SSL_CTX *ctx);
 
   /*
    *   SSL_free - free an allocated SSL structure
    */
   void SSL_free(SSL *ssl);
 
   /*
    *   SSL_shutdown - shutdown an allocated SSL connection
    */
   int SSL_shutdown(SSL *ssl);
 
   /*
    *   SSL_CTX_new - create a new SSL_CTX object as framework for TLS/SSL enabled functions
    */
   SSL_CTX *SSL_CTX_new(SSL_METHOD *method);
 
   /*
    *   SSL_CTX_free - free an allocated SSL_CTX object
    */
   void SSL_CTX_free(SSL_CTX *ctx);
 
   /*
    *   SSL_set_fd - connect the SSL object with a file descriptor
    */
   int SSL_set_fd(SSL *ssl, int fd);
 
   /*
    *   SSL_pending - obtain number of readable bytes buffered in an SSL object
    */
   int SSL_pending(SSL *ssl);
 
   /*
    *   SSL_peek - obtain bytes buffered in an SSL object
    */
   int SSL_peek(SSL *ssl, void *buf, int num);
 
   /*
    *   SSL_CTX_set_cipher_list - choose list of available SSL_CIPHERs
    */
   int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str);
 
   /*
    *   SSL_CTX_set_verify - set peer certificate verification parameters
    */
   void SSL_CTX_set_verify(SSL_CTX *ctx, int mode,
                         int (*verify_callback)(int, X509_STORE_CTX *));
 
   /*
    *   SSL_use_certificate - load certificate
    */
   int SSL_use_certificate(SSL *ssl, X509 *x);
 
   /*
    *   SSL_get_current_cipher - get SSL_CIPHER of a connection
    */
   SSL_CIPHER *SSL_get_current_cipher(SSL *ssl);
 
   /* SSL_set_options - manipulate SSL engine options */
   long _SSL_set_options(SSL *ssl, long options);
 
   /* Returns 0 if not reused, 1 if session id is reused */
   int _SSL_session_reused(SSL *ssl);
 
   /* SSL control */
   long SSL_ctrl(SSL *ssl, int cmd, long larg, void *parg);
 
   /*
    *   RAND_egd - set the path to the EGD
    */
   int RAND_egd(const char *path);
 
 
   /*
    *   RAND_file_name 
    */
   const char *RAND_file_name(char *buf, size_t num);
 
 
   /*
    *   RAND_load_file 
    */
   int RAND_load_file(const char *filename, long max_bytes);
 
 
   /*
    *   RAND_write_file 
    */
   int RAND_write_file(const char *filename);
 
 
   /*
    *   TLSv1_client_method - return a TLSv1 client method object
    */
   SSL_METHOD *TLSv1_client_method();
 
 
   /*
    *   SSLv2_client_method - return a SSLv2 client method object
    */
   SSL_METHOD *SSLv2_client_method();
 
 
   /*
    *   SSLv3_client_method - return a SSLv3 client method object
    */
   SSL_METHOD *SSLv3_client_method();
 
 
   /*
    *   TLS_client_method - return client method object
    */
   SSL_METHOD *TLS_client_method();
 
 
   /*
    *   SSL_get_peer_certificate - return the peer's certificate
    */
   X509 *SSL_get_peer_certificate(SSL *s);
 
 
   /*
    *   SSL_get_peer_cert_chain - get the peer's certificate chain
    */
   STACK_OF(X509) *SSL_get_peer_cert_chain(SSL *s);
 
   /*
    *   SSL_CIPHER_get_bits - get the number of bits in this cipher
    */
   int SSL_CIPHER_get_bits(SSL_CIPHER *c,int *alg_bits);
 
 
   /*
    *   SSL_CIPHER_get_version - get the version of this cipher
    */
   char *SSL_CIPHER_get_version(SSL_CIPHER *c);
 
 
   /*
    *   SSL_CIPHER_get_name - get the name of this cipher
    */
   const char *SSL_CIPHER_get_name(SSL_CIPHER *c);
 
 
   /*
    *   SSL_CIPHER_description - get the description of this cipher
    */
   char *SSL_CIPHER_description(SSL_CIPHER *,char *buf,int size);
 
 
   /*
    *   SSL_CTX_use_PrivateKey - set the private key for the session.
    *                          - for use with client certificates
    */
   int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);
 
 
   /*
    *   SSL_CTX_use_certificate - set the client certificate for the session.
    */
   int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);
 
 
   /*
    *   d2i_X509 - Covert a text representation of X509 to an X509 object
    */
   X509 * d2i_X509(X509 **a,unsigned char **pp,long length);
 
   /*
    *   d2i_X509 - Covert a text representation of X509 CRL to an X509_CRL object
    */
   X509_CRL * d2i_X509_CRL(X509_CRL **a,unsigned char **pp,long length);
 
 
   /*
    *   i2d_X509 - Covert an X509 object into a text representation
    */
   int i2d_X509(X509 *a,unsigned char **pp);
 
 
   /*
    *   X509_cmp - compare two X509 objects
    */
   int X509_cmp(X509 *a, X509 *b);
 
 
   /*
    *   X509_subject_name_cmp - compare subject name of two X509 objects
    */
   int X509_subject_name_cmp(const X509 *a, const X509 *b);
 
 
   /*
    *   X509_dup - duplicate an X509 object
    */
   X509 *X509_dup(X509 *x509);
 
 
   /*
    *   X509_get0_signature - get signature and algorithm
    */
   void X509_get0_signature(const ASN1_BIT_STRING **psig,
                            const X509_ALGOR **palg, const X509 *x);
 
 
 
   /*
    *
    */
   ASN1_TIME *X509_getm_notAfter(const X509 *x);
 
 
   /*
    *
    */
   ASN1_TIME *X509_getm_notBefore(const X509 *x);
 
 
   /*
    *   X509_STORE_CTX_new - create an X509 store context
    */
   X509_STORE_CTX *X509_STORE_CTX_new(void);
 
 
   /*
    *   X509_STORE_CTX_free - free up an X509 store context
    */
   void X509_STORE_CTX_free(X509_STORE_CTX *v);
 
 
   /*
    *   X509_STORE_CTX_set0_untrusted - set the certificate chain
    */
   void X509_STORE_CTX_set0_untrusted(X509_STORE_CTX *v, STACK_OF(X509)* x);
 
 
   /*
    *   X509_STORE_CTX_set_purpose - set the purpose of the certificate 
    */
   void X509_STORE_CTX_set_purpose(X509_STORE_CTX *v, int purpose);
 
 
   /*
    *
    */
   X509 *X509_STORE_CTX_get_current_cert(X509_STORE_CTX *ctx);
 
 
   /*
    *
    */
   int X509_STORE_CTX_get_error(X509_STORE_CTX *ctx);
 
 
   /*
    *
    */
   int X509_STORE_CTX_get_error_depth(X509_STORE_CTX *ctx);
 
 
   /*
    *
    */
   void X509_STORE_CTX_set_error(X509_STORE_CTX *ctx, int s);
 
 
   /*
    *
    */
   void X509_STORE_set_verify_cb(X509_STORE *ctx,
                                 X509_STORE_CTX_verify_cb verify_cb);
 
 
   /*
    *
    */
   STACK_OF(X509_OBJECT) *X509_STORE_get0_objects(X509_STORE *v);
 
 
   /*
    *
    */
   X509_LOOKUP_TYPE X509_OBJECT_get_type(const X509_OBJECT *a);
 
 
   /*
    *
    */
   X509 *X509_OBJECT_get0_X509(const X509_OBJECT *a);
 
 
   /*
    *   X509_verify_cert - verify the certificate
    */
   int X509_verify_cert(X509_STORE_CTX *v);
 
 
   /*
    *   X509_STORE_new - create an X509 store
    */
   X509_STORE *X509_STORE_new(void);
 
 
   /*
    *   X509_STORE_free - free up an X509 store
    */
   void X509_STORE_free(X509_STORE *v);
 
 
   /*
    *   X509_free - free up an X509
    */
   void X509_free(X509 *v);
 
   /*
    *   X509_CRL_free - free up an X509 CRL
    */
   void X509_CRL_free(X509_CRL *v);
 
 
   /*
    *
    */
   const ASN1_TIME *X509_CRL_get0_lastUpdate(const X509_CRL *crl);
 
 
   /*
    *
    */
   const ASN1_TIME *X509_CRL_get0_nextUpdate(const X509_CRL *crl);
 
 
   /*
    *   X509_NAME_oneline - return the X509 data in a string
    */
   char *X509_NAME_oneline(X509_NAME *a, char *buf, int size);
 
 
   /*
    *   X509_get_subject_name - return the X509_NAME for the subject field
    */
   X509_NAME *X509_get_subject_name(X509 *a);
 
 
   /*
    *   X509_get_issuer_name - return the X509_NAME for the issuer field
    */
   X509_NAME *X509_get_issuer_name(X509 *a);
 
 
   /*
    *   X509_STORE_add_lookup - add a lookup file/method to an X509 store
    */
   X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m);
 
 
   /*
    *   X509_LOOKUP_file - Definition of the LOOKUP_file method
    */
   X509_LOOKUP_METHOD *X509_LOOKUP_file(void);
 
 
   /*
    *   X509_LOOKUP_free - Free an X509_LOOKUP
    */
   void X509_LOOKUP_free(X509_LOOKUP *x);
 
 
   /*
    *   X509_LOOKUP_ctrl - This is not normally called directly (use macros)
    */
   int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc, long argl, char **ret);
 
 
   /*
    *   X509_STORE_CTX_init - initialize an X509 STORE context
    */
   void X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *store, X509 *x509, STACK_OF(X509) *chain);
 
 
   /*
    *   CRYPTO_free - free up an internally allocated object
    */
   void CRYPTO_free(void *x);
 
   /*
    *   BIO_new - create new BIO
    */
   BIO *BIO_new(BIO_METHOD *type);
 
   /*
    *   BIO methods - only one defined here yet
    */
   BIO_METHOD *BIO_s_mem(void);
 
   /*
    *   BIO_new_fp - nastiness called BIO - used to create BIO* from FILE*
    */
   BIO *BIO_new_fp(FILE *stream, int close_flag);
 
   /*
    *   BIO_new_mem_buf - read only BIO from memory region
    */
   BIO *BIO_new_mem_buf(void *buf, int len);
 
   /*
    *   BIO_free - nastiness called BIO - used to destroy BIO*
    */
   int BIO_free(BIO *a);
 
   /*
    *   BIO_ctrl - BIO control method
    */
   long BIO_ctrl(BIO *bp,int cmd,long larg,void *parg);
 
   /*
    *   BIO_write - equivalent to ::write for BIO
    */
   int BIO_write(BIO *b, const void *data, int len);
 
   /*
    *   BIO_get_data - retrieve (custom) data from BIO
    */
   void *BIO_get_data(BIO *a);
 
   /*
    *   PEM_write_bio_X509 - write a PEM encoded cert to a BIO*
    */
   int PEM_write_bio_X509(BIO *bp, X509 *x);
 
   /*
    *   ASN1_i2d_fp - used for netscape output
    */
   int ASN1_i2d_fp(FILE *out, unsigned char *x);
 
 
   /*
    *   ASN1_d2i_fp - read an X509 from a DER encoded file (buf can be NULL)
    */
   X509 *X509_d2i_fp(FILE *out, X509** buf);
 
 
   /*
    *   X509_print - print the text form of an X509
    */
   int X509_print(FILE *fp, X509 *x);
 
 
   /*
    *   Read a PKCS#12 cert from fp
    */
   PKCS12 *d2i_PKCS12_fp(FILE *fp, PKCS12 **p12);
 
 
   /*
    *   Change the password on a PKCS#12 cert
    */
   int PKCS12_newpass(PKCS12 *p12, char *oldpass, char *newpass);
 
 
   /*
    *   Write a PKCS#12 to mem
    */
   int i2d_PKCS12(PKCS12 *p12, unsigned char **p);
 
 
   /*
    *   Write a PKCS#12 to FILE*
    */
   int i2d_PKCS12_fp(FILE *fp, PKCS12 *p12);
 
 
   /*
    *   Create a new PKCS#12 object
    */
   PKCS12 *PKCS12_new(void);
 
 
   /*
    *   Destroy that PKCS#12 that you created!
    */
   void PKCS12_free(PKCS12 *a);
 
 
   /* 
    *   Parse the PKCS#12 
    */
   int PKCS12_parse(PKCS12 *p12, const char *pass, EVP_PKEY **pkey,
                    X509 **cert, STACK_OF(X509) **ca);
 
 
   /* 
    *   Free the Private Key
    */
   void EVP_PKEY_free(EVP_PKEY *x);
 
 
   /* 
    *   Pop off the stack
    */
   char *OPENSSL_sk_pop(STACK *s);
 
   char *OPENSSL_sk_pop(void *s) { return OPENSSL_sk_pop(reinterpret_cast<STACK*>(s)); }
 
 
   /* 
    *   Free the stack
    */
   void OPENSSL_sk_free(STACK *s);
 
   void OPENSSL_sk_free(void *s) { OPENSSL_sk_free(reinterpret_cast<STACK*>(s)); }
 
   /* 
    *  Number of elements in the stack
    */
   int OPENSSL_sk_num(STACK *s);
 
   int OPENSSL_sk_num(void *s) { return OPENSSL_sk_num(reinterpret_cast<STACK*>(s)); }
 
   /* 
    *  Value of element n in the stack
    */
   char *OPENSSL_sk_value(STACK *s, int n);
 
   char *OPENSSL_sk_value(void *s, int n) { return OPENSSL_sk_value(reinterpret_cast<STACK*>(s), n); }
 
   /* 
    *  Create a new stack
    */
   STACK *OPENSSL_sk_new(int (*cmp)());
 
 
   /* 
    *  Add an element to the stack
    */
   int OPENSSL_sk_push(STACK *s, char *d);
 
   int OPENSSL_sk_push(void *s, void *d) { return OPENSSL_sk_push(reinterpret_cast<STACK*>(s), reinterpret_cast<char*>(d)); }
 
   /* 
    *  Duplicate the stack
    */
   STACK *OPENSSL_sk_dup(const STACK *s);
 
   STACK *OPENSSL_sk_dup(const void *s) { return OPENSSL_sk_dup(reinterpret_cast<const STACK*>(s)); }
 
   /*
    *  Convert an ASN1_INTEGER to it's text form
    */
   char *i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, ASN1_INTEGER *aint);
 
 
   /*
    *  Get the certificate's serial number
    */
   ASN1_INTEGER *X509_get_serialNumber(X509 *x);
 
 
   /*
    *  Get the certificate's public key
    */
   EVP_PKEY *X509_get_pubkey(X509 *x);
 
 
   /*
    *  Convert the public key to a decimal form
    */
   int i2d_PublicKey(EVP_PKEY *a, unsigned char **pp); 
 
 
   /*
    *  Check the private key of a PKCS bundle against the X509
    */
   int X509_check_private_key(X509 *x, EVP_PKEY *p);
 
 
   /*
    *  Convert a BIGNUM to a hex string
    */
   char *BN_bn2hex(const BIGNUM *a);
 
 
   /*
    *  Compute the digest of an X.509
    */
   int X509_digest(const X509 *x,const EVP_MD *t, unsigned char *md, unsigned int *len);
 
 
   /*
    *  EVP_md5
    */
   EVP_MD *EVP_md5();
 
 
   /*
    *  ASN1_INTEGER free
    */
   void ASN1_INTEGER_free(ASN1_INTEGER *x);
 
 
   /*
    *  ASN1_STRING_data
    */
   unsigned char *ASN1_STRING_data(ASN1_STRING *x);
 
   /*
    *  ASN1_STRING_get0_data
    */
   const unsigned char *ASN1_STRING_get0_data(const ASN1_STRING *x);
 
   /*
    *  ASN1_STRING_length
    */
   int ASN1_STRING_length(const ASN1_STRING *x);
 
   /*
    *  ASN1_OCTET_STRING_new
    */
   ASN1_OCTET_STRING* ASN1_OCTET_STRING_new();
 
   /*
    *  ASN1_OCTET_STRING_free
    */
   void ASN1_OCTET_STRING_free(ASN1_OCTET_STRING *x);
 
   /*
    *  ASN1_OCTET_STRING_set
    */
   int ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, int len);
 
   /*
    *  
    */
   int OBJ_obj2nid(ASN1_OBJECT *o);
 
   /*
    *  
    */
   const char * OBJ_nid2ln(int n);
 
   /*
    * get the number of extensions
    */
   int X509_get_ext_count(X509 *x);
 
   /*
    * 
    */
   int X509_get_ext_by_NID(X509 *x, int nid, int lastpos);
 
   /*
    *
    */
   int X509_get_ext_by_OBJ(X509 *x,ASN1_OBJECT *obj,int lastpos);
 
   /*
    *
    */
   X509_EXTENSION *X509_get_ext(X509 *x, int loc);
 
   /*
    *
    */
   X509_EXTENSION *X509_delete_ext(X509 *x, int loc);
 
   /*
    *
    */
   int X509_add_ext(X509 *x, X509_EXTENSION *ex, int loc);
 
   /*
    *
    */
   void *X509_get_ext_d2i(X509 *x, int nid, int *crit, int *idx);
 
   /*
    *
    */
   char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, ASN1_OCTET_STRING *ia5);
 
   /*
    *
    */
   int ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
 
   /*
    *
    */
   PKCS7 *PKCS7_new(void);
 
   /*
    *
    */
   void PKCS7_free(PKCS7 *a);
 
   /*
    *
    */
   void PKCS7_content_free(PKCS7 *a);
 
   /*
    *
    */
   int i2d_PKCS7(PKCS7 *a, unsigned char **pp);
 
   /*
    *
    */
   PKCS7 *d2i_PKCS7(PKCS7 **a, unsigned char **pp,long length);
 
   /*
    *
    */
   int i2d_PKCS7_fp(FILE *fp,PKCS7 *p7);
 
   /*
    * 
    */
   PKCS7 *d2i_PKCS7_fp(FILE *fp,PKCS7 **p7);
 
   /*
    *
    */
   int i2d_PKCS7_bio(BIO *bp,PKCS7 *p7);
 
   /*
    *
    */
   PKCS7 *d2i_PKCS7_bio(BIO *bp,PKCS7 **p7);
 
   /*
    *
    */
   PKCS7 *PKCS7_dup(PKCS7 *p7);
 
   /*
    *  Create a PKCS7 signature / signed message
    */
   PKCS7 *PKCS7_sign(X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs,
             BIO *data, int flags);
 
   /*
    *  Verify a PKCS7 signature.
    */
   int PKCS7_verify(PKCS7 *p7, STACK_OF(X509) *certs, X509_STORE *store,
                                              BIO *indata, BIO *out, int flags);
 
   /*
    *  Get signers of a verified PKCS7 signature
    */
   STACK_OF(X509) *PKCS7_get0_signers(PKCS7 *p7, STACK_OF(X509) *certs, int flags);
 
   /*
    *  PKCS7 encrypt message
    */
   PKCS7 *PKCS7_encrypt(STACK_OF(X509) *certs, BIO *in, EVP_CIPHER *cipher,
            int flags);
 
   /*
    *  decrypt PKCS7 message
    */
   int PKCS7_decrypt(PKCS7 *p7, EVP_PKEY *pkey, X509 *cert, BIO *data, int flags);
 
 
   /*
    * Load a CA list file.
    */
   STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file);
 
   /*
    * Load a file of PEM encoded objects.
    */
   STACK_OF(X509_INFO) *PEM_X509_INFO_read(FILE *fp, STACK_OF(X509_INFO) *sk,
                   pem_password_cb *cb, void *u);
 
   /*
    * Get the number of purposes available
    */
   int X509_PURPOSE_get_count();
 
 
   /*
    * Get the ID of a purpose
    */
   int X509_PURPOSE_get_id(X509_PURPOSE *);
 
 
   /*
    * Check the existence of purpose id "id" in x.  for CA, set ca = 1, else 0
    */
   int X509_check_purpose(X509 *x, int id, int ca);
 
 
   /*
    * Get the purpose with index #idx
    */
   X509_PURPOSE * X509_PURPOSE_get0(int idx);
 
 
   /*
    * Create a new Private KEY
    */
   EVP_PKEY* EVP_PKEY_new();
 
 
   /*
    * Get EVP private key type
    */
   int EVP_PKEY_base_id(const EVP_PKEY *pkey);
 
 
   /*
    * Assign a private key
    */
   int EVP_PKEY_assign(EVP_PKEY *pkey, int type, char *key);
 
 
   /*
    * Get RSA key
    */
   RSA *EVP_PKEY_get0_RSA(EVP_PKEY *pkey);
 
 
   /*
    * Get DSA key
    */
   DSA *EVP_PKEY_get0_DSA(EVP_PKEY *pkey);
 
 
   /*
    *  RSA_get0_key - retreive key parameters
    */
   void RSA_get0_key(const RSA *r,
                     const BIGNUM **n, const BIGNUM **e, const BIGNUM **d);
 
 
   /*
    * Generate a RSA key
    */
   RSA *RSA_generate_key(int bits, unsigned long e, void
                        (*callback)(int,int,void *), void *cb_arg);
 
 
   /*
    *  DSA_get0_pqg - retreive key parameters
    */
   void DSA_get0_pqg(const DSA *d,
                     const BIGNUM **p, const BIGNUM **q, const BIGNUM **g);
 
 
   /*
    *  DSA_get0_key - retreive key
    */
   void DSA_get0_key(const DSA *d,
                     const BIGNUM **pub_key, const BIGNUM **priv_key);
 
 
   /*
    * Create/destroy a certificate request
    */
   X509_REQ *X509_REQ_new();
   void X509_REQ_free(X509_REQ *a);
 
 
   /*
    * Set the public key in the REQ object
    */
   int X509_REQ_set_pubkey(X509_REQ *x, EVP_PKEY *pkey);
 
   /* for testing */
   int i2d_X509_REQ_fp(FILE *fp, X509_REQ *x);
 
   /* SMime support */
   STACK *X509_get1_email(X509 *x);
   void X509_email_free(STACK *sk);
 
   /* Ciphers needed for SMime */
   EVP_CIPHER *EVP_des_ede3_cbc();
   EVP_CIPHER *EVP_des_cbc();
   EVP_CIPHER *EVP_rc2_cbc();
   EVP_CIPHER *EVP_rc2_64_cbc();
   EVP_CIPHER *EVP_rc2_40_cbc();
 
   /* clear the current error  - use this often*/
   void ERR_clear_error();
 
   /* retrieve the latest error */
   unsigned long ERR_get_error();
 
   /* Print the errors to this stream */
   void ERR_print_errors_fp(FILE *fp);
 
   /* Get a pointer to the SSL session id (reference counted) */
   SSL_SESSION *SSL_get1_session(SSL *ssl);
 
   /* Frees a pointer to the SSL session id (reference decremented if needed) */
   void SSL_SESSION_free(SSL_SESSION *session);
 
   /* Set the SSL session to reuse. */
   int SSL_set_session(SSL *ssl, SSL_SESSION *session);
 
   /* Decode ASN.1 to SSL_SESSION */
   SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, unsigned char **pp, long length);
   /* Encode SSL_SESSION to ASN.1 */
   int i2d_SSL_SESSION(SSL_SESSION *in, unsigned char **pp);
 
   /* Write privatekey to FILE stream */
   int i2d_PrivateKey_fp(FILE*, EVP_PKEY*);
 
   /* Write PKCS#8privatekey to FILE stream */
   int i2d_PKCS8PrivateKey_fp(FILE*, EVP_PKEY*, const EVP_CIPHER*, char*, int, pem_password_cb*, void*);
 
   /* Free RSA structure */
   void RSA_free(RSA*);
 
   /* Get a blowfish CBC pointer */
   EVP_CIPHER *EVP_bf_cbc();
 
   /* Sign a CSR */
   int X509_REQ_sign(X509_REQ*, EVP_PKEY*, const EVP_MD*);
 
   /* add a name entry */
   int X509_NAME_add_entry_by_txt(X509_NAME*, char*, int, unsigned char*, int, int, int);
 
   /* Create a name */
   X509_NAME *X509_NAME_new();
 
   /* Set the subject */
   int X509_REQ_set_subject_name(X509_REQ*,X509_NAME*);
 
   /* get list of available SSL_CIPHER's sorted by preference */
   STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL* ssl);
 
 
   /* cover KOpenSSLProxy API compatibility */
#if OPENSSL_API_COMPAT < 0x10100000L
#  undef sk_dup
#  undef sk_free
#  undef sk_new
#  undef sk_num
#  undef sk_pop
#  undef sk_push
#  undef sk_value
#  undef X509_STORE_CTX_set_chain
#  undef SSLv23_client_method
#endif
   STACK *sk_dup(const STACK *s) TDE_DEPRECATED;
   void sk_free(STACK *s) TDE_DEPRECATED;
   STACK *sk_new(int (*cmp)()) TDE_DEPRECATED;
   int sk_num(STACK *s) TDE_DEPRECATED;
   char *sk_pop(STACK *s) TDE_DEPRECATED;
   int sk_push(STACK *s, char *d) TDE_DEPRECATED;
   char *sk_value(STACK *s, int n) TDE_DEPRECATED;
   void X509_STORE_CTX_set_chain(X509_STORE_CTX *v, STACK_OF(X509)* x) TDE_DEPRECATED;
   SSL_METHOD *SSLv23_client_method() TDE_DEPRECATED;
 
#endif
 
private:
   KOpenSSLProxy();
   ~KOpenSSLProxy();
   KOpenSSLProxyPrivate *d;
 
   KLibrary *_sslLib;
   KLibrary *_cryptoLib;
   static KOpenSSLProxy *_me;
 
   bool _ok;
};
 
#endif