home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
u
/
uupc08au.zip
/
README.LST
< prev
next >
Wrap
File List
|
1990-09-09
|
16KB
|
463 lines
September 9, 1990 UUPC/extended 1.08a README
RReevviissiioonn:
This document applies to UUPC/extended version 1.08a, and was
formatted on September 9, 1990 at 17:41:39.
IInnttrroodduuccttiioonn:
This document provides information on installing UUUUPPCC//eexxtteennddeedd 11.0088aa,
(refered to in this document as UUPC/extended). UUPC/extended is
based on the widely distributed interim version of UUPC, version 1.05,
written by Stuart Lynne, Richard H. Lamb, and Samuel Lamb, in
Vancouver, BC. UUPC is no longer maintained in Vancouver;
UUPC/extended 1.08a is the official current release.
The differences between UUPC/extended and UUPC version 1.05 include
user aliases, routing to multiple hosts, dial in support, limited
domain address parsing and routing, and various improvements in the
user interface. Because of these changes, much of what is contained
in this document does not apply to the original UUPC 1.05 package.
UUPC/extended is written in Borland Turbo C++ 1.0, with one additional
module in 8086 Assembler (MASM). This documentation is written in a
derivative of the SCRIPT document composition language.
CCooppyyrriigghhtt:
Portions of this software are copyrighted by the following persons:
Copyright (c) Richard H. Lamb 1985, 1986, 1987
Copyright (c) Samuel Lamb 1987
Changes Copyright (c) Stuart Lynne 1987
Changes Copyright (c) Andrew H. Derbyshire 1989, 1990
Additional thanks go to Wolfgang Tremmel, Jordan Brown, John DuBois,
and Phillip Meese.
This documentation is Copyright (c) 1989, 1990 Andrew H. Derbyshire.
The runtime libraries for Turbo C++ are Copyright (c) 1986, 1990, by
Borland International, and are used by permission.
This software may be used and copied freely so long as the applicable
copyright notices are retained, but no money shall be charged for its
distribution beyond reasonable handling costs, nor shall proprietary
changes be make to this software so that it cannot be distributed
freely.
- 1 -
September 9, 1990 UUPC/extended 1.08a README
WWaarrrraannttyy IInnffoorrmmaattiioonn:
This software is distributed on a "as-is" basis, without any warranty,
expressed or implied. Use of this software and the associated
documentation is at your own risk.
FFuunnccttiioonn:
UUPC/extended is a PC based version (and pun of) UUCP (UNIX-to-UNIX
copy). UUPC/extended allows a MS-DOS based Personal Computer to
exchange mail and files with a UNIX system or other UUPC/extended
system over dial up or dedicated phone lines using the UUCP "g"
protocol.
SSyysstteemm rreeqquuiirreemmeennttss:
The following required to set up a PC to use UUPC/extended:
1. An IBM-PC or compatible system with at least 256K of RAM.
2. A modem connected to a telephone line. Special support exists in
UUPC/extended for Hayes compatible modems.
3. 300K of free space on your hard drive.1
SSuuggggeesstteedd rreeaaddiinngg:
U_s_i_n_g_ U_U_C_P_ a_n_d_ U_s_e_n_e_t_ and M_a_n_a_g_i_n_g_ U_U_C_P_ a_n_d_ U_s_e_n_e_t_, both by O'Reilly
and Associates.2 These are available from your local bookstore or
software house, or call them at 1-800-338-NUTS. These books make no
mention of UUPC/extended, but do explain the details of Usenet and the
general format of many of the files (especially the SYSTEMS file) that
UUPC/extended uses.
IInnssttaalllliinngg UUUUPPCC//eexxtteennddeedd:
Each file that must be customized for UUPC/extended has comments in it
describing the information that goes in the file. The general
procedure for installing UUPC/extended is as follows:
1. Choose a host name for your system, and user id for yourself.
2. Get the phone number, user id & password, and login procedure for
the system that will act as your mail server.
3. Copy the MAIL.EXE, UUIO.EXE, and UUPOLL.EXE files to a directory
in your path.
------------------------
1Use of a floppy based system is possible, but will greatly increase
the time to transfer a file.
2The author has no connection with O'Reilly and Associates. However,
both of these books are on my bookshelf.
- 2 -
September 9, 1990 UUPC/extended 1.08a README
4. Customize the UUPC.RC file, and copy it to the directory defined
in the file as the 'ConfDir' within the file.
5. Customize the SYSTEMS file and copy it to the 'ConfDir' directory
defined in UUPC.RC.
6. If and only if other systems are going to call you, customize the
PASSWD file, and copy it to the 'ConfDir' directory defined in
UUPC.RC.
7. Copy MAIL.HLP and TILDE.HLP to the 'ConfDir' directory defined in
UUPC.RC.
8. If special routing is required for hosts, customize the HOSTPATH
file, and copy it to the 'ConfDir' directory defined in UUPC.RC.
This is not usually needed.
9. Customize the PERSONAL.RC file, and copy it to the 'ConfDir'
directory defined in UUPC.RC.
10. Customize the PERSONAL.SIG file, and copy it to the 'Home'
directory defined in PERSONAL.RC.3
11. Customize the ALIASES.TXT file, and copy it to the directory
defined in the PERSONAL.RC file as your Home directory.
12. Edit your AUTOEXEC.BAT, adding SET commands for the variables
UUPCSYSRC, the fully qualified name of your UUPC.RC file,
UUPCUSRRC, fully qualified name of your PERSONAL.RC file, for TZ,
your local time zone. Sample TZ variable SET commands are as
follows:
SET TZ=EST5EDT or (Eastern Time, 5 hours behind GMT)
SET TZ=CST6CDT or .
SET TZ=MST7MDT or .
SET TZ=PST8PDT or (Pacific Time, 8 hours behind GMT)
SET TZ=GMT0 (GMT, no offset, no daylight savings)
Time zones ahead of GMT should use a minus size in front of the
hours offset.
13. Test the system by sending mail to yourself (see below).
SSyynnttaaxx:
To obtain the syntax of the various commands, enter the command name
followed by '-?'; for example:
mail -?
------------------------
3If this file is not installed, then the line in the PERSONAL.RC file
describing it must be commented out with a pound sign (#) in column
1.
- 3 -
September 9, 1990 UUPC/extended 1.08a README
uuio -?
uupoll -?
For a listing of the commands available when readng mail, see the file
MAIL.HLP in the configuration directory; for commands available when
reading mail see the file TILDE.HLP in the configuration directory
UUssiinngg UUUUPPCC//eexxtteennddeedd:
NNoottee: These are general instructions, and you may require additional
assistance if you have never used a UNIX-like mail system
before.
The components of UUPC/extended are used as follows:
1. To send mail, with the body of the message being typed in from
the PC keyboard:
MAIL -s "the subject" address1 address2 ... Where "the subject"
is the topic of the message, enclosed in quotes; if the subject
is omitted, then the '-s' flag should be omitted as well.
Addresses are in the form u_s_e_r_@_n_o_d_e_, n_o_d_e_!u_s_e_r_, l_o_c_a_l_u_s_e_r_, or
n_i_c_k_, where nick is a nickname in your aliases.txt file. The
flags '-c' and '-b' may also be inserted between addresses; all
addresses after '-c' are sent as Carbon copies, and addresses
following '-b' are Blind Carbon copies (and not displayed in the
header of the message). Thus, a valid mail command may be:
mail -s "Hello" help@kendra.kew.com echo@omnigate.clarkson.edu
The mail program will then prompt you for the message to be
sent. Note that ~? may be entered for commands available when
entering the mail.
Note that this only queues the mail for sending if it is going to
another system connected via a modem; UUIO (below) must be
invoked to actually transfer the mail to the other system.
2. To send mail which already exists in a file, the procedure is as
above, but the standard syntax for MS-DOS file redirection is
added to the end of the command line:
MAIL -s "the subject" address1 address2 ... < filename
3. To read your new mail, enter the command:
MAIL
If you do not have a mailbox, your mail is being forwarded, or
the mailbox is empty, MAIL will report this fact and exit. If
you have mail, the program will animate an asterisk for each
message in the mailbox, display the subjects of all the messages,
and then prompt you with the message number you are on and a
question mark (?). For a list of commands within MAIL, enter a
- 4 -
September 9, 1990 UUPC/extended 1.08a README
question mark at the prompt (?); to exit MAIL, enter 'q' at the
prompt.
4. To read mail saved in other than your mailbox, enter:
MAIL -f filename
Where filename is the file to be processed for mail. This may be
the file you specified to store outgoing mail in, or mail you
saved into another file when reading your new mail.
Note that when reading or saving mail, use of the equals sign (=)
in front of a file name directs MAIL to look for the specified
file in your home directory, the path of which was specified in
your PERSONAL.RC file.
5. To make UUIO call your mail server to deliver and pickup remote
mail:
UUIO -s all
This will make UUIO poll all the systems listed in the SYSTEMS
file.
6. To make UUIO wait for an incoming call:
BREAK ON
UUIO
UUIO will wait for a successful telephone call, and exit upon
completion; UUIO may be terminated by entering Cntrl-Break from
the keyboard.4
7. To use UUPOLL to have UUIO call out on a regular basis:
UUPOLL -f 0240 -i 0600
This will cause UUIO to call out at 2:40 A.M. and every six hours
thereafter until the user presses Cntrl-Break. Both flags are
specified as hhmm (hours and minutes).
8. To use UUPOLL to have UUIO call out on a regular basis, and
automatically answer the telephone between outgoing calls:
UUPOLL -f 0240 -i 0600 -r 0
This will cause UUIO to call out at 2:40 A.M. and every six hours
thereafter until the user presses Cntrl-Break, and in addition
UUIO will be invoked in passive mode to answer the telephone
between outgoing calls.
------------------------
4The BREAK ON command is required to insure that MS-DOS polls the
keyboard for the Cntrl-Break sequence; otherwise, you may have to
reboot your system to terminate UUIO.
- 5 -
September 9, 1990 UUPC/extended 1.08a README
PPrroobblleemmss:
PPLLEEAASSEE read the Nutshell handbooks before sending mail about
problems.
Please report problems with this version of UUPC/extended via E-mail
to help@kendra.kew.com. If you are unable to reach kendra via e-mail,
mail your problem report to:
Drew Derbyshire
UUPC/Extended Help Desk
108 Decatur Street, Apt 9
Arlington, MA 02174
Please include with your problem description listings of:
1. AUTOEXEC.BAT
2. CONFIG.SYS
3. UUPC.RC
4. PERSONAL.RC
5. Directory of your UUPC configuration directory.
No claim is made that the problem will be corrected, or the person
reporting the problem will be supplied a copy of the corrected code,
but reasonable efforts will be made to correct the program.
I do not provide formal telephone support; I do answer my telephone,
but because of cost considerations, your calls will not be returned at
my expense. Nor do I provide help in setting up systems, if you can't
call it a bug please don't tell me about it.
WWhheerree ttoo ggeett nneeww vveerrssiioonnss:
UUPC/extended is available on the Internet from SIMTEL20.ARMY.MIL, via
anonymous FTP; it is located in directory PD2:<MSDOS2.UUCP>. It is
also available from the Clarkson University HUG Bulletin Board,
315-268-6667, file area 4. UUPC/extended is NO LONGER available from
kendra.
In general, the files for UUPC/extended are distributed in two files:
* UUPCxxxU.ZIP contains the files a user needs to run
UUPC/extended, including the executables, formatted
documentation, and sample configuration files.
* UUPCxxxS.ZIP contains the files needed to build UUPCxxxU.ZIP,
including the source to UUPC, MAKE and TLINK input files, the
unformatted documents, and sample configuration files.
- 6 -
September 9, 1990 UUPC/extended 1.08a README
In both of the above names, "xxx" is the release/revision number.
- 7 -