AUTHOR Sasha Pachev <sasha@sashanet.com> ABOUT libtcp++ is a free C++ class library to facilitate writing TCP/IP client-server applications written and maintained by Sasha Pachev <sasha@sashanet.com> REQUIREMENTS a C++ compiler on a Unix platform with STL support to the exent of GCC 2.7, a reasonably recent version GCC itself is the best compiler to compile it on. The library will cleanly compile on Linux and BSD with g++. Other configurations have not yet been tested. You may need to change a few lines to make it work on another platform/compiler. Please let me know what you did to make it work in that case. VERSION 0.1.0 INSTALL gunzip -c libtcp++*.tar.gz | tar xvf - cd libtcp++-* ./configure make su make install USAGE #include <tcp++/tcp_client.h> #include <tcp++/tcp_server.h> to link use -ltcp++ The use of the client should be pretty obvious from the header file and the test example in tcp_client.cc The same applies to the server (see tcp_server.cc ), but one thing requires explanation: to write your own server, inherit from TcpServer and implement handle_client(int sock_fd) the server will listen on the port specified in the constructor and fork when connection is made calling your implementation of handle_client() see source for more details To use IP access control, after instantiating TcpServer call add_ip_rule(netnum, netmask) of each rule. Use netmask of 255.255.255.255 for a single host, and its IP for netnum. Both netnum and netmask are C string representations of IP addresses/masks, not the 4-byte arrays. They will be parsed by inet_aton(). After setting up all the rules with add_ip_rule(), activate them with enable_access_control(). After you have called enable_access_control() all connections will be denied except those coming from host that match one of the rules you have added. You can disable it with disable_access_control() HISTORY 0.0.1 - Mar 10, 1999 first release 0.0.1a - Mar 11, 1999 fixed the log messages flushing problem 0.0.1b - Mar 16, 1999 fixed the block on wait3() when some client handler child had exited and others had not by fixing the loop in reaper() in tcp_server.h 0.0.1c - Mar 23, 1999 - added debug() method to TCP Server 0.0.2 - added IP-based access control capability to the TcpServer through a new class TcpIpRuleSet, which could be used independently of TcpServer to validate an IP address against a set of rules. 0.0.4 - Oct 24, 1999 added connect timeout for TcpClient, TcpClient::receive() has a now configurable a timeout (0 sec 0 usec means no timeout), renamed .c files to .cc, added setsockopt with SO_REUSEADDR on the server socket, added socklen_t to make it compile on RedHat 6.0 and some others without warnings where this is the type of the last argument to accept(). 0.0.5 - Nov 10, 1999 - added init() methods and no-arguments constructor to TcpClient, now you can initialize a TcpClient by just supplying the host's struct in_addr and the port to connect on -- details in the tcp_client.h . 0.1.0 - Nov 15, 1999 -- finally converted to autoconf/automake 0.1.1 - Jan 23, 2000 -- fixed a bug in configure that made the compilation bomb on Red Hat 6.1 BUGS report them to Sasha Pachev <sasha@sashanet.com> TO DO - Test, test, test - documentation LICENSE You may use and modify the code as long as proper credit is given. As with all freeware, I assume no legal responsibility for any damage that may result from the use of libtcp++
