cl-modlisp Documentation

Overview

cl-modlisp provides the Lisp side of the interface to Marc Battyani's mod_lisp apache module (http://www.fractalconcept.com).

Features

• support of AllegroCL, CMUCL, SBCL with sb-thread, and Lispworks.
• listener and worker socket/process management so that shutting down the listener closes all related open sockets and terminates all related proceses.
• support for running multiple command processors on multiple ports.
• transparent support for precomputing the HTML or XML response to take advantage of HTTP/1.1's Keep-Alive feature. This is switchable with a single keyword argument to the macro with-ml-page.
• Demonstration processor included

Prerequisites

• Apache 1.3.x
• mod_lisp apache module (http://www.fractalconcept.com).
• kmrcl library (http://files.b9.com/kmrcl).
• asdf (http://www.sf.net/projects/cclan).

Supported Platforms

• Allegro v6.2
• CMUCL 18e
• Lispworks v4.2
• SBCL 0.8.1 with sb-thread (multi-threading)

Quickstart

• The easiest way to install is to use the Debian GNU/Linux operating system. Using the testing or unstable distributions, you can give the command:

  apt-get install libapache-mod-lisp cl-modlisp cl-kmrcl

  If you are not using Debian, you will need to download and install mod_lisp, cl-modlisp, and cl-kmrcl manually.

• Add something like the below to httpd.conf and then restart apache
  LispServer 127.0.0.1 20123 "localhost"
  AddHandler lisp-handler .lsp
• Start your Lisp implementation and load cl-modlisp with
  (asdf:operate 'asdf:load-op 'modlisp)
• Start the server with
  (ml:modlisp-start :port 20123)
• Try some demostration pages
  links http://localhost/fixed.lsp
  links http://localhost/debug.lsp
• Shutdown the all cl-modlisp servers with
  (ml:modlisp-stop-all)

Usage

The demo.lisp file for some examples of using cl-modlisp.