[new location for stuff dan**19991228183311 new location for stuff new installation instructions ] { hunk ./doc/index.html 2 - + hunk ./doc/index.html 8 -

Araneida is the third version of a small extensible CL-based web -server that I wrote as a project to learn CL. That's a -circumlocutious way to say that it may not be a really great body of -code to learn Lisp style from. +

Araneida is a small extensible CL-based web server, originally +written as a project to learn CL. That's a circumlocutious way to say +that it may not be a really great body of code to learn Lisp style +from. hunk ./doc/index.html 15 -

  • Free - BSD-without-advertising license, but for the modification -that I'm not the Regents of the University of California +
  • Free - BSD-sans-advertising licence, but +for the modification that I'm not the Regents of the University of California hunk ./doc/index.html 18 -
  • Single-threaded, but (new in 0.3) uses the CMCUL event loop so -you probably won't notice much +
  • Does not use multiple threads. Hooks into the CMUCL event loop so +for many purposes it behaves as though it does. hunk ./doc/index.html 26 -
  • Cheesy HTML-from-sexpr generation function makes balancing </td> -tags suddenly trivially simple +
  • Cheesy HTML-from-sexpr generation function makes balancing +</td> +tags suddenly trivially simple (if tending to generate lots of +short-lived garbage) hunk ./doc/index.html 39 + +
  • Willingness to grapple with ipfw/ipchains to +prevent external access to tcp/8000 + hunk ./doc/index.html 48 -

    Here +

    hunk ./doc/index.html 63 -programs, afaics. I tend to take the view that exposing people to the +programs, AFAICS. I tend to take the view that exposing people to the hunk ./doc/index.html 65 -up in shell scripts that don't work on anyone else's system. So, -installation takes a bit of fiddling. +up in shell scripts that don't work on anyone else's system. So, +installation takes a bit of fiddling and it helps if you've used +mk-defsystem before. + hunk ./doc/index.html 75 -
  • In the examples/ directory, copy -loaclhost-telent-net.lisp to the appropriate name for your computer: -usually this is the FQDN with #\. replaced by #\_) but if you -get the wrong name it will stop and ask when you try to build the thing. +
  • Work out what Lisp thinks your FQDN is hunk ./doc/index.html 77 +
    +* (ext:host-entry-name (ext:lookup-host-entry (unix:unix-gethostname)))
+
    + +It will probably help if this is correct, for at least some value of +``correct''. + +
  • You need to provide appropriate values for your host for the +variables in examples/variables.lisp. So that you can keep settings +for multiple hosts, these are stored in (your hostname with dots +replaced by hyphens).lisp - see e.g. +tninkpad-telent-net.lisp. Create the appropriate file in the +examples directory + hunk ./doc/index.html 92 -to include /tmp/apache.cf.inc or whatever you specified for +to include /tmp/apache.cf.inc or whatever you specified for hunk ./doc/index.html 96 -as a start, here's what I do on my Debian laptop: +as a start, here are the relevant lines from my Debian laptop: hunk ./doc/index.html 100 -Include /tmp/apache.cf.inc +Include /tmp/apache.cf.inc hunk ./doc/index.html 102 -(localhost should be the machine's actual hostname usually, +(localhost should usually be the machine's actual hostname, hunk ./doc/index.html 107 -
  • (make:compile-system 'araneida) +
  • (make:compile-system 'araneida) hunk ./doc/index.html 109 -
  • (araneida::install-serve-event-handlers) ;; start serving +
  • (make:compile-system 'araneida-examples) hunk ./doc/index.html 111 -
  • Fire up a web browser +
  • Write the apache config file segment using +(araneida-examples::init) - now start or restart Apache hunk ./doc/index.html 114 -
  • (araneida::remove-serve-event-handlers) ;; stop serving +
  • Start the server event handlers using (araneida-examples::start) + +
  • Fire up a web browser. Browse. + +
  • Observe that the toplevel also still works hunk ./doc/index.html 122 + +
  • Stop the web server event handlers with (araneida-examples:stop) + +
  • Send me mail and tell me how +badly broken these instructions are. + hunk ./doc/index.html 129 + +

    Good luck! +

    +$Date: 1999/12/28 18:33:11 $
    Daniel Barlow
    + + }