Tcl-Fastcgi README FastCGI interface for Tcl 8.3 and up Copyright 1998-2004 Tom Poindexter, all rights reserved firstname.lastname@example.org Tcl-Fastcgi is distributed under a "BSD" style license. See the file 'LICENSE.TERMS' for details. WHERE TO GET IT http://sf.net/projects/tcl-fastcgi see http://www.nyx.net/~tpoindex for web info WHAT IS Tcl-Fastcgi? Tcl-Fastcgi is a Tcl interface for the FastCGI protocol. Fcgi.tcl is designed to work with Tcl 8.3 and up. Tcl-Fastcgi comes in two flavors: -- a Tcl source version which is written in 100% pure Tcl, optionally using the Extended Tcl (TclX) extension for certain types of FastCGI connections. -- a Tcl C extension version, which uses library code from the FastCGI Developer's kit. Each flavor provides the same programming interface for application programs. See the file INSTALL for more information about the two flavors. FastCGI is a protocol to allow CGI-style programs to be started as a server, avoiding the CGI overhead of process creation and program loading. FastCGI servers can be run on the same machine as your web server, or run on different machines. For more details on FastCGI, see: http://www.fastcgi.com http://fastcgi.idle.com The FastCGI developer's kit (www.fastcgi.com) contains interfaces for Tcl 7.4. Unfortunately, that interface have never been updated for newer versions of Tcl. Tcl-Fastcgi was written to keep up with the lastest Tcl releases. REQUIREMENTS: Tcl 8.3 or Tcl 8.4 http://www.scriptics.org FastCGI Developer's kit fcgi-2.4.0.tar.gz or newer, is required to build the C extension flavor: http://fastcgi.idle.com/fcgi2.0b2.1.tar.gz http://www.fastcgi.com/applibs/2.0.0/fcgi-devel-kit.tar.Z A Web server supporting the FastCGI protocol: Apache 1.2.x or higher, using the mod_fastcgi 2.0.9 module http://www.apache.org http://www.fastcgi.com http://fastcgi.idle.com also see 'mod_apache1.2.5.pat' NCSA 1.5 /w FastCGI support http://hoohoo.ncsa.uiuc.edu http://www.fastcgi.com/servers/ncsa/ Netscape /w FastCGI support http://home.netscape.com http://fastserv.name.net Open Market Web Server http://www.openmarket.com Stronghold Web Server http://www.c2.net/ Bluestone Sapphire/Web Server http://www.bluestone.com (or any other server that supports FastCGI) Highly Recommended: cgi.tcl - The fine CGI support package by Don Libes. I can't say enough good things about this package. If you're writing CGI in Tcl, you need this! http://expect.nist.gov/cgi.tcl or ncgi.tcl - from the Tcllib http://tcllib.sf.net ** Tcl-fastcgi has only been tested with: Apache 2.0.48, with mod_fastcgi 2.4.0 under Windows. Please mail me on using Tcl-fastcgi with other servers, and I'll add to this list. INSTALLATION See the file INSTALL. Quickie version: ./configure --prefix=/same/as/tcl; make install-tcl-src DOCUMENTATION See the man page for Tcl-fastcgi, and the NOTES file. Html, text, and Postscript versions of the man page are in ./doc KNOWN BUGS I've only tested Tcl-fastcgi in the role of RESPONDER. Other FastCGI roles include AUTHORIZER and FILTER. Please let me know if you use either of these roles. MAILING LIST A mailing list is active for FastCGI issues. Go to http://fastcgi.com/fastcgi-developers BUG REPORTS, FIXES, COMMENTS, & SUGGESTIONS Please mail to me at: email@example.com Please be sure to identify which flavor of tcl-fastcgi you are using! And any other relevant information such as web server, etc.