Replace socket_handler::fill_buffer() recursion with loop (#8389)
[libt2n] / src / socket_handler.cpp
index 0082886..0cc5036 100644 (file)
@@ -1,21 +1,24 @@
-/***************************************************************************
- *   Copyright (C) 2006 by Gerd v. Egidy                                   *
- *   gve@intra2net.com                                                     *
- *                                                                         *
- *   This library is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU Lesser General Public License version   *
- *   2.1 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 Lesser General Public License for more details.                   *
- *                                                                         *
- *   You should have received a copy of the GNU Lesser General Public      *
- *   License along with this program; if not, write to the                 *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
- ***************************************************************************/
+/*
+Copyright (C) 2006 by Intra2net AG - Gerd v. Egidy
+
+The software in this package is distributed under the GNU General
+Public License version 2 (with a special exception described below).
+
+A copy of GNU General Public License (GPL) is included in this distribution,
+in the file COPYING.GPL.
+
+As a special exception, if other files instantiate templates or use macros
+or inline functions from this file, or you compile this file and link it
+with other works to produce a work based on this file, this file
+does not by itself cause the resulting work to be covered
+by the GNU General Public License.
+
+However the source code for this file must still be made available
+in accordance with section (3) of the GNU General Public License.
+
+This exception does not invalidate any other reasons why a work based
+on this file might be covered by the GNU General Public License.
+*/
 
 #include <stdio.h>
 #include <errno.h>
@@ -50,10 +53,36 @@ socket_handler::socket_handler(int _sock, socket_type_value _socket_type)
 : sock(_sock)
 , recv_buffer_size( default_recv_buffer_size )
 , write_block_size( default_write_block_size )
+, write_timeout( default_write_timeout )
 , socket_type(_socket_type)
 {
 }
 
+/**
+ * Destructor. Closes open socket
+ */
+socket_handler::~socket_handler()
+{
+    if (sock != -1)
+    {
+        shutdown(sock,SHUT_RDWR);
+        ::close(sock);
+
+        sock = -1;
+    }
+}
+
+/// close the underlying socket connection. Don't call directly, use the version provided
+/// by the connection class you are using.
+void socket_handler::close()
+{
+    LOGSTREAM(debug,"close connection");
+    // graceful shutdown
+    shutdown(sock,SHUT_RDWR);
+    ::close(sock);
+
+    sock = -1;
+}
 
 /// set options like fast reuse and keepalive every socket should have
 void socket_handler::set_socket_options(int sock)
@@ -89,15 +118,6 @@ void socket_handler::set_socket_options(int sock)
         EXCEPTIONSTREAM(error,t2n_communication_error,"fcntl error on socket: " << strerror(errno));
 }
 
-/// close the underlying socket connection. Don't call directly, use the version provided
-/// by the connection class you are using.
-void socket_handler::close()
-{
-    // graceful shutdown
-    shutdown(sock,SHUT_RDWR);
-    ::close(sock);
-}
-
 /// is the underlying socket connection still open?
 bool socket_handler::is_closed()
 {
@@ -126,9 +146,9 @@ void socket_handler::set_recv_buffer_size(unsigned int new_recv_buffer_size)
  * @brief set new size for the data chunks when writeing.
  * @param new_write_block_size the new chunk size.
  *
- * The write block size determines the amound of data which is tried to write
+ * The write block size determines the amount of data which is tried to write
  * to the socket when data needs to be sended.
- * Since writeing data is done in a loop, this does not limit the amunt of data which can
+ * Since writing data is done in a loop, this does not limit the amunt of data which can
  * be written.
  *
  * The value is normalized to be at least 512 bytes and at max 32K bytes.
@@ -139,10 +159,25 @@ void socket_handler::set_write_block_size(unsigned int new_write_block_size)
 } //
 
 
+/**
+ * @brief set new timeout for writing a block
+ * @param new_write_timeout the new timeout in usecs, -1: wait endless
+ *
+ * The write timeout determines the maximum amount of time that is waited
+ * between writing each block. If the timeout is exceeded, write will
+ * throw t2n_transfer_error
+ */
+void socket_handler::set_write_timeout(long long new_write_timeout)
+{
+    write_block_size=new_write_timeout;
+} //
+
+
 /** @brief check if new data is waiting on the raw socket
     @param[in,out] usec_timeout wait until new data is found, max timeout usecs.
             -1: wait endless
             0: return instantly
+    @param[out] usec_timeout_remaining microseconds from the timeout that were not used
 */
 bool socket_handler::data_waiting(long long usec_timeout,long long* usec_timeout_remaining)
 {
@@ -184,11 +219,12 @@ bool socket_handler::data_waiting(long long usec_timeout,long long* usec_timeout
     @param[in,out] usec_timeout wait until new data is found, max timeout usecs.
             -1: wait endless
             0: return instantly
+    @param[out] usec_timeout_remaining microseconds from the timeout that were not used
 */
-bool socket_handler::fill_buffer(std::string& buffer, long long usec_timeout, long long *timeout_remaining)
+bool socket_handler::fill_buffer(std::string& buffer, long long usec_timeout, long long *usec_timeout_remaining)
 {
     // fast path for timeout==0
-    if (usec_timeout==0 || data_waiting(usec_timeout,timeout_remaining))
+    if (usec_timeout==0 || data_waiting(usec_timeout,usec_timeout_remaining))
         return fill_buffer(buffer);
     else
         return false;
@@ -200,59 +236,62 @@ bool socket_handler::fill_buffer(std::string& buffer, long long usec_timeout, lo
 */
 bool socket_handler::fill_buffer(std::string& buffer)
 {
-    bool try_again=false;
-
     char socket_buffer[recv_buffer_size];
 
-    int nbytes = read (sock, socket_buffer, recv_buffer_size);
-    if (nbytes < 0)
+    const int loop_max = 32;            /* limit is 32 * (default) 2048 bytes -> 65536 bytes in one go */
+    int loop_count = 0;
+
+    bool read_something = false;
+    while (loop_count < loop_max)
     {
-        if (errno == EAGAIN)
-            return false;                // no data was waiting
-        else if (errno == EINTR)
+        const int nbytes = read(sock, socket_buffer, recv_buffer_size);
+
+        if (nbytes < 0)
         {
-            // interrupted, try again
-            LOGSTREAM(debug,"EINTR received on read(), trying again");
-            try_again=true;
+            if (errno == EAGAIN)
+                return read_something;                // no (more) data was waiting
+            else if (errno == EINTR)
+            {
+                // interrupted, try again
+                LOGSTREAM(debug, "EINTR received on read(), trying again");
+            } else
+                EXCEPTIONSTREAM(error, t2n_transfer_error, "error reading from socket : " << strerror(errno));
         }
-        else
+
+        // End-of-file
+        if (nbytes == 0)
         {
-            LOGSTREAM(error,"error reading from socket : " << strerror(errno));
-            // TODO: exception?
-            return false;
+            LOGSTREAM(debug, "0 bytes received on read(), closing connection");
+            close();
+            return read_something;
         }
-    }
 
-    // End-of-file
-    if (nbytes == 0 && !try_again)
-    {
-        LOGSTREAM(debug,"0 bytes received on read(), closing connection");
-        close();
-        return false;
-    }
+        // Data read -> store it
+        if (nbytes > 0)
+        {
+            buffer.append(socket_buffer, nbytes);
+            LOGSTREAM(debug, nbytes << " bytes read");
+            read_something = true;
+        }
 
-    // Data read -> store it
-    if (nbytes > 0)
-    {
-        buffer.append(socket_buffer,nbytes);
-        LOGSTREAM(debug,nbytes << " bytes read");
+        // more data waiting -> loop once more (up to loop_max)
+        if (data_waiting(0))
+        {
+            ++loop_count;
+        } else
+        {
+            break;
+        }
     }
 
-    // more data waiting -> recurse
-    if (data_waiting(0))
-        fill_buffer(buffer);
-
-    if (nbytes > 0)
-        return true;
-    else
-        return false;
+    return read_something;
 }
 
 /// writes raw data to the socket. Don't use directly, use the write() function provided by the 
 /// connection because it encapsulates the data.
 void socket_handler::socket_write(const std::string& data)
 {
-    int offset = 0;
+    unsigned int offset = 0;
     while (offset < data.size())
     {
         unsigned int write_size=write_block_size;
@@ -261,35 +300,15 @@ void socket_handler::socket_write(const std::string& data)
             write_size = data.size()-offset;
 
         int rtn;
-        while ((rtn=::write(sock, data.data()+offset, write_size)) &&
-               rtn == -1 && (errno == EAGAIN || errno == EINTR))
+        while ((rtn=::write(sock, data.data()+offset, write_size)) == -1 &&
+               (errno == EAGAIN || errno == EINTR))
         {
-            fd_set write_set[1];
-            fd_set except_set[1];
-            FD_ZERO(write_set);
-            FD_ZERO(except_set);
-            FD_SET(sock, write_set);
-            FD_SET(sock, except_set);
-            // let's wait for the socket to become writable again...
-            //TODO: use a timeout here?
-            int n= ::select(sock+1, NULL, write_set, except_set, NULL);
-            if (n==1 && ! FD_ISSET(sock,write_set) && FD_ISSET(sock, except_set))
-            {
-                // if we are selected but cannot write and have an exception
-                // we have serious trouble...
-                LOGSTREAM(error,"exception on socket; cannot write any more.");
-                //TODO: exception?
-                return;
-            }
+            wait_ready_to_write(sock,write_timeout);
             LOGSTREAM(debug,"resuming write() call after EAGAIN or EINTR");
         }
 
         if (rtn == -1)
-        {
-            LOGSTREAM(error,"write() returned " << strerror(errno));
-            // TODO: exception?
-            return;
-        }
+            EXCEPTIONSTREAM(error,t2n_transfer_error,"write() returned " << strerror(errno));
         else if (rtn != write_size)
         {
             LOGSTREAM(debug,"write() wrote " << rtn << " bytes, should have been "
@@ -306,4 +325,49 @@ void socket_handler::socket_write(const std::string& data)
     return;
 } // eo socket_handler::socket_write(const std::string&)
 
+/// wait until the socket is ready to write again
+void socket_handler::wait_ready_to_write(int socket, long long write_block_timeout)
+{
+    // prepare socket sets
+    fd_set write_set[1];
+    fd_set except_set[1];
+    FD_ZERO(write_set);
+    FD_ZERO(except_set);
+    FD_SET(socket, write_set);
+    FD_SET(socket, except_set);
+
+    // prepare timeout struct
+    struct timeval tval;
+    struct timeval *timeout_ptr;
+
+    if (write_block_timeout == -1)
+        timeout_ptr = NULL;
+    else
+    {
+        timeout_ptr = &tval;
+
+        // convert timeout from long long usec to int sec + int usec
+        tval.tv_sec = write_block_timeout / 1000000;
+        tval.tv_usec = write_block_timeout % 1000000;
+    }
+
+    // let's wait for the socket to become writable again...
+    int rtn;
+    while ((rtn=::select(socket+1, NULL, write_set, except_set, timeout_ptr)) ==-1 && errno == EINTR);
+
+    if (rtn > 0 && (!FD_ISSET(socket,write_set)) && FD_ISSET(socket, except_set))
+    {
+        // if we are selected but cannot write and have an exception
+        // we have serious trouble...
+        EXCEPTIONSTREAM(error,t2n_transfer_error,"exception on socket; cannot write any more.");
+    }
+
+    if (rtn==0)
+        EXCEPTIONSTREAM(error,t2n_transfer_error,"timeout on select() for write");
+
+    if (rtn==-1)
+        EXCEPTIONSTREAM(error,t2n_transfer_error,"cannot select() for write: " << strerror(errno));
+}
+
+
 }