perl/README

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