FastCGI Developer's Kit README
------------------------------
- Version 2.0b2, 04 April 1997
- $Id: README,v 1.6 1999/07/26 04:45:52 roberts Exp $
+ $Id: README,v 1.24 2004/01/31 17:47:06 robs Exp $
Copyright (c) 1996 Open Market, Inc.
See the file "LICENSE.TERMS" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.
Basic Directions
----------------
-Open the kit's index page, index.html in this directory, using the
-"Open File" command in your Web browser. The index page gives you an
-overview of the kit structure and helps you navigate the kit. The
-index page also contains links that run some example applications, but
-the applications won't work when index.html is opened using the "Open
-File" command because they aren't being accessed through a Web server.
+Unix:
-For further instructions see the FastCGI Developer's Kit
-document, accessible via the index page.
+ ./configure
+ make
+ make install
+Win32:
-TODO:
-----
-The following is a small list of what should be available in the final
-release of the FDK.
- 1. Fix all compilation problems on all Unixes and NT.
- 2. Provide perl.c for perl5.003 (replace run() with runops())
- 3. Provide latest Tcl patches (NT requires Tcl7.5+)
- 4. Provide FCGI_VERSION directive for automatic version recognition.
--- if available
- 5. Provide new Java interface to conform to JDK1.1.1 (due to final
- System.in)
- 6. Provide samples of Perl on NT.
+ nmake -f Makefile.nt
+ (or use the MSVC++ project files in the Win32 directory)
-Changes with devkit 2.1.1
+
+CHANGES
+-------
+
+For more detail regarding changes, please consult the cvs log available
+on http://fastcgi.com/.
+
+2.4.1
+-----
+
+ *) [WIN32] Raise SIGTERM from the ShutdownRequestThread to emulate
+ the Unix behaviour. Dan [mail@daniel-albert.de]
+
+ *) Fix fcgi_streambuf::underflow() such that when there is no buffer
+ the character isn't removed. AIDA Shinra <shinra@j10n.org>
+
+ *) Add attach() and detach() support.
+
+
+2.4.0
+-----
+
+ *) When closing connections, shutdown() the send side of TCP sockets to
+ prevent a TCP RST from trashing the reciept of data on the client (when
+ the client continues to send data to the application).
+
+ *) [WIN32] force an exit from the ShutdownRequestThread when a shutdown is
+ signaled and NamedPipes are in use.
+
+ *) Use streamsize and char_type in the C++ API.
+
+ *) [WIN32] Eliminate the (partial and broken) use of OverlappedIO - this
+ was causing a loose spin in acceptNamedPipe().
+
+ *) Fix a bug that caused an assert to pop when an async file descriptor was
+ numbered greater than 16. Kevin Eye [eye@buffalo.edu]
+
+ *) Update the echo-cpp example to show the restoral of the original
+ streambufs. Trub, Vladimir [vtrub@purolator.com]
+
+ *) Fix a bug a that caused the lib to crash under certain circumstances
+ when an error occured on a read
+
+ *) Test for iostreams that support a streambuf assigment operator
+
+ *) (WIN32) Fixed initialization of the accept mutex when OpenSocket() was used.
+ Niklas Bergh [niklas.bergh@tific.com]
+
+
+2.2.2
+-----
+
+ *) Added support for shared libraries.
+
+ *) Added support for a graceful shutdown via an event under Win32.
+
+ *) Added default signal handlers for PIPE, USR1, and TERM.
+
+ *) Fix some minor bugs in the 0S_ layer.
+
+ *) Fixed the C++ streambuf implementation.
+
+
+Changes with devkit 2.1.1
-------------------------
+ *) Fixed an unintentional sign extension during promotion in Java's
+ FCGIInputStream.read(). Takayuki Tachikawa <tachi@po.ntts.co.jp>
+
+ *) Cleaned up warnings in examples (mostly main() complaints).
+
+ *) Removed examples/tiny-cgi.c (it wasn't a FastCGI application?!).
+
*) Remove some debugging code and clean up some gcc warnings in cgi-fcgi.c.
*) Add multithread support to the fcgiapp lib and an example multithreaded
- application, threaded.c. Based on work by Dennis Payne
+ application, threaded.c. Based on work by Dennis Payne
<dpayne@softscape.com> and Gene Sokolov <hook@aktrad.ru>.
*) Remove the printf() and #include of stdio.h from examples/echo2.c.