anytun: PracticalSocket.h Source File

00001 /*
+00002  *  anytun
+00003  *
+00004  *  The secure anycast tunneling protocol (satp) defines a protocol used
+00005  *  for communication between any combination of unicast and anycast
+00006  *  tunnel endpoints.  It has less protocol overhead than IPSec in Tunnel
+00007  *  mode and allows tunneling of every ETHER TYPE protocol (e.g.
+00008  *  ethernet, ip, arp ...). satp directly includes cryptography and
+00009  *  message authentication based on the methodes used by SRTP.  It is
+00010  *  intended to deliver a generic, scaleable and secure solution for
+00011  *  tunneling and relaying of packets of any protocol.
+00012  *
+00013  *
+00014  *  Copyright (C) 2007 anytun.org <satp@wirdorange.org>
+00015  *
+00016  *  This program is free software; you can redistribute it and/or modify
+00017  *  it under the terms of the GNU General Public License version 2
+00018  *  as published by the Free Software Foundation.
+00019  *
+00020  *  This program is distributed in the hope that it will be useful,
+00021  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+00022  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+00023  *  GNU General Public License for more details.
+00024  *
+00025  *  You should have received a copy of the GNU General Public License
+00026  *  along with this program (see the file COPYING included with this
+00027  *  distribution); if not, write to the Free Software Foundation, Inc.,
+00028  *  59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+00029  */
+00030 
+00031 // this is from: http://cs.ecs.baylor.edu/~donahoo/practical/CSockets/practical/
+00032 // and this is their header:
+00033 /*
+00034  *   C++ sockets on Unix and Windows
+00035  *   Copyright (C) 2002
+00036  *
+00037  *   This program is free software; you can redistribute it and/or modify
+00038  *   it under the terms of the GNU General Public License as published by
+00039  *   the Free Software Foundation; either version 2 of the License, or
+00040  *   (at your option) any later version.
+00041  *
+00042  *   This program is distributed in the hope that it will be useful,
+00043  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+00044  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+00045  *   GNU General Public License for more details.
+00046  *
+00047  *   You should have received a copy of the GNU General Public License
+00048  *   along with this program; if not, write to the Free Software
+00049  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+00050  */
+00051 
+00052 #ifndef __PRACTICALSOCKET_INCLUDED__
+00053 #define __PRACTICALSOCKET_INCLUDED__
+00054 
+00055 #include <string>            // For string
+00056 #include <exception>         // For exception class
+00057 
+00058 using namespace std;
+00059 
+00063 class SocketException : public exception {
+00064 public:
+00071   SocketException(const string &message, bool inclSysMsg = false) throw();
+00072 
+00076   ~SocketException() throw();
+00077 
+00082   const char *what() const throw();
+00083 
+00084 private:
+00085   string userMessage;  // Exception message
+00086 };
+00087 
+00091 class Socket {
+00092 public:
+00096   ~Socket();
+00097 
+00103   string getLocalAddress() throw(SocketException);
+00104 
+00110   unsigned short getLocalPort() throw(SocketException);
+00111 
+00118   void setLocalPort(unsigned short localPort) throw(SocketException);
+00119 
+00128   void setLocalAddressAndPort(const string &localAddress, 
+00129     unsigned short localPort = 0) throw(SocketException);
+00130 
+00144   static void cleanUp() throw(SocketException);
+00145 
+00152   static unsigned short resolveService(const string &service,
+00153                                        const string &protocol = "tcp");
+00154 
+00155 private:
+00156   // Prevent the user from trying to use value semantics on this object
+00157   Socket(const Socket &sock);
+00158   void operator=(const Socket &sock);
+00159 
+00160 protected:
+00161   int sockDesc;              // Socket descriptor
+00162   Socket(int type, int protocol) throw(SocketException);
+00163   Socket(int sockDesc);
+00164 };
+00165 
+00169 class CommunicatingSocket : public Socket {
+00170 public:
+00178   void connect(const string &foreignAddress, unsigned short foreignPort)
+00179     throw(SocketException);
+00180 
+00188   void send(const void *buffer, int bufferLen) throw(SocketException);
+00189 
+00198   int recv(void *buffer, int bufferLen) throw(SocketException);
+00199 
+00205   string getForeignAddress() throw(SocketException);
+00206 
+00212   unsigned short getForeignPort() throw(SocketException);
+00213 
+00214 protected:
+00215   CommunicatingSocket(int type, int protocol) throw(SocketException);
+00216   CommunicatingSocket(int newConnSD);
+00217 };
+00218 
+00222 class TCPSocket : public CommunicatingSocket {
+00223 public:
+00228   TCPSocket() throw(SocketException);
+00229 
+00237   TCPSocket(const string &foreignAddress, unsigned short foreignPort) 
+00238       throw(SocketException);
+00239 
+00240 private:
+00241   // Access for TCPServerSocket::accept() connection creation
+00242   friend class TCPServerSocket;
+00243   TCPSocket(int newConnSD);
+00244 };
+00245 
+00249 class TCPServerSocket : public Socket {
+00250 public:
+00260   TCPServerSocket(unsigned short localPort, int queueLen = 5) 
+00261       throw(SocketException);
+00262 
+00272   TCPServerSocket(const string &localAddress, unsigned short localPort,
+00273       int queueLen = 5) throw(SocketException);
+00274 
+00280   TCPSocket *accept() throw(SocketException);
+00281 
+00282 private:
+00283   void setListen(int queueLen) throw(SocketException);
+00284 };
+00285 
+00289 class UDPSocket : public CommunicatingSocket {
+00290 public:
+00295   UDPSocket() throw(SocketException);
+00296 
+00302   UDPSocket(unsigned short localPort) throw(SocketException);
+00303 
+00310   UDPSocket(const string &localAddress, unsigned short localPort) 
+00311       throw(SocketException);
+00312 
+00318   void disconnect() throw(SocketException);
+00319 
+00330   void sendTo(const void *buffer, int bufferLen, const string &foreignAddress,
+00331             unsigned short foreignPort) throw(SocketException);
+00332 
+00343   int recvFrom(void *buffer, int bufferLen, string &sourceAddress, 
+00344                unsigned short &sourcePort) throw(SocketException);
+00345 
+00351   void setMulticastTTL(unsigned char multicastTTL) throw(SocketException);
+00352 
+00358   void joinGroup(const string &multicastGroup) throw(SocketException);
+00359 
+00365   void leaveGroup(const string &multicastGroup) throw(SocketException);
+00366 
+00367 private:
+00368   void setBroadcast();
+00369 };
+00370 
+00371 #endif
+