X-Git-Url: http://developer.intra2net.com/git/?p=libt2n;a=blobdiff_plain;f=src%2Fsocket_server.hxx;h=e3a4f34c10581ab2809c176ab33774e9a9499960;hp=558b058af3bb059b0f198a8010b49a92f67c352b;hb=cc68aabb16ec32278df8b071c4c9efec7e9f0dce;hpb=a11e19b7adab2d5b937573701959562f06087ac5

diff --git a/src/socket_server.hxx b/src/socket_server.hxx
index 558b058..e3a4f34 100644
--- a/src/socket_server.hxx
+++ b/src/socket_server.hxx
@@ -20,6 +20,7 @@
 #define __LIBT2N_SOCKET_SERVER
 
 #include <sys/types.h>
+#include <string>
 
 #include "server.hxx"
 #include "socket_handler.hxx"
@@ -28,17 +29,30 @@
 namespace libt2n
 {
 
-/**
-    Socket based server class
+class socket_server_connection;
+
+/** @brief Socket based server class
+
+    Use this class to instantiate a server listening for client connections.
+    Call fill_buffer() to read data from the network and get_packet() to retrieve
+    this data. Don't forget to call cleanup() from time to time to remove closed
+    connections and close idle ones.
 */
-class socket_server : public socket_handler, server
+class socket_server : public socket_handler, public server
 {
+    friend class socket_server_connection;
+
     private:
         fd_set connection_set;
         std::string unix_path;
 
+        void start_listening();
+
         void new_connection();
 
+        bool fill_connection_buffers();
+        void remove_connection_socket(int sock);
+
     protected:
         void log(log_level_values level, const std::string& message)
             { log(level,message.c_str()); }
@@ -46,21 +60,19 @@ class socket_server : public socket_handler, server
             { server::log(level,message); }
 
     public:
-        socket_server(int port, const char* ip="0.0.0.0");
-        socket_server(const char* path, mode_t filemode, const char* user="", const char* group="");
+        socket_server(int port, const std::string& ip="0.0.0.0");
+        socket_server(const std::string& path, mode_t filemode=00770, const std::string& user="", const std::string& group="");
 
         ~socket_server();
 
-        void fill_buffer(long long usec_timeout=-1);
-        void fill_connection_buffers();
-
-        void remove_connection_socket(int sock);
+        bool fill_buffer(long long usec_timeout=-1);
 };
 
-/**
-    Socket based connection class
+/** @brief Socket based connection
+
+    This class is used within a socket_server to represent the connection to each client.
 */
-class socket_server_connection : public socket_handler, server_connection
+class socket_server_connection : public socket_handler, public server_connection
 {
     friend class socket_server;
 
@@ -69,15 +81,14 @@ class socket_server_connection : public socket_handler, server_connection
            : server_connection(_timeout), socket_handler(_sock,_stype)
            { }
 
-        void log(log_level_values level, const char* message)
-            { if(my_server) my_server->log(level,message); }
+        void log(log_level_values level, const char* message);
 
         void real_write(const std::string& data)
-            { socket_handler::write(data); }
+            { socket_write(data); }
 
     public:
-        void fill_buffer(long long usec_timeout=-1)
-            { socket_handler::fill_buffer(buffer,usec_timeout); }
+        bool fill_buffer(long long usec_timeout=-1)
+            { return socket_handler::fill_buffer(buffer,usec_timeout); }
 
         void close();
 };