/usr/include/svxlink/AsyncTcpConnection.h is in libasynccore-dev 15.11-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 | /**
@file AsyncTcpConnection.h
@brief Contains a class for handling exiting TCP connections
@author Tobias Blomberg
@date 2003-04-12
This file contains a class to handle exiting TCP connections
to a remote host. See usage instructions in the class definition.
\verbatim
Async - A library for programming event driven applications
Copyright (C) 2003 Tobias Blomberg
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 2 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, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
\endverbatim
*/
#ifndef ASYNC_TCP_CONNECTION_INCLUDED
#define ASYNC_TCP_CONNECTION_INCLUDED
/****************************************************************************
*
* System Includes
*
****************************************************************************/
#include <sigc++/sigc++.h>
#include <stdint.h>
#include <string>
/****************************************************************************
*
* Project Includes
*
****************************************************************************/
#include <AsyncIpAddress.h>
/****************************************************************************
*
* Local Includes
*
****************************************************************************/
/****************************************************************************
*
* Forward declarations
*
****************************************************************************/
/****************************************************************************
*
* Namespace
*
****************************************************************************/
namespace Async
{
/****************************************************************************
*
* Forward declarations of classes inside of the declared namespace
*
****************************************************************************/
class FdWatch;
class IpAddress;
/****************************************************************************
*
* Defines & typedefs
*
****************************************************************************/
/****************************************************************************
*
* Exported Global Variables
*
****************************************************************************/
/****************************************************************************
*
* Class definitions
*
****************************************************************************/
/**
@brief A class for handling exiting TCP connections
@author Tobias Blomberg
@date 2003-12-07
This class is used to handle an existing TCP connection. It is not meant to
be used directly but could be. It it mainly created to handle connections
for Async::TcpClient and Async::TcpServer.
*/
class TcpConnection : public sigc::trackable
{
public:
/**
* @brief Reason code for disconnects
*/
typedef enum
{
DR_HOST_NOT_FOUND, ///< The specified host was not found in the DNS
DR_REMOTE_DISCONNECTED, ///< The remote host disconnected
DR_SYSTEM_ERROR, ///< A system error occured (check errno)
DR_RECV_BUFFER_OVERFLOW, ///< Receiver buffer overflow
DR_ORDERED_DISCONNECT ///< Disconnect ordered locally
} DisconnectReason;
/**
* @brief The default length of the reception buffer
*/
static const int DEFAULT_RECV_BUF_LEN = 1024;
/**
* @brief Translate disconnect reason to a string
*/
static const char *disconnectReasonStr(DisconnectReason reason);
/**
* @brief Constructor
* @param recv_buf_len The length of the receiver buffer to use
*/
explicit TcpConnection(size_t recv_buf_len = DEFAULT_RECV_BUF_LEN);
/**
* @brief Constructor
* @param sock The socket for the connection to handle
* @param remote_addr The remote IP-address of the connection
* @param remote_port The remote TCP-port of the connection
* @param recv_buf_len The length of the receiver buffer to use
*/
TcpConnection(int sock, const IpAddress& remote_addr,
uint16_t remote_port,
size_t recv_buf_len = DEFAULT_RECV_BUF_LEN);
/**
* @brief Destructor
*/
virtual ~TcpConnection(void);
/**
* @brief Set a new receive buffer size
* @param recv_buf_len The new receive buffer size in bytes
*
* This function will resize the receive buffer to the specified size.
* If the buffer size is reduced and there are more bytes in the current
* buffer than can be fitted into the new buffer, an overflow disconnection
* will be issued on the next reception.
*/
void setRecvBufLen(size_t recv_buf_len);
/**
* @brief Disconnect from the remote host
*
* Call this function to disconnect from the remote host. If already
* disconnected, nothing will be done. The disconnected signal is not
* emitted when this function is called
*/
void disconnect(void);
/**
* @brief Write data to the TCP connection
* @param buf The buffer containing the data to send
* @param count The number of bytes to send from the buffer
* @return Returns the number of bytes written or -1 on failure
*/
int write(const void *buf, int count);
/**
* @brief Return the IP-address of the remote host
* @return Returns the IP-address of the remote host
*
* This function returns the IP-address of the remote host.
*/
const IpAddress& remoteHost(void) const { return remote_addr; }
/**
* @brief Return the remote port used
* @return Returns the remote port
*/
uint16_t remotePort(void) const { return remote_port; }
/**
* @brief Check if the connection is established or not
* @return Returns \em true if the connection is established or
* \em false if the connection is not established
*/
bool isConnected(void) const { return sock != -1; }
/**
* @brief Check if the connection is idle
* @return Returns \em true if the connection is idle
*
* A connection being idle means that it is not connected
* NOTE: This function is overridden in Async::TcpClient.
*/
bool isIdle(void) const { return sock == -1; }
/**
* @brief A signal that is emitted when a connection has been terminated
* @param con The connection object
* @param reason The reason for the disconnect
*/
sigc::signal<void, TcpConnection *, DisconnectReason> disconnected;
/**
* @brief A signal that is emitted when data has been received on the
* connection
* @param buf A buffer containg the read data
* @param count The number of bytes in the buffer
* @return Return the number of processed bytes
*
* This signal is emitted when data has been received on this connection.
* The buffer will contain the bytes read from the operating system.
* The slot must return the number of bytes that has been processed. The
* bytes not processed will be stored in the receive buffer for this class
* and presented again to the slot when more data arrives. The new data
* will be appended to the old data.
*/
sigc::signal<int, TcpConnection *, void *, int> dataReceived;
/**
* @brief A signal that is emitted when the send buffer status changes
* @param is_full Set to \em true if the buffer is full or \em false
* if a buffer full condition has been cleared
*/
sigc::signal<void, bool> sendBufferFull;
protected:
/**
* @brief Setup information about the connection
* @param sock The socket for the connection to handle
*
* Use this function to set up the socket for the connection.
*/
void setSocket(int sock);
/**
* @brief Setup information about the connection
* @param remote_addr The remote IP-address of the connection
*
* Use this function to set up the remote IP-address for the connection.
*/
void setRemoteAddr(const IpAddress& remote_addr);
/**
* @brief Setup information about the connection
* @param remote_port The remote TCP-port of the connection
*
* Use this function to set up the remote port for the connection.
*/
void setRemotePort(uint16_t remote_port);
/**
* @brief Return the socket file descriptor
* @return Returns the currently used socket file descriptor
*
* Use this function to get the socket file descriptor that is currently
* in use. If it is -1 it has not been set.
*/
int socket(void) const { return sock; }
private:
IpAddress remote_addr;
uint16_t remote_port;
size_t recv_buf_len;
int sock;
FdWatch * rd_watch;
FdWatch * wr_watch;
char * recv_buf;
size_t recv_buf_cnt;
void recvHandler(FdWatch *watch);
void writeHandler(FdWatch *watch);
}; /* class TcpConnection */
} /* namespace */
#endif /* ASYNC_TCP_CONNECTION_INCLUDED */
/*
* This file has not been truncated
*/
|