acliu@skat.usc.edu (Alex C. Liu) (12/10/89)
FILE: help intro
LAST CHANGE: Dec 8th, 1989.
VERSION: UX-Maze Server V2.0c
Introduction to UX-Maze's Mail Archive Server
=============================================
NOTE: This archive server has nothing to do with USC. It is a
service provided by me to the Net. Please do not abuse this service,
I am only a student here, and wouldn't afford get kicked out of school
because of this joke of Archive!
DISCLAIMER
----------
All the software in the UX-Maze Mail-Archive is provided AS IS with NO
WARRANTY. I Cannot guarantee that it is good for any particular
purpose, or even that it works.
I try to attempt to examine the software submitted to me, but as with
all free software written by strangers, MAKE SURE YOU KNOW WHAT YOU'RE
INSTALLING BEFORE YOU INSTALL IT!
INTRODUCTON
-----------
The idea of this Server is to serve request of popular programs for
the Commodore 8-bit family of computers. This is due because of the
INCREDIBLE lack of FTP Archive sites for the Commodore.
This Archive, is basicly, user supported. So if you don't see the
file that you are looking for, is because nobody, has bothered to
submit it to me... (If you see anything that you think should be
here, don't hesitate to submit it. See the instructions on how to
submit files bellow)
Server Software
---------------
The way the Server is written, it is simply a "hook" to the sendmail
forwarding mechanism available in Unix. The main program is written
in C but with some Shell script drivers and shell escapes. The
software is available from here, by requesting file:
send unix-support server
How the Server Works:
To make use of the server you have to send a Mail message to me,
<acliu@skat.usc.edu> and have a subject line:
Subject: Mail-Archive-Request
THIS IS VERY IMPORTANT! If you don't have that line spelled exactly
like that you won't get anything, and I will get a mailbox full of
junk messages. Somewhere along the header there should be a line
saying:
Return-Path: <your path from me to you> (This can change from site
to site, consult your local unix-mail guru for more info)
Usually, sendmail adds this automagically, but if it were not the
case, you can specify a return path by puting a line in the body of
your message saying:
path <from me to you>
In the body of your message you put the Mail Archive request. You can
put several request in a single message, one request per line. The
following request are honored: (Send a "help commands" for details)
path <return path from to you>
Forces M-AR to send the file to the mailing address specified
in its argument
help [topic]
Sends help on the topic. Default is this intro file. Make a
help topics
request for a list of topics for help
contents [volume]
Sends the contents of the volume. Defualt will send the list
of available volumes AND the contents of the Help volume.
index [volume]
Sends the directory list of the volume. Default will send the
directory for help volume
send [volume] [file]
Sends the file on the specified volume. Default Volume is
help, and default file is contents.
bencode [uuencode|btoa|hex]
Default encoding method to send binary files. Whenever the
server encounters binary data, it will use the latest bencode
command to select what method to use. (Default: uuencoding)
maxsize [bytesize]
Some mailer gateways will not accept messages larger than
certain limit. Whenever the file exceeds that limit, the
server will split the file and shar the parts before sending
them. This command lets you define the max message size in
bytes. (Default 0 = infinty)
receive [volume] [file]
Saves the message as if it were a submitted file. (use this
command to submit files to the server.)
end
Exits the server. (Optional)
The keywords are case insensitive BUT files are NOT. So if you see a
file named "gAMe" and you request "GamE". You will get nothing!
Submitting files
================
The server allows other users to submit files to the server. To do
this, send a Server request as you would normally do, but instead of
sending normal request, you enter the following line:
receive volume file
And after that, include a UUencoded/shar'ed version of the file you
are submitting.
For more info,
help contribution
FEEL FREE TO SUBMIT STUFF ANYTIME
For COMPLETE instructions on how to use the server AND the contents of
ALL the volumes of the server, send a request:
help full.help
____________________________________________________________________
Questions and suggestions, send them to the same address, but don't
put a Mail-Archive-Request subject line. (Just think of it of yet
another mail message)
1
---
Alex C. Liu
acliu%skat@usc.edu acliu@skat.usc.edu
(Simple .signature, $CHEAP$)