Go to file
vibr aea0e950ba removed definition of GET-HEADER which conflicted with definition of
GET-HEADER in utilities.scm and wasn't exported anyway
2004-08-14 20:54:57 +00:00
doc adapt docu of make-error-response to its reworked interface 2004-08-11 10:43:26 +00:00
scheme removed definition of GET-HEADER which conflicted with definition of 2004-08-14 20:54:57 +00:00
web-server "moved-temp" -> "temp-redirect" 2004-08-11 19:06:05 +00:00
.gitignore ignore the SSAX stuff 2002-09-18 17:25:26 +00:00
COPYING Synchronize copyright statements. 2002-12-03 10:41:04 +00:00
INSTALL Updates for the installation with the install-lib. 2004-04-15 18:41:58 +00:00
Makefile Include INSTALL in the tarball. 2004-05-12 07:29:45 +00:00
README Correct description of extended-web-server 2004-05-13 08:31:13 +00:00
RELEASE First steps towards 2.1 release. 2004-03-31 20:32:10 +00:00
pkg-def.scm re-commit revision 1.22, this time to branch http-1-1 2004-05-27 14:47:46 +00:00
start-extended-web-server re-commit revision 1.22, this time to branch http-1-1 2004-05-27 14:47:46 +00:00
start-surflet-server re-commit revision 1.22, this time to branch http-1-1 2004-05-27 14:47:46 +00:00
start-web-server re-commit revision 1.22, this time to branch http-1-1 2004-05-27 14:47:46 +00:00

README

This is the Scheme Untergrund Networking Package.

The Scheme Untergrund Networking Package (SUnet, for short) is a
collection of applications and libraries for Internet hacking in
Scheme.  It contains over 15000 lines of high-quality Scheme code that
runs under Scsh, the Scheme shell.  SUnet makes extensive use of
Scsh's facilities for multi-threaded systems programming und Unix.

SUnet includes the following components:

* The SUnet Web server
    This is a highly configurable HTTP 1.0 server in Scheme.
    The server is accompanied some libraries which may also
    be used separately:

    * URI and URL parsers and unparsers
    * a library for writing CGI scripts in Scheme
    * server extensions for interfacing to CGI scripts
    * server extensions for uploading Scheme code
    * simple structured HTML output library

    The server also ships with a sophisticated interface for writing
    server-side Web applications called "SUrflets".

* The SUnet ftp server
    This is a complete anonymous ftp server in Scheme.

* ftp client library
    This library allows you to access ftp servers programmatically.

* Netrc library
    This library parses authentication information contained in ~/.netrc.

* SMTP client library
    This library allows you to forge mail from the comfort of your own
    Scheme process.

* POP3 client library
    This library allows you to access your POP3 mailbox from inside Scsh.

* RFC822 header library
    This library parses email-style headers.

* Daytime and Time protocol client libraries
    These libraries lets you find out what time it is without paying for a
    Rolex.

* DNS client library
    This is a complete, multithreaded DNS library.

* An ls clone
    This library displays Unix-style directory listings without running ls.

Download
========

The SUnet code is available from

http://www.scsh.net/sunet/

To run the code, you need version 0.6.4 or later of Scsh, available from

http://www.scsh.net/

Installation
============

Starting with version 2.1 SUnet conforms to the packaging proposal for
scsh by Michel Schinz. Please see:

<http://lamp.epfl.ch/~schinz/scsh_packages/>

In short, this means that you can install SUnet by unpacking the SUnet
tarball and issuing the following command in the created directory:

scsh-install-pkg --prefix /path/to/your/package/root

See the file INSTALL for the generic installation instructions for
scsh packages.  

You need to install version 4.9 of the SSAX package to use SUnet. SSAX
is available from <http://lamp.epfl.ch/~schinz/scsh_packages/>.

Sample Web Server
=================

The installation procedure also installs three scripts to run the
SUnet httpd in the directory

/path/to/your/package/root/0.6/sunet/web-server/

The three scripts are:

start-web-server for running a simple web server on port 8080
start-extended-web-server for running a web server with rman and info gateway
start-surflet-server for running a web server with SUrflets enabled

Pass the --help option to learn how to configure the scripts.

These scripts should provide a pretty good starting point to set up
your own server or serve your own SUrfelts.

Support
=======

Please direct questions, comments, answers about SUnet to the regular
scsh mailing list at

scsh@zurich.ai.mit.edu

Relax, hack, and enjoy!

Dr. S.
Dr. S.
Martin Gasbichler
Eric Marsden
Andreas Bernauer