sunet/doc/latex/intro.tex

136 lines
4.7 KiB
TeX

\chapter*{}
\thispagestyle{empty}
Of course, there is no Underground---or Untergrund, as those German
new-age kids like to call the movement whose orders they
have sworn to follow. The age we all remember---the cliff-green
turbocharged convertibles, cigarettes hanging loose in the corners of
our mouths, and those trigger-happy fingers always ready for the quick
hack---is long gone.
In retrospect, it all seems like a candy-colored dream, and it may
very well be---after all, there was never any proof that the
Untergrund ever existed, and even if it did, we can be sure the
obedient followers of the shadowy movement leaders have long burned
the papers, subjected the hard drives and diskettes to interminable
sessions of the junkyard magnet, and eradicated all shreds of
memory from the brains of those who might have talked through long
sessions of Tcl hacking to the sounds of Celine Dion records.
Yet there are those who still covet membership in that secret
cult---to gain access to its powerful lore, to usurp invidious and
powerful superiors, or simply to impress their girlfriends. For those
lost souls of the modern age, I have a few words of advice:
It's not a question of ``membership''---silly merchandise and
ridiculous certificates. If you are truly meant to be part of the
Untergrund, you will know. \emph{The Untergrund will find you.}
Alas, probably not.
\medskip
\hfill April, 2003
\chapter{Overview}\label{sec:intro}
The Scheme Untergrund Networking Package (\textit{SUnet}, for short)
is a collection of applications and libraries for Internet hacking in
Scheme. It runs under Scsh, the Scheme shell. SUnet includes the
following components:
%
\begin{description}
\item[The SUnet Web server]
This is a highly configurable HTTP 1.0 server in Scheme.
The server is accompanied by some libraries which may also
be used separately:
\begin{itemize}
\item URI and URL parsers and unparsers
\item a library for writing CGI scripts in Scheme
\item server extensions for interfacing to CGI scripts
\item server extensions for uploading Scheme code
\item simple structured HTML output library
\end{itemize}
The server also ships with a sophisticated interface for writing
server-side Web applications called \textit{SUrflets}.
\item[The SUnet ftp server]
This is a complete anonymous ftp server in Scheme.
\item[ftp client library] This library allows you to access ftp
servers programmatically.
\item[netrc library] This library parses authentication information
contained in \verb|~/.netrc|.
\item[SMTP client library] This library allows you to forge mail from
the comfort of your own Scheme process.
\item[POP3 client library]
This library allows you to access your POP3 mailbox from inside scsh.
\item[RFC822 header library] This library parses email-style headers.
\item[Daytime and Time protocol client libraries]
These libraries lets you find out what time it is without paying for a
Rolex.
\item[DNS client library] This is a complete, multithreaded DNS
library.
\item[An \texttt{ls} clone] This library displays Unix-style directory
listings without running \texttt{ls}.
\end{description}
\section{Obtaining the system}
The SUnet code is available
\urlhd{http://www.scsh.net/resources/sunet.html}{here}{from
\url{http://www.scsh.net/resources/sunet.html}}. To run the code, you need
version 0.6.6 or later of \urlhd{http://www.scsh.net/}{scsh}{scsh from
\url{http://www.scsh.net/}}.
\section{How to install SUnet}
Starting with version 2.1 SUnet conforms to the packaging proposal for
scsh by Michel Schinz and needs Michel's installation library to
install properly. For more information, please see
\url{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:
\begin{verbatim}
scsh-install-pkg --prefix /path/to/your/package/root
\end{verbatim}
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 \url{http://lamp.epfl.ch/~schinz/scsh_packages/}.
\section{How to use the packages}
%
After installation, you can use the \verb+-lel+ command-line option to
load the package definitions. If you installed SUnet including
SUrflets (the default), you need to load SSAX as well:
%
\begin{alltt}
atari-2600[72] scsh -lel SSAX-4.9/load.scm -lel sunet-2.1/load.scm
Welcome to scsh 0.6.6 (King Conan)
Type ,? for help.
\end{alltt}
%
Now, all structures defined by SUnet and SSAX are available:
%
\begin{alltt}
> ,open ftp
Load structure ftp (y/n)? y
[netrc netrc.scm]
[ftp ftp.scm]
> \textit{call library code}
> ,exit
atari-2600[73]
\end{alltt}
%%% Local Variables:
%%% mode: latex
%%% TeX-master: "man"
%%% End: