README
1$Id: README,v 1.7 2001/10/04 08:08:34 skimo Exp $
2
3 Copyright (c) 1996 Open Market, Inc.
4 See the file "LICENSE.TERMS" for information on usage and redistribution
5 of this file, and for a DISCLAIMER OF ALL WARRANTIES.
6
7 Copyright (c) 1996-1998 Sven Verdoolaege
8 No additional restrictions/warranties.
9
10This is a Fast CGI module for perl. It's based on the FCGI module
11that comes with Open Market's FastCGI Developer's Kit, but does
12not require you to recompile perl.
13
14It even no longer requires perl to be compiled with sfio.
15To compile with sfio you'll need at least perl 5.003_02 and you'll have
16to have configured it with eg './Configure -Duseperlio -Dusesfio'.
17(See the INSTALL file that comes with the perl distribution.)
18To compile without sfio you'll need an even more recent perl version.
19(perl 5.004 and up should be fine.)
20
21See http://www.fastcgi.com/ for more information about fastcgi.
22Lincoln D. Stein's perl CGI module also contains some information
23about fastcgi programming.
24
25See echo.fpl for an example on how to use this module.
26
27To install, do the usual
28
29perl Makefile.PL
30make
31make install
32
33If you want to use the (experimental) pure perl version, that
34doesn't require a compiler and currently only works on Unix,
35you have to pass the --pure-perl option as in
36"perl Makefile.PL --pure-perl".
37
38Note that the pure version does not support Window's Named Pipes.
39Support for Named Pipes is not a requirement of the FastCGI specification.
40Named Pipes are used by mod_fastcgi and the FastCGI application library as a
41replacement for Unix sockets. mod_fastcgi uses Named Pipes on Windows (Unix
42sockets on Unix) by default (see the mod_fastcgi docs for more information).
43
44If you want the module to use a previously installed fcgi library
45instead of the included files, use the --use-installed option,
46optionally followed by the name of the directory in which it can
47be found.
48
49To configure the library Makefile.PL will run ./configure .
50You may want to run it yourself beforehand because its findings
51may not always be correct.
52The configure.readme file describes how to run ./configure (and only that).
53
54If you're on a solaris system and your installed fcgi library is 2.02b
55or earlier, you'll probably want to use the included files.
56
57The old interface of the FCGI module installs die and warn
58handlers that merely print the error/warning to STDERR (the
59default handlers print directly to stderr, which isn't redirected
60in the non sfio case). I'm not very happy with the result.
61Suggestions welcome.
62
63Sven Verdoolaege
64skimo@kotnet.org
65