README

   1 INTRODUCTION
   2 ------------
   3
   4 This package provided the Lisp side of the interface to Marc
   5 Battyani's mod_lisp apache module (http://www.fractalconcept.com).
   6
   7 cl-modlisp has cross-implementation support for sockets and
   8 multiprocessing.  This packages maintains a list of listener processes
   9 and sockets as well as worker processes and sockets. cl-modlisp will
  10 cleanly close sockets and kill processes when a listener is stopped.
  11
  12
  13 REREQUISITES
  14 ------------
  15
  16 1. Apache 1.3.x
  17 2. mod_lisp apache module (http://www.fractalconcept.com)
  18 3. kmrcl library (http://files.b9.com/kmrcl)
  19 4. asdf (http://www.sf.net/projects/cclan)
  20
  21
  22 SUPPORTED PLATFORMS
  23 -------------------
  24   Allegro v6.2
  25   Lispworks v4.2
  26   SBCL 0.8.1 with sb-thread (multitasking)
  27   CMUCL 18e
  28
  29
  30 QUICKSTART
  31 ----------
  32
  33 1. The easiest way to install is to use the Debian GNU/Linux operating
  34 system. Using the testing or unstable distributions, you can give the
  35 command:
  36    apt-get install libapache-mod-lisp cl-modlisp cl-kmrcl
  37
  38 If you are not using Debian, you will need to download and install
  39 mod_lisp, cl-modlisp, and cl-kmrcl manually.
  40
  41 2. Add something like the below to httpd.conf and then restart apache
  42       LispServer 127.0.0.1 20123 "localhost"
  43       AddHandler lisp-handler .lsp
  44
  45 3. Start your Lisp implementation and load cl-modlisp with
  46    (asdf:operate 'asdf:load-op 'modlisp)
  47
  48 4. Start the server with
  49       (ml:modlisp-start :port 20123))
  50
  51 5. Try some demostration pages
  52       lynx http://localhost/fixed.lsp
  53       lynx http://localhost/debug.lsp
  54
  55 6. Shutdown the all cl-modlisp servers with
  56      (ml:modlisp-stop-all)
  57
  58
  59 USAGE
  60 -----
  61
  62 Return to the demo.lisp file for some examples of using cl-modlisp.