sslserversocket.h

Go to the documentation of this file.

#ifndef DV_SSL_SSLSERVERSOCKET_H
#define DV_SSL_SSLSERVERSOCKET_H

// $Id: sslserversocket.h,v 1.11 2008/03/15 10:42:25 dvermeir Exp $

#include <stdexcept>
#include <dvssl/sslcontext.h>
#include <dvssl/sslsocket.h>
#include <dvnet/serversocket.h>

namespace Dv { 
  namespace Ssl { 
    /** A class derived from Dv::Net::ServerSocket that uses SSL.
     * Example usage: 
     * @code
     * try { 
     *   Dv::Ssl::ContextV23 context("key.pem","cert.pem"); 
     *   Dv::Ssl::ServerSocket server(context,port); 
     *   
     *   std::cerr << "SSL echo server started.." << std::endl; 
     *   Dv::Util::ref<Dv::Ssl::Socket> client(server.accept()); 
     *   
     *   std::string line; 
     *   while (std::getline(*client, line)) 
     *     *client << line << std::endl; 
     *   std::cout << "client status: " << client->strerror() << std::endl;
     *   return server.error(); 
     * }
     * catch (std::exception& e) { 
     *   std::cerr << e.what() << std::endl;
     *   return 2; 
     * }
     * @endcode
     */ 
    class ServerSocket: public Dv::Net::ServerSocket { 
      public: 
        /** Constructor. 
         * @param context existing Dv::Ssl::Context object, this parameter must
         *   contain both a key file and a certificate file. 
         *   Note that the Dv::Ssl::ServerSocket does not own the context object.
         * @param port on which connections will be accepted
         * @param backlog number of connections allowed in backlog
         * @param address local address to bind to, this is useful
         *   if e.g. you want the server to listen to a specific
         *   network interface, the default (empty string)
         *   will bind to the localhost (INADDR_ANY) interface.
         * @param min_debug_level if a debug_master is connected, logging info
         *   will only be written if the master's level is at least @a min_debug_level
         * @param debug_master from where debug info will be taken
         * @sa Dv::DebugSlave
         * @sa Dv::Net::ServerSocket
         */ 
        ServerSocket(Context& context, int port, int backlog = 10, std::string address="",
            unsigned int min_debug_level = 0, Debugable* debug_master = 0) throw (std::runtime_error); 

        /** Accept a connection from an SSL client.  
         * Delay and bufsz are used for the resulting Socket.
         * The client Dv::Ssl::Socket will be a Dv::DebugSlave of the same debug_master as the
         * Dv::Ssl::ServerSocket.
         * @param delay number of millisecs resulting socket will wait for I/O.  
         * @param bufsz (input and output) buffer size of streambuf associated with resulting socket 
         * @param non_blocking ignored (for compatibility with Dv::Net::ServerSocket::accept)
         */ 
        shared_ptr<Dv::Net::Socket> accept(time_t delay = 0, size_t bufsz=1024,
            bool non_blocking=false);
      private: 
        Context&        context_; 
    }; 
  }
}
#endif

---

dvssl-0.6.1 [15 March, 2008]