gssl.h

Go to the documentation of this file.

//
// Copyright (C) 2001-2013 Graeme Walker <graeme_walker@users.sourceforge.net>
// 
// 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 3 of the License, or
// (at your option) any later version.
// 
// This program 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 General Public License for more details.
// 
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
// ===

#ifndef G_SSL_H
#define G_SSL_H

#include "gdef.h"
#include <string>
#include <utility>

namespace GSsl
{
        class Library ;
        class Protocol ;
        class LibraryImp ;
        class ProtocolImp ;
}

class GSsl::Protocol 
{
public:
        typedef size_t size_type ;
        typedef ssize_t ssize_type ;
        enum Result { Result_ok , Result_read , Result_write , Result_error , Result_more } ;
        typedef void (*LogFn)( int , const std::string & ) ;

        explicit Protocol( const Library & ) ;

        Protocol( const Library & , LogFn ) ;

        ~Protocol() ;

        Result connect( int fd ) ;

        Result accept( int fd ) ;

        Result stop() ;

        Result read( char * buffer , size_type buffer_size_in , ssize_type & data_size_out ) ;

        Result write( const char * buffer , size_type data_size_in , ssize_type & data_size_out ) ;

        static std::string str( Result result ) ;

        std::pair<std::string,bool> peerCertificate( int format = 0 ) ;

private:
        Protocol( const Protocol & ) ; // not implemented
        void operator=( const Protocol & ) ; // not implemented

private:
        ProtocolImp * m_imp ;
} ;

class GSsl::Library 
{
public:
        typedef Protocol::LogFn LogFn ;

        Library() ;

        Library( bool active , const std::string & pem_file , unsigned int flags , LogFn = NULL ) ;

        ~Library() ;

        static Library * instance() ;

        bool enabled( bool for_serving = false ) const ;

        static std::string credit( const std::string & prefix , const std::string & eol , const std::string & final ) ;

private:
        Library( const Library & ) ; // not implemented
        void operator=( const Library & ) ; // not implemented
        const LibraryImp & imp() const ;

private:
        friend class GSsl::Protocol ;
        static Library * m_this ;
        LibraryImp * m_imp ;
} ;

#endif