Minor fixups
[catagits/fcgi2.git] / perl / README
CommitLineData
794c66be 1$Id: README,v 1.4 2000/04/21 18:10:53 skimo Exp $
1b64d24d 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.
15The sfio version has had more testing though.
16To compile with sfio you'll need at least perl 5.003_02 and you'll have
17to have configured it with eg './Configure -Duseperlio -Dusesfio'.
18(See the INSTALL file that comes with the perl distribution.)
19To compile without sfio you'll need an even more recent perl version.
20(perl 5.004 and up should be fine.)
21
794c66be 22See http://www.fastcgi.com/ for more information about fastcgi.
1b64d24d 23Lincoln D. Stein's perl CGI module also contains some information
24about fastcgi programming.
25
26See echo.fpl for an example on how to use this module.
27
28To install, do the usual
29
30perl Makefile.PL
31make
32make install
33
34If Makefile.PL finds an already installed (exported) fcgi library
35it will use that instead of the included files. Edit Makefile.PL
36if you don't want that or if it doesn't find them.
37
38To configure the library Makefile.PL will run ./configure .
39You may want to run it yourself beforehand because its findings
40may not always be correct.
6ef7789b 41The configure.readme file describes how to run ./configure (and only that).
1b64d24d 42
43If you're on a solaris system and your installed fcgi library is 2.02b
44or earlier, you'll probably want to use the included files.
45
d2900ee8 46The old interface of the FCGI module installs die and warn
47handlers that merely print the error/warning to STDERR (the
48default handlers print directly to stderr, which isn't redirected
49in the non sfio case). I'm not very happy with the result.
50Suggestions welcome.
1b64d24d 51
52Sven Verdoolaege
53skimo@kotnet.org