Home

C-Bits Package Documentation

Project Page

---

           

---

SSLSocket.h

Go to the documentation of this file.

/* ====================================================================
 *              The CBITS Software License, Version 1.0
 *
 *               Copyright (c) 2002-2003 Bruce Lowery
 *                       All rights reserved
 *
 * Redistribution and use of this software, in source and binary forms, 
 * with or without modification, are permitted provided that the above 
 * copyright notice, this paragraph, and the following paragraph are 
 * retained in each source code file.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL BRUCE LOWERY OR OTHER CONTRIBUTORS 
 * TO THE CBITS LIBRARY BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 */
#ifndef __SSLSOCKET_H__
#define __SSLSOCKET_H__

// CBits Socket
#include <cbits/Socket.h>
#include <cbits/SSLContext.h>
#include <cbits/SocketException.h>
#include <cbits/SocketException.h>

// OpenSSL
#include <openssl/bio.h>
#include <openssl/err.h>
#include <openssl/rand.h>
#include <openssl/ssl.h>


namespace cbits {

class SSLPeer;

class EXPORT SSLSocket : public virtual Socket
{

public:

    SSLSocket
    ( 
        const std::string& host, 
        const int port,          
        SSLContext* const ctxt=0, 
        const bool now=true      
    )
        throw( SocketException );


    SSLSocket
    ( 
        const char *host,         
        const int port,           
        SSLContext* const ctxt=0, 
        const bool now=true       
    )
        throw( SocketException );


    virtual ~SSLSocket();


    virtual void  connect()  throw(SocketException);

    virtual const ssize_t read
    ( 
        char * const buffer,
        const int buflen, 
        int * const error=0, 
        const long int msec=0 
    )
        throw( SocketException );


    virtual const ssize_t receive
    ( 
        char * const buffer, 
        const int buflen, 
        const long int msec=0, 
        int * const error=0
    )
        throw( SocketException );


    virtual const ssize_t readLine
    (
        std::string& buffer, 
        const std::string& delim, 
        int * const error=0, 
        const long int msec=0 
    )
            throw( SocketException );


    virtual  const  ssize_t  write
    (
        const char * buffer, 
        const long buflen,
        int * const error=0, 
        const long int msec=0 
    )
        throw( SocketException );


    virtual  const  ssize_t  send
    (
        const char * buffer, 
        const long buflen,
        int * const error=0, 
        const long int msec=0 
    )
        throw( SocketException );


    static SSLSocket* create
    (
        const socket_t fd,        
        SSLContext* const ctxt=0  
    )
        throw( SocketException );


    static void setGlobalContext
    (
        SSLContext* gctx  
    )
        throw( SSLContextException );



    const SSLPeer& getPeer() const
        throw( SocketException );


    typedef SSL* SSL_PTR;


    inline operator SSL_PTR() { return _ssl; }


protected:

    SSLSocket
    ( 
        const socket_t fd,        
        SSLContext* const ctxt=0  
    )
        throw( SocketException );

    // FIXME SSLSocket.h remove unused get_bio() declaration
    // BIO* get_bio();


    bool _ssl_is_connected;


private:

    void set_bio
    ( 
        const socket_t fd  
    )
        throw( SocketException );

    BIO*        _bio;


    SSLContext* _ctxt;


    SSL*        _ssl;


    SSLPeer*    _peer;


    mutable CriticalSection _csect;


    mutable CriticalSection _read_csect;


    mutable CriticalSection _write_csect;


    static SSLContext* _global_ctxt;
};

// TO DO:
// 1.  Certificate Revocation List handling
// 2.  Post Connection Assertions
// 3.  x
};
#endif


/*
 * $Id: SSLSocket.h,v 1.5 2002/10/16 22:32:44 brulow Exp $
 * 
 * History: (Add nothing manually below)
 * -----------------------------------------------------------------------
 *
 * $Log: SSLSocket.h,v $
 * Revision 1.5  2002/10/16 22:32:44  brulow
 * Improve doc, misc
 *
 * Revision 1.4  2002/10/10 01:16:22  brulow
 * Improve documentation
 *
 * Revision 1.3  2002/10/09 22:43:03  brulow
 * Improve documentation
 *
 * Revision 1.2  2002/09/27 22:04:16  brulow
 * Add history footer to all .h .cpp files
 *
 *
 */

---

Generated by

Hosted by