This directory contains the source for the C++ socket library
Version: 12Jan1997 1.11

Manifest:
--------
	README.....................this file
	configure config.h.in, Makefile.in, acconfig.h
        configure.in...............configuring files
	sockstream.h...............contains sockbuf, sockAddr, isockstream,
				   osockstream, iosockstream class
				   declarations
	sockstream.C...............related to sockstream.h
	pipestream.h...............contains ipipestream, opipestream, and
				   iopipestream class definitions. They are
				   used instead of pipe and socketpair system
				   calls and popen C library function call.
	pipestream.C...............related to pipestream.h
	sockinet.h.................contains sockinetbuf, sockinetaddr classes.
			           It also contains the definitions of
				   isockinet, osockinet, and iosockinet stream
				   classes.
	sockinet.C.................related to sockinet.h
	sockunix.h.................contains sockunix, sockunixaddr classes.
				   It also contains the definitions of
				   isockunix, osockunix, and iosockunix stream
				   classes.
	sockunix.C.................related to sockunix.h

	Fork.h.....................wrapper class for fork () system call.
        sig.h......................wrapper class Unix signals.

	protocol.h, protocol.C.....base class for application protocols.
	echo.h, echo.C.............Echo application protocol class.
	smtp.h, smtp.C.............SMTP application protocol class.
	ftp.h, ftp.C...............FTP application protocol class.

	socket++.texi..............texinfo file for libsocket++.a

	./test
	------
	tdunread.cc, tdunwrite.cc..test files for datagram unix sockets
	tdinread.cc, tdinwrite.cc..test files for datagram inet sockets
	tsunread.cc, tsunwrite.cc..test files for stream unix sockets
	tsinread.cc, tsinwrite.cc..test files for stream inet sockets
	tpipe.cc...................test file for pipe system call
	tsockpair.cc...............test file for sockpair system call
	tpopen.cc, tpopentest.cc...test files for popen function
	testall.cc.................runs all the above tests
	testall.exp................correct output of testall

	tnntp.cc, tsmtp.cc, twhois.cc
	tsendfiles.cc, thostnames.cc...........Some more examples


Copyright Notice:
----------------
Copyright (C) 1992-1996 Gnanasekaran Swaminathan <gs4t@virginia.edu>

Permission is granted to use at your own risk and distribute this software
in source and  binary forms provided  the above copyright notice and  this
paragraph are  preserved on all copies.  This software is provided "as is"
with no express or implied warranty.

Installation Note:
-----------------
This software has been tested in sun4 running SunOs4.1.3 machine only.
If you are having problems with any aspect of socket++, please
email me at gs4t@virginia.edu. We can fix it together.

This software works with proposed C++ standard iostream library. Thus
if you are using libg++, you need at least libg++-2.7.2.

Your C++ compiler should be able to handle C++ exceptions and templates.
Thus if you are using G++, you need at least gcc-2.7.2.

socket++.texi needs at least texinfo-2.16.

Gcc, libg++, and texinfo are all available for anonymous ftp from
	prep.ai.mit.edu:/pub/gnu

	cd socket++-1.11
	env CCC=c++ ./configure --prefix="your favorite location"
	make           
	cd test
	make check     

If you are using a compiler that is invoked by a command other than c++, 
use that command instead on CCC=c++ in the above.

Testing:
-------
make check will automatically run testall.

You can also manually test as follows:
	./testall > testall.out
	diff -c testall.out testall.exp
If there are any differences, manually check whether 
testall.out and testall.exp have the same lines but only their
order is different. If they have the same lines but
for the order, you have installed properly. Otherwise,
try to findout what might be the reason and if you couldn't
please email me with your problem at gs4t@virginia.edu.

Bug reports:
-----------
Send them to me at gs4t@virginia.edu

News:
----

12Jan97 1.11
  . This release brings back error handling through the use of
    exceptions. I have not included any other enhancements in
    this release. 
  . Document is out-of-date. I will work on it in the next release.
  . class sig is added. It is useful for handling signals.

17Oct95 1.10
  . Made to work cleanly in RS6000 machines
  . Bug fixes sent in by Blair incorporated.

07Aug95 1.9
  . Exceptions dropped as many compilers do not support
    it yet. A number of small bug fixes.
  . Made to work with libg++-2.7.0 and gcc-2.7.0
  . Configuration simplified greatly by Blair.

15Jan95 1.8
  . Error handling greatly enhanced through the use
    of exceptions.
  . FTP class added.

08Nov94 1.7
  . First stable version. Known to work in sunos4, aix3.2,
    hpux, ultrix, linux, and osf2.
 
Acknowledgements:
----------------
Gordon Joly <G.Joly@cs.ucl.ac.uk> for reporting bugs in
pipestream class implementation. He also knows how to make
the socket++ library a shared library. 

Jim Anderson for reporting a bug in sockinet.C

Carl Gay <cgay@skinner.cs.uoregon.edu> for reporting a bug
and a fix in sockinet.C

Oliver Imbusch <flabes@parystec.de> for reporting a bug
in Makefile.in and suggesting several enhancements for sockbuf class.

Dierk Wendt <wendt@lambda.hella.de> for reporting errors
in the socket++ documentation.

Christian Schlichtherle <s_schli@ira.uka.de> for sending
patches for linux support.

Ed Martini <emartini@netcom.com> and taylor d fraley <taylor@mik.uky.edu>
sent in some more linux fixes.

Dan R. Greening <greening@zuni.chaco.com> for a fix in sockstream.h

Mike Christiansen for sending patches for hpux support and
memory leaks. He used purify to check for memory leaks.

Nanlin Xiao <nxiao@eng.tridom.com> for sending fixes
to compile under Objectcenter C++ compiler.

Solaris support is still weak, and thus the names
of people who helped to port to solaris is not listed
here yet.

V. Olshevsky <ovg@nusun.jinr.dubna.su> for catching sequence
point bugs in tdinwrite.C.

Blair Zajac <blair@olympia.gps.caltech.edu> provided the autoconfig
files and Makefile.ins needed to generate the configure and Makefiles
and a number of bug fixes.

Enjoy!

-Sekar

Gnanasekaran Swaminathan (gs4t@virginia.edu)
CSIS Lab. Dept. of Elec. Eng.
University of Virginia
Charlottesville VA 22903