1 /***************************************************************************
2 * Copyright (C) 2006 by Gerd v. Egidy *
5 * This library is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU Lesser General Public License version *
7 * 2.1 as published by the Free Software Foundation. *
9 * This library is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12 * GNU Lesser General Public License for more details. *
14 * You should have received a copy of the GNU Lesser General Public *
15 * License along with this program; if not, write to the *
16 * Free Software Foundation, Inc., *
17 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
18 ***************************************************************************/
19 #ifndef __LIBT2N_SOCKET_CLIENT
20 #define __LIBT2N_SOCKET_CLIENT
23 #include "socket_handler.hxx"
29 /** @brief a connection from client to server using sockets.
31 Use this class to connect from a client to a server.
33 class socket_client_connection : public client_connection, public socket_handler
36 static const int max_retries_default=3;
37 static const long long connect_timeout_usec_default=30000000;
40 void real_write(const std::string& data)
41 { socket_write(data); }
43 void tcp_connect(int max_retries);
44 void unix_connect(int max_retries);
45 void connect_with_timeout(struct sockaddr *sock_addr,unsigned int sockaddr_size);
48 long long connect_timeout_usec;
54 std::string lastErrorMsg;
58 std::ostream* get_logstream(log_level_values level)
59 { return client_connection::get_logstream(level); }
62 socket_client_connection(int _port, const std::string& _server="127.0.0.1",
63 long long _connect_timeout_usec=connect_timeout_usec_default,
64 int _max_retries=max_retries_default,
65 std::ostream *_logstream=NULL, log_level_values _log_level=none);
66 socket_client_connection(const std::string& _path,
67 long long _connect_timeout_usec=connect_timeout_usec_default,
68 int _max_retries=max_retries_default,
69 std::ostream *_logstream=NULL, log_level_values _log_level=none);
71 ~socket_client_connection();
73 /** @brief read data from the socket and copy it into buffer
74 @param usec_timeout wait until new data is found, max timeout usecs.
77 @param usec_timeout_remaining if non-NULL the function will write the
78 not used time to the given target
79 @retval true if new data was found (does not mean that the received data
80 is a complete packet though)
82 bool fill_buffer(long long usec_timeout=-1, long long *usec_timeout_remaining=NULL)
83 { return socket_handler::fill_buffer(buffer,usec_timeout,usec_timeout_remaining); }
89 std::string get_last_error_msg(void)
90 { return lastErrorMsg; }