\documentstyle[12pt,multicol,fancyheadings,psbox]{article}

\addtolength{\oddsidemargin}{-0.875in}
\addtolength{\evensidemargin}{-0.875in}
\addtolength{\textwidth}{1.75in}
\addtolength{\topmargin}{-0.875in}
\addtolength{\textheight}{1.75in}
%%
\setlength{\parindent}{0in}
\setlength{\itemsep}{0in}
\setlength{\parsep}{0in}
%%
\pagestyle{fancy}
\lhead{Athena Consulting Documentation}
%\chead{William Chuang}
\rhead{revised on \today}

\begin{document}

\begin{center}
{\LARGE Athena Consultants' Digging Tutorial}\\
{\em comments to wchuang@mit.edu}
\end{center}

This digging tutorial overview is to get you acquainted with most of the
tools available and helpful to consultants.  Some of the information you
will use very often and some you won't.  There are some topics which you
should already be familiar with:

\begin{enumerate}
\setlength{\itemsep}{4pt}
\item Use of {\bf olc}: in addition to the text-based olc client you
should all familiar with, there also is an X-based version called {\em
xolc}.  Some users and professors use it, though it is slightly buggy.
%%%
\item Use of {\bf olcr}: this is the text-based client; you should know
how to list, grab, replay, show, send, mail, forward, comment, and done
(at least).  There are also access-control lists ({\bf acl}'s) to
control certain functions.
%%%
\item Use of the {\bf OLC stock answer browser}: how to get around it,
everything in it, how to save a particular stock answer to send, etc.
%%%
\item Use of the {\bf Emacs OLC-client}: this is the Emacs-based {\em
olcr} client, written by Raul Acevedo.  There are many keybindings
available in here, and you should try to be familiar with it.
%%%
\item Use of {\bf olh} (including keywords): how to use the Motif {\em
help} application and also {\em help -tty} (note that there is an {\em
/usr/ucb/help} on DECstations).

How to lookup by keywords, save and print topics in {\em help}
%%%
\item What is in {\bf cref}: run through information available there ---
technical, policy, etc.
\item basic digging tools:  {\em dig}, {\em klook}, {\em shans}
\item the {\bf discuss logs} (cfyi, mfyi, cprivate, o{\bf topic}s, etc)
\item the Zephyr {\bf consult instance} and {\bf class}: \hspace{0.2in}
The consult instance is to be used for important announcements
concerning the status of Athena only.  Examples are:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item the OLC daemon dies
  \item a fileserver goes down
  \item MIT's network connection to the outside world goes down
  \item the mailhub is refusing mail
  \item the queue is humongous and you need help, etc.
  \end{itemize}
  \vspace*{-0.3\baselineskip}
{\em Don't} use the {\bf consult instance} for conversation and such.
Many {\bf IS} and {\bf Athena} people listen to the instance (you can
ask for their expertise) to know when something important ({\em i.e.}
bad) happens to Athena.  But if the {\bf consult instance} gets as much
traffic as the help instance, they'll no longer listen.  So if you want
to converse, etc, do it on the {\bf consult class}; there you can talk
about such matters as:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item trading on-duty hours
  \item ask other consultants about questions in the queue (questions are confidential, and hey, you don't want users to think we're stupid...)
  \item mindless babble
  \end{itemize}
  \vspace*{-0.5\baselineskip}
\end{enumerate}
I hope this covers most of the basic information which you have learned
by now.  If not, just ask (or mention what I'm missing).

\newpage
%%%%%%%%%
%%%%%%%%%

\begin{center}
{\Large Digging Tutorial Topics}
\end{center}

Here are the things which should be covered in a digging tutorial; i.e.,
the basic tools available to you when you are on-duty (or off).  They
are:
%%
\begin{enumerate}
\item The {\bf hardcopy manuals in 11-115}:\\
This is our consulting ``library''.  We can lend out various manuals,
provided that:
  \vspace{-0.5\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item at least one copy remains in the office.
  \item the user trades in his valid MIT ID (no driver's licenses, keys, etc)\footnote{see the Consultants' Handbook for details}
  \end{itemize}
  \vspace{-0.5\baselineskip}
In general, you should know what manuals we have, and what topics they
cover.  Reading them will definitely prove useful (especially with the
\LaTeX\ and Maple manuals!).
%%
\item {\bf On-line manuals}:\\
Of course, it is usually easier to read documentation on-line when you
are on-duty.  Not everything is available on-line, but a goodly amount
is.  Most programs available on Athena have manual pages, which you can
read and get information about with following programs:
%%
%% A little bit of gross hacking here.  I suppose I could've
%% redefined the marker used for second level enumerations,
%% but I didn't want to.
%%
\end{enumerate}
\begin{itemize}
%%
  \vspace*{-1.2\baselineskip}
  \begin{enumerate}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item man
  \item apropos (man -k)
  \item xman
  \end{enumerate}
  \vspace*{-0.5\baselineskip}
There are several sections of the unix manual, organized according to
type and content:
  \vspace*{-0.5\baselineskip}
  \begin{enumerate}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item User commands
  \item System calls
  \item Subroutines
  \item Devices
  \item File formats
  \item Games
  \item Misc
  \item System administration
  \end{enumerate}
  \vspace*{-0.5\baselineskip}
The {\em xman} program will display all the manual pages in your {\bf
MANPATH}, and allows you to browse through them at your leisure (and is
a large accumulation of information in one place); try it out.
\end{itemize}
%%
%% Restarting the enumerate environment... and setting the
%% counter to the correct value, as well.
%%
\begin{enumerate}
\setcounter{enumi}{2}
%%
\item {\bf /usr/doc}:\\
This directory contains various sections from the actual {\bf UNIX
BSD4.3} distribution (I know, because I have a set of the manuals).  You
can look in there for information and examples on most basic {\bf UNIX}
utilites.  The documents are written in {\em troff} and need to be
formatted for viewing:

  \vspace{-0.5\baselineskip}
  \hspace*{2in}athena\%  cd /usr/doc/ps1/07.ipctut\\
  \hspace*{2in}athena\%  nroff -me tutor.me $|$ more
  \vspace{-0.5\baselineskip}
\item the {\bf docsourc locker}:\\
This locker is maintained by the Training and Documentation
group.  Most of the information are in the subdirectories in {\bf
/mit/docsourc/doc/}, though they may be out of date.
%%
\item {\bf Emacs info}:\\
The Emacs Info browser is a very useful tool, which can give you access
to documentation on many items.  These may range from the default items
to a more respectable list, containing such topics as:
  \vspace{-0.5\baselineskip}
  \begin{itemize}
  \begin{multicols}{4}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item the X FAQ\footnote{Frequently Asked Questions (and Answers!), usually from USENET newsgroups} list
  \item bison
  \item gdb
  \item gcc
  \item cpp
  \item Emacs-LISP
  \item epoch
  \item gnus
  \item Eolcr
  \item perl
  \item make
  \item Scheme
  \end{multicols}
  \end{itemize}
  \vspace{-0.5\baselineskip}
(to get access to a list like this, you'd need to use either {\em
acevedo}'s, {\em wchuang}'s, or {\em tompalka}'s Emacs Info-directory.
To access the Emacs Info browser, just hit either:
  \vspace{-0.5\baselineskip}
  \begin{center}
  Control-h i \hspace*{0.5in} or \hspace*{0.5in} Meta-x info\\
  \end{center}
  \vspace{-0.5\baselineskip}
In the Info browser, hitting ``h'' will give a primer for first timers.
%%
\item {\bf FTP sites}:\\
There are many various FTP sites which contain loads of information,
programs, and files.  A listing of sites used to be in {\em Techinfo},
but some idiot took it out.  There is a usually recent list in {\bf
/mit/wchuang/Networks/anon-FTP.new.F}\footnote{compressed with the
program {\em freeze} in the {\bf SIPB} locker}.  Here's a list of
popular anonymous FTP sites:
  \vspace{-0.5\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item ftp.uu.net --- to get sources to various programs, as well as
public domain {\bf UNIX} source code.  The canonical listing of
anonymous FTP sites is in the info subdirectory.
  \item sun.soe.clarkson.edu --- \TeX\ sources, files
  \item labrea.stanford.edu --- more \TeX\ stuff
  \item sumex-aim.stanford.edu --- Mac software, virus reports, etc.
  \item prep.ai.mit.edu --- FSF (Free Software Foundation) programs (GNU
stuff, such as Emacs, etc.)
  \item export.lcs.mit.edu --- sources to X windows
  \item athena-dist.mit.edu --- Athena-developed software (Kerberos,
Zephyr, Olc, Moira, etc.)
  \item ftp.nisc.sri.com --- Internet information and domains
  \item wuarchive.wustl.edu --- large repository of DOS and Mac software,
all sorts of software, graphics images, etc.
  \end{itemize}
  \vspace{-0.5\baselineskip}
In addition to these major FTP sites, you can also use {\em archie} or
{\em xarchie} in the {\bf SIPB} locker --- {\em archie} queries a remote
archie server database with the strings you give it, and returns a list of
hosts with files including those strings.  This is useful if you want to
find a site with a given program.
%%
\item Monitoring {\bf system information}:\\
You can get information on the status of the gateways and machines on
MITnet by doing:
  \vspace{-0.5\baselineskip}
  \begin{center}
  finger status@noc $|$ more
  \end{center}
  \vspace{-0.5\baselineskip}
If you want to subscribe to the Zephyr class and get this information,
you can type:
  \vspace{-0.5\baselineskip}
  \begin{center}
  zctl sub noc \verb^\* \*^ \hspace*{0.5in} or \hspace*{0.5in} zctl add noc \verb^\* \*^
  \end{center}
  \vspace{-0.5\baselineskip}
NOTE: a slight warning on this... if the network starts having troubles,
you'll be inundated with messages about machines and networks timing
out, literally hundreds of messages in a few minutes.

To check whether a machine is up and running, you can do:

\hspace*{1in} athena\%    /etc/ping machinename

If the machine in question is an NFS server, you can do:

\hspace*{1in} athena\%  /mit/watchmaker/\$bindir/nfsping NFSservername

You should {\bf not publicize} this program, because it creates a load
on the NFS servers, and having many users running it would seriously
degrade performance.  Keep it to within consulting (and use it
sparingly).  To check connectivity to a particular machine or gateway,
on some machines you can do:

\hspace*{1in} athena\%  /usr/etc/traceroute\footnote{Not on all machine types} machinename

If the machine runs SMNP, you can try using the following, to get more
information on it:

\hspace*{1in} athena\%  /afs/net/tools/@sys/hostcheck machinename

In addition, you might want to check out the program {\em hostinfo}.
The configuration file run on startup on a workstation is in {\bf
/etc/athena/rc.conf}, and the list of various ports and services is listed in
{\bf /etc/services}.
%%
\item {\bf AFS utilities}:\\
There are three basic AFS management utilities that you should know how
to use.  They are:
\end{enumerate}
%%%%%
%%%%% ending enumerate environment to get numbering here
%%%%%
\begin{itemize}
  \vspace{-1.2\baselineskip}
  \begin{enumerate}
  \item fs - a suite of commands for contacting the AFS {\bf F}ile {\bf S}erver
  \item pts - a suite of commands for contacting the AFS {\bf P}ro{\bf
t}ection {\bf Server}
  \item vos - a suite of commands for contacting the AFS {\bf V}olume
{\bf O}peration {\bf S}erver
  \end{enumerate}
  \vspace{-0.5\baselineskip}
You can get help in each by typing ``{\em fs help}'', ``{\em vos
help}'' or ``{\em pts help}''.  The most commonly used is {\em fs}, and
here are some of useful commands ({\bf acl} stands for ``access control
list''):
  \vspace*{-0.5\baselineskip}
  \begin{center}
  \begin{tabular}{|l|l|}\hline
  {\bf fs setacl}:		     & athena\%  fs sa . timo all -negative\\
  \hspace*{4ex}set access control list & athena\%          \\
  {\bf fs listacl}:		     & athena\%  fs la . \\
  \hspace*{4ex}list access control list& Normal rights:    \\
				     & \hspace*{2ex}wchuang rlidwka\\
				     & Negative rights:  \\
				     & \hspace*{2ex}timo rlidwka   \\
  {\bf fs listquota}:		     & athena\%  fs lq ~ \\
  \hspace*{4ex}list volume quota	     & \verb^Volume Name      Quota  Used  % Used  Partition^\\
  				     & \verb^user.wchuang      7000  6229     89%        88%^\\
  {\bf fs mkmount}:		     & athena\%  fs mkm my\_backup user.wchuang.backup\\
  \hspace*{4ex}make mount point	     & athena\%  ls my\_backup\\
  				     & {\it listing of my backup volume, since the last backup time}\\
  {\bf fs rmmount}:		     & athena\%  fs rmm my\_backup\\
  \hspace*{4ex}remove mount point	     & {\it removes my backup volume and deletes the mountpoint}\\
  {\bf fs sysname}:		     & athena [hydrox]\%  fs sysname\\
  \hspace*{4ex}get sysname (@sys) value& Current sysname is 'pmax\_ul4'\\\hline
  \end{tabular}
  \end{center}
  \vspace*{-0.5\baselineskip}
The program {\em pts} is also useful for creating your own AFS groups
and managing them ({\bf do not recommend to users}):
  \vspace*{-0.5\baselineskip}
  \begin{center}
  \begin{tabular}{|l|l|}\hline
  {\bf pts creategroup}:	     & athena\%  pts creategroup wchuang:source\\
  \hspace*{4ex}create a new group    & athena\%   \\
  {\bf pts adduser}:		     & athena\%  pts adduser dougie wchuang:source\\
  \hspace*{4ex}add a user to a group & athena\%  pts adduser timo wchuang:source\\
  {\bf pts removeuser}:		     & athena\%  pts removeuser timo wchuang:source\\
  \hspace*{4ex}remove a user from a group & athena\%   \\
  {\bf pts rename}:		     & athena\%  pts rename wchuang:source wchuang:consult\\
  \hspace*{4ex}rename user or group  & athena\%   \\
  {\bf pts membership}:		     & athena\%  pts membership wchuang:consult\\
  \hspace*{4ex}list membership of a  & Members of wchuang:consult (id: -98939) are:\\
  \hspace*{4ex}user or group	     & \hspace*{2ex}dougie\\
  {\bf pts listowned}:		     & athena\%  pts listowned wchuang\\
  \hspace*{4ex}list groups owned by an    & \hspace*{2ex}wchuang:private\\
  \hspace*{4ex}entry		     & \hspace*{2ex}wchuang:news\\
				     & \hspace*{2ex}wchuang:consult\\
				     & athena\%  fs sa consult wchuang:consult all\\\hline
  \end{tabular}
  \end{center}
  \vspace*{-0.5\baselineskip}
As for {\em vos}, the most useful command it has is:
  \vspace*{-0.5\baselineskip}
  \begin{center}
  vos examine user.username
  \end{center}
  \vspace*{-0.5\baselineskip}
In addition, you probably want to take a look at {\em aklog} and {\em
kas}, all of which are in the directory:
  \vspace*{-1.5\baselineskip}
  \begin{center}
  {\bf /afs/athena/system/afsuser/@sys/bin}
  \end{center}
  \vspace*{-0.5\baselineskip}
There may be copies of these program in various other directories, but
those are usually build/test programs, rather than the ones you should
be using.
%%
\end{itemize}
%%%%%
%%%%% restarting enumerate environment and resetting counter
%%%%%
\begin{enumerate}
\setcounter{enumi}{8}
\item{\bf Mail and Information on other sites}:\\
Sometimes it is necessary to find out what type a remote machine is, or
discover how mail is routed to a site.  There are a few programs which
can get you this information:
  \vspace*{-0.5\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item {\em hostinfo} --- this can get some information, provided the
remote machine supports it:\\
  \hspace*{1in} mint-chocolate-chip\% hostinfo labrea.stanford.edu\\
  \hspace*{1in} Desired host:   labrea.stanford.edu\\
  \hspace*{1in} Official name:  labrea.stanford.edu\\
  \hspace*{1in} Host address:   36.8.0.47     	   \\
  \hspace*{1in} Host info:      SUN-3/180/UNIX	   \\
  \hspace*{1in} MX address:     labrea.Stanford.EDU
  \item {\em host} (consult locker) --- this will get the IP address:\\
  \hspace*{1in} mint-chocolate-chip\% host -a heath-bar-crunch	    \\
  \hspace*{1in} Trying domain "MIT.EDU"			  \\
  \hspace*{1in} rcode = 0 (Success), ancount=1		  \\
  \hspace*{1in} The following answer is not authoritative:\\
  \hspace*{1in} \verb^heath-bar-crunch.MIT.EDU     17831 IN     A     18.80.1.89^\\
  \hspace*{1in} \verb^For authoritative answers, see:^		  \\
  \hspace*{1in} \verb^mit.edu 60 IN   NS      BITSY.MIT.EDU^	  \\
  \hspace*{1in} \verb^mit.edu 60 IN   NS      W20NS.MIT.EDU^	  \\
  \hspace*{1in} \verb^mit.edu 60 IN   NS      STRAWB.MIT.EDU^	  \\
  \hspace*{1in} \verb^mit.edu 60 IN   NS      LITHIUM.LCS.MIT.EDU^\\
  \hspace*{1in} \verb^Additional information:^			  \\
  \hspace*{1in} \verb^BITSY.MIT.EDU   60 IN   A       18.72.0.3^  \\
  \hspace*{1in} \verb^W20NS.MIT.EDU   60 IN   A       18.70.0.160^\\
  \hspace*{1in} \verb^STRAWB.MIT.EDU  60 IN   A       18.71.0.151^\\
  \hspace*{1in} \verb^LITHIUM.LCS.MIT.EDU     60 IN   A       18.26.0.121^
  \item {\em nslookup} (watchmaker locker) --- to find out mail
addressing routes to a site.\\
  \hspace*{1in} hydrox-cookie\% nslookup\     \\
  \hspace*{1in} Default Server:  LOCALHOST.mit.edu \\
  \hspace*{1in} Address:  127.0.0.1           \vspace*{0.5\baselineskip}\\
  \hspace*{1in} $>$ oracle.com                \\
  \hspace*{1in} Server:  LOCALHOST.mit.edu    \\
  \hspace*{1in} Address:  127.0.0.1           \vspace*{0.5\baselineskip}\\
  \hspace*{1in} *** No address information is available for oracle.com\\
  \hspace*{1in} $>$ set qt$=$mx               \\
  \hspace*{1in} $>$ oracle.com                \\
  \hspace*{1in} Server:  LOCALHOST.mit.edu    \\
  \hspace*{1in} Address:  127.0.0.1           \vspace*{0.5\baselineskip}\\
  \hspace*{1in} oracle.com      preference = 200, mail exchanger = gatekeeper.oracle.com\\
  \hspace*{1in} gatekeeper.oracle.com   inet address = 139.185.1.5
  \item {\em expn} (consult locker) --- to see if a username has a
maildrop at an Internet site\\
  \hspace*{1in} hydrox-cookie\% expn smith@labrea.stanford.edu  \\
  \hspace*{1in} 220 labrea.Stanford.EDU Sendmail 4.1/1.34 ready at Mon, 6 Apr 92\\
  \hspace*{1in} 14:28:02 PDT					\\
  \hspace*{1in} 550 smith... User unknown			\\
  \hspace*{1in} 221 labrea.Stanford.EDU closing connection
  \end{itemize}
Also in the {\bf watchmaker} locker is {\em bindtest}, an earlier
version of {\em nslookup}.  Other programs to use include {\em
net\_lookup} in the {\bf consult} locker and {\em traceroute}.  The
{\bf net-directory} locker contains old listings of Internet and BITNET
sites, as well as foreign countries' sites and UUCP maps.
%%
\item{the {\bf Paco} account}:\\
The {\bf paco} account is a {\em vanilla} account to be used {\em for
consulting purposes only}.  This encompasses:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item testing a user's problems on a vanilla account
  \item temporary account for use {\em in the office} if they don't have
an account
  \item if your own account is on a fileserver that is down, and you
need to consult in on-duty office hours
  \end{itemize}
  \vspace*{-0.3\baselineskip}
In other words, the {\bf paco} account should be used solely for
consulting purposes.  The account should:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item {\bf never} be reconfigured
  \item {\bf never} be used for storage of any type
  \item {\bf never} contain any files, other than the vanilla setup
  \item {\bf never} be used as a regular login or given out as such
  \end{itemize}
  \vspace*{-0.3\baselineskip}
Any files stored in this account will be nuked on sight, and the default
configuration restored.  Users and consultants alike should not be using
it as a second account --- it is there only for consulting purposes.  To
get the password to the account, ask an experienced or full-time
consultant.
%%
\item{{\bf Lockers on Athena}}:\\
There are hundreds of interesting lockers on Athena\ldots\ but since I
don't know them all, I'll just give you a small sampling of the more
popular ones.
\begin{itemize}
\item {\bf consult} --- be very familiar with the contents of the consult
locker.  There are many useful tools and much instructive documentation
in our locker.  The {\bf consult/doc} subdirectory contains:
  \vspace*{-0.5\baselineskip}
  \begin{itemize}
  \begin{multicols}{2}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item how\_to\_find\_sources
  \item mail\_to\_colleges
  \item finding\_addresses
  \item mail-gateways.txt
  \end{multicols}
  \end{itemize}
  \vspace*{-0.4\baselineskip}
The {\bf consult/lib} subdirectory contains \LaTeX\ .sty files, Scribe
information, Emacs-LISP files, etc.  The {\bf consult/bin} directory
contains useful shell scripts, such as:
  \vspace*{-0.4\baselineskip}
  \begin{itemize}
  \begin{multicols}{2}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item make\_readable and make\_unreadable
  \item check\_dotfiles
  \item punt
  \item version
  \end{multicols}
  \end{itemize}
  \vspace*{-0.4\baselineskip}
In addition, there are of course the executables in the consult locker
as well, nearly all of which you should know about:
  \vspace*{-0.4\baselineskip}
  \begin{itemize}
  \begin{multicols}{4}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item MTOOLS
  \item expn
  \item dig
  \item findhost
  \item resizebitmap
  \item hes
  \item lastlog
  \item net\_lookup
  \item showbitmap
  \item zprstat
  \item host
  \item ps2txt
  \end{multicols}
  \end{itemize}
  \vspace*{-0.4\baselineskip}
There's much more, so browse around in the locker.
%%
\item {\bf Lockers in /afs/athena/astaff/project} --- these lockers are
under ongoing development by Athena.  They include:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \item athena-projects --- projects under development
  \item dialup --- stuff about the dialup machines
  \item evaluate --- software under evaluation (this currently includes
{\em frame}, {\em sas}, {\em apl}, {\em autocad}, and more)
  \item olcdev + eolcdev  --- development lockers for olc/olcr and eolcr
  \end{itemize}
  \vspace*{-0.4\baselineskip}
there are many many more lockers in that directory, though.  Poke around
and see what you can find.
%%
\item {\bf windowmanagers} --- those windowmanagers not in the release,
such as awm, gwm, uwm, vtwm, and vtwm.gamma along with source code and
documentation.
%%
\item {\bf sipb} - The {\bf S}tudent {\bf I}nformation {\bf P}rocessing
{\bf B}oard's locker is one of the most popular lockers around.  It
contains scads of useful programs and utilities, the more commonly used
of which are:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \begin{multicols}{2}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item xscreensaver
  \item webster and thesaurus
  \item idraw and xfig
  \item rrn and xrn
  \item rx, rb, rz and sx, sb, sz
  \item macps
  \item dvips
  \item archie
  \end{multicols}
  \end{itemize}
  \vspace*{-0.3\baselineskip}
and lots more.  The directory {\bf sipb/doc} contains {\bf SIPB}'s
Inessential Guides and docs on {\bf SIPB}-supported programs; {\bf
sipb/lib} has extensive \LaTeX\ .sty files and Emacs-LISP files.  Note
also the existence of /afs/sipb, which {\bf SIPB} uses for internal
items, personal lockers, and other function.
%%
\item {\bf sipbsrc} - this locker contains the sources for most of the
programs in the {\bf SIPB} locker.
%%
\item {\bf gnu} - this locker contains programs and sources from the
Free Software Foundation.  There are tons of useful utilities and bits
of info here...:
  \vspace*{-0.4\baselineskip}
  \begin{itemize}
  \begin{multicols}{4}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item bash
  \item bison
  \item bsh
  \item epoch
  \item etags
  \item gs
  \item g++
  \item gawk
  \item gcc
  \item gdb
  \item gdiff
  \item ggrep
  \item gmake
  \item gnuchess
  \item ghostview
  \item gtar
  \end{multicols}
  \end{itemize}
  \vspace*{-0.4\baselineskip}
and the FSF created {\em emacs}, among other useful programs.  The more
commonly used of the above are {\em gcc} (an ANSI-compliant compiler,
with certain flags), {\em gdb} for debugging, {\em g++} (a C++
compiler), etc.
%%
\item {\bf watchmaker} - tons of useful miscellaneous programs, written
by the Watchmakers in their heyday.  Some of the more helpful are:
  \vspace*{-0.4\baselineskip}
  \begin{itemize}
  \begin{multicols}{3}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item nfsping
  \item nslookup
  \item cdecl
  \item ofiles
  \item less
  \item agrep
  \end{multicols}
  \end{itemize}
  \vspace*{-0.4\baselineskip}
%%
\vspace*{-0.5\baselineskip}
\item {\bf thesis} - the thesis locker contains the MIT thesis template
files, for both \LaTeX\ and Scribe (though the latter should not be used
anymore).  There is also a README file in the thesis directory which has
directions for usage.
%%
\vspace*{-0.5\baselineskip}
\item {\bf dotfiles} - the dotfiles locker contains sample files
contributed by various Athena staff, consultants, SIPB members, and
knowledgable users.  These cover such topics as:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \begin{multicols}{2}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item csh/tcsh aliases and configuration
  \item Emacs startup files
  \item environment variables
  \item discuss meetings
  \item twm/vtwm configuration files
  \item X resources
  \item .zwgc.desc customizations
  \end{multicols}
  \end{itemize}
  \vspace*{-0.3\baselineskip}
%%
\vspace*{-0.5\baselineskip}
\item {\bf graphics} - the graphics locker contains a multitude of
graphics manipulation and viewing programs, including:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item xv
  \item xloadimage
  \item xim
  \item PBM utilities
  \item xgrasp
  \end{itemize}
  \vspace*{-0.3\baselineskip}
In addition to these, there are repositories of images also in the
locker:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item /mit/graphics/images/cmu-gif
  \item /mit/graphics/images/cmu-raster
  \item /mit/graphics/images/xpix
  \end{itemize}
  \vspace*{-0.3\baselineskip}
and you can also run the program /mit/graphics/images/setup-images to
gain direct access to several remote sites.  There is a listing of
various image formats in the directory /mit/graphics/images/FORMATS.
%%
\item {\bf pictures} - various utilities for viewing pictures and using
video workstations.  The rest of the items are links to the graphics
locker.
%%
\item {\bf postscript} - all sorts of pictures and programs written in
PostScript.  These vary from ClipArt, fractals, ID cards, maps, music,
pictures, to fonts and macros.  The locker also contains programs (and
hacks) to get more than one PostScript page on an actual sheet of paper.
%%
\item {\bf motif} - the MOTIF locker contains the Motif libraries and
include files, as well as examples of programming with the Motif
toolkit.
%%
\item {\bf rfc} - {\bf RFC} stands for {\bf R}equest {\bf F}or {\bf
C}omment.  It contains long documents about various topics, most of
which is on Internet stuff under development.
%%
\item {\bf games} - in addition to a whole slew of games in this locker
which are very addictive, there are also some useful programs here, such
as:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item banner + banner2:  programs to print out text in ``banner'' form
  \item cursive:  prints out text in large cursive form
  \item irc:  Internet Relay Chat, a sort of multi-user talk/chat-line
  \item primes:  a program that calculates prime numbers
  \item wscrawl:  a multi-user draw/text program
  \item letters + ttype:  typing games and tutors
  \end{itemize}
  \vspace*{-0.3\baselineskip}
%%
\item {\bf potluck} - this locker contains the random items which didn't
seem to fit elsewhere or couldn't find a home.  There are Emacs-LISP
files, humor files, various programs, calendars, viewers for Japanese
and Chinese documents/text, etc.
%%
\item {\bf X11 lockers} - there are several different X lockers, which
contain the various revisions.  First, there's the {\bf x11r2} locker,
then the {\bf x11r3} locker, the {\bf x11r4} locker, and the {\bf x11r5}
locker.  The X11R4 locker is the standard one on Athena, currently, and
doing an ``attach x11'' will get you the following:

\hspace*{0.5in} athena\%  attach x11\\
\hspace*{0.5in} attach: /afs/athena.mit.edu/system/x11r4 linked to /mit/x11 for filesystem x11

The x11 lockers contain the X libraries and include files --- if you look
at the directory /usr/include/X11 and the library file
/usr/lib/libX11.a, you'll see that they are symbolic links to the x11
locker --- as well as source to X client programs, demo programs,
documentation, and utilities.
%%
\item literary lockers - there are a few lockers which contain literary
texts of note, of which I know three:
  \vspace*{-0.3\baselineskip}
  \begin{enumerate}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item {\bf shakespeare}:  contains text from the great Bard's
comedies, sonnets, histories, and tragedies.  Much fun to read.
  \item {\bf bible}:  contains the King James Version and the Mormon
Bible, as well as MS-DOS executables and binaries.
  \item {\bf oxq}:  not completely finished, but when done this locker
will contain the Oxford Book of Quotations, with a server (probably run
by {\bf SIPB}) and a front-end similar to that for {\em webster} and
{\em thesaurus}.
  \end{enumerate}
  \vspace*{-0.3\baselineskip}
%%
\item random other lockers --- here are some others with interesting
things in them:
  \vspace*{-0.3\baselineskip}
  \begin{itemize}
  \begin{multicols}{3}
  \setlength{\itemsep}{0in}
  \setlength{\parsep}{0in}
  \item OldXfonts
  \item net-tools
  \item andrew
  \item calendar
  \item zephyr
  \item wais
  \item softbone
  \end{multicols}
  \end{itemize}
\vspace*{10\baselineskip}
\begin{figure}[h]
\PSbox{office_owl.PS}{2in}{2in}
\end{figure}

\end{itemize}
\end{enumerate}

\end{document}
