sunet/doc/latex/intro.tex

113 lines
3.9 KiB
TeX
Raw Normal View History

2003-01-23 05:06:24 -05:00
\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
2003-01-30 11:10:40 -05:00
Untergrund ever existed, and even if it did, we can be sure the
2003-01-23 05:06:24 -05:00
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
2003-01-23 05:06:24 -05:00
\chapter{Overview}\label{sec:intro}
2002-08-21 11:15:48 -04:00
2003-01-30 11:10:40 -05:00
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]
2003-01-30 11:10:40 -05:00
This is a highly configurable HTTP 1.0 server in Scheme.
The server is accompanied by some libraries which may also
2003-01-30 11:10:40 -05:00
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
2004-05-13 17:27:55 -04:00
\item simple structured HTML output library
2003-01-30 11:10:40 -05:00
\end{itemize}
2004-05-13 17:27:55 -04:00
The server also ships with a sophisticated interface for writing
server-side Web applications called "SUrflets".
2003-01-23 04:39:29 -05:00
\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.
2002-08-21 11:15:48 -04:00
\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.
2003-01-30 11:10:40 -05:00
\item[Daytime and Time protocol client libraries]
These libraries lets you find out what time it is without paying for a
Rolex.
2003-01-30 11:10:40 -05:00
\item[DNS client library] This is a complete, multithreaded DNS
library.
2003-01-23 04:39:29 -05:00
\item[An \texttt{ls} clone] This library displays Unix-style directory
listings without running \texttt{ls}.
\end{description}
2002-08-21 11:15:48 -04:00
2003-01-30 11:10:40 -05:00
\section{Obtaining the system}
2002-08-21 11:15:48 -04:00
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
2003-01-23 05:06:54 -05:00
version 0.6.4 or later of \urlhd{http://www.scsh.net/}{scsh}{scsh from
2002-08-21 11:15:48 -04:00
\url{http://www.scsh.net/}}.
\section{How to use the packages}
Untar the SUnet distribution somewhere. Fire up scsh and load the
SUnet \texttt{packages.scm} file into the configuration package.
After that, all structures defined by SUnet are available:
2002-08-21 11:15:48 -04:00
%
\begin{alltt}
2003-01-23 04:39:29 -05:00
atari-2600[72] scsh
2003-01-23 05:06:54 -05:00
Welcome to scsh 0.6.4 (...)
Type ,? for help.
> ,config ,load packages.scm
modules.scm
> ,open ftp
Load structure ftp (y/n)? y
[netrc netrc.scm]
[ftp ftp.scm]
2003-01-23 04:39:29 -05:00
> \textit{call library code}
> ,exit
atari-2600[73]
\end{alltt}
%%% Local Variables:
%%% mode: latex
%%% TeX-master: "man"
%%% End: