2003-01-28 04:46:44 -05:00
|
|
|
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
|
2004-04-15 14:41:58 -04:00
|
|
|
Scheme. It contains over 15000 lines of high-quality Scheme code that
|
|
|
|
|
runs under Scsh, the Scheme shell. SUnet makes extensive use of
|
2003-01-28 04:46:44 -05:00
|
|
|
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
|
|
|
|
|
|
2004-04-15 14:41:58 -04:00
|
|
|
The server also ships with a sophisticated interface for writing
|
|
|
|
|
server-side Web applications called "SUrflets".
|
|
|
|
|
|
2003-01-28 04:46:44 -05:00
|
|
|
* 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.
|
|
|
|
|
|
2004-04-15 14:41:58 -04:00
|
|
|
Download
|
|
|
|
|
========
|
|
|
|
|
|
2003-01-28 04:46:44 -05:00
|
|
|
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/
|
|
|
|
|
|
2004-04-15 14:41:58 -04:00
|
|
|
Installation
|
|
|
|
|
============
|
|
|
|
|
|
2004-05-05 12:17:09 -04:00
|
|
|
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:
|
2004-04-15 14:41:58 -04:00
|
|
|
|
|
|
|
|
scsh-install-pkg --prefix /path/to/your/package/root
|
|
|
|
|
|
|
|
|
|
See the file INSTALL for the generic installation instructions for
|
|
|
|
|
scsh packages.
|
|
|
|
|
|
2004-05-05 12:45:39 -04:00
|
|
|
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/>.
|
2004-04-15 14:41:58 -04:00
|
|
|
|
2004-05-12 03:49:50 -04:00
|
|
|
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-webserver for running a web server with support for CGI
|
|
|
|
|
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.
|
|
|
|
|
|
2004-04-15 14:41:58 -04:00
|
|
|
Support
|
|
|
|
|
=======
|
|
|
|
|
|
2003-04-22 10:01:50 -04:00
|
|
|
Please direct questions, comments, answers about SUnet to the regular
|
|
|
|
|
scsh mailing list at
|
|
|
|
|
|
|
|
|
|
scsh@zurich.ai.mit.edu
|
|
|
|
|
|
|
|
|
|
Relax, hack, and enjoy!
|
2003-01-28 04:46:44 -05:00
|
|
|
|
|
|
|
|
Dr. S.
|
|
|
|
|
Dr. S.
|
|
|
|
|
Martin Gasbichler
|
|
|
|
|
Eric Marsden
|
|
|
|
|
Andreas Bernauer
|
