Category : UNIX Files
Archive   : UUPC11NO.ZIP
Filename : README.PRN

October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview



Table of Contents
Table of Contents
Table of Contents

Table of Contents.............................................1

Viewing on a Terminal.........................................2

Revision......................................................2

Overview......................................................2

Introduction..................................................2

Copyright and related credits.................................4

Warranty Information..........................................4

System requirements...........................................4

Required reading..............................................5

Special Notes.................................................5

Questions and Answers.........................................5

Mailing List..................................................7

Registering...................................................8

Problems......................................................8

























- 1 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview



Viewing on a Terminal
Viewing on a Terminal
Viewing on a Terminal

This document includes overstrikes for printing on a printer. To
read this document on-line, extract the program NOVRSTRK from the
UUPC/extended
UUPC/extended
UUPC/extended optional programs archive and issue the following
command;

NOVRSTRK README.PRN README.TXT

You can then browse the terminal ready version of the document,
README.TXT.


Revision
Revision
Revision

This is the 108th revision of this document, and applies to
UUPC/extended
UUPC/extended
UUPC/extended version 1.11m
1.11m
1.11m. This was last updated on October
29, 1991 by Drew Derbyshire. Even if you have read previous
versions of this document, this file, CHANGES.PRN
CHANGES.PRN
CHANGES.PRN, and FILES.LST
FILES.LST
FILES.LST
should be reviewed for updates.


Overview
Overview
Overview

Greetings from Kendra Electronic Wonderworks
Kendra Electronic Wonderworks
Kendra Electronic Wonderworks!

UUPC/extended
UUPC/extended
UUPC/extended is a PC based version (and pun of) UUCP (UNIX-to-
UNIX copy). UUPC/extended
UUPC/extended
UUPC/extended allows a MS-DOS or OS/2 based Personal
Computer to exchange mail and files with a UNIX system or other
UUPC/extended
UUPC/extended
UUPC/extended system over dial up or dedicated phone lines using
the UUCP "g" protocol.


Introduction
Introduction
Introduction

This document provides information on UUPC/extended
UUPC/extended
UUPC/extended version
1.11m
1.11m
1.11m, produced by Kendra Electronic Wonderworks
Kendra Electronic Wonderworks
Kendra Electronic Wonderworks with
contributions from around the globe. UUPC/extended
UUPC/extended
UUPC/extended is based on
the free widely distributed interim version of UUPC, version
1.05, written by Stuart Lynne, Richard H. Lamb, and Samuel Lam,
in Vancouver, BC. The MS-DOS version of UUPC is no longer
maintained in Vancouver; UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m is the official
current release of UUPC. The differences between UUPC/extended
UUPC/extended
UUPC/extended
and UUPC version 1.05 include user aliases, routing to multiple
hosts, dial in support, limited domain address parsing and
routing, OS/2 support, 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
UUPC/extended
UUPC/extended is written in C, and compiles with Borland C++ 2.0
under MS-DOS or with Microsoft C 6.0 under DOS or OS/2, with one
additional module in 8086 Assembler (MASM) for the MS-DOS

- 2 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


versions. The documentation was originally written in a
derivative of the SCRIPT document composition language, and is
being translated into Microsoft Word for Windows 1.1 as time
allows.

Minor revisions to UUPC/extended
UUPC/extended
UUPC/extended are denoted by changes to the
letter suffix on the version number. Minor revisions include
only those changes, no matter how great, that allow the user to
return to a previous release of UUPC/extended
UUPC/extended
UUPC/extended by at most updating
the configuration file. Major revisions to UUPC/extended
UUPC/extended
UUPC/extended are
denoted by a change in the number of the version; a major
revision has changes in it which introduce a permanent
incompatibility with the previous release. Major revisions to
date include:

UUPC/extended
UUPC/extended
UUPC/extended 1.07a, which added binary separators between
items of mail in a mail box, and was released October 1989.
Various revisions of release 1.07 added routing mail to
multiple hosts, the reply command, user aliases, the ability
to include mail in replies, and dial in support for remote
multiple systems.

UUPC/extended
UUPC/extended
UUPC/extended 1.08a, which changed the internally generated
names of files waiting to be transmitted to other systems.
This was done to avoid file name collisions with incoming
files from UNIX systems, and was released September 1990.

UUPC/extended
UUPC/extended
UUPC/extended 1.09a, which again changed the internally
generated names of files waiting to be transmitted to other
systems to correct an error in UUPC/extended
UUPC/extended
UUPC/extended 1.08a, and was
released October 1990. Various revisions of 1.09 also
added validation of local addresses, a more powerful command
parser for reading mail, forwarding mail to multiple
addresses, optional delivery of mail to separate
directories, and improved performance under Windows 3.0
enhanced mode.

UUPC/extended
UUPC/extended
UUPC/extended 1.10a, which added the ability to configure
for and use any modem; this changed the format of the
SYSTEM configuration file. This version was released in
April of 1991, and also added a UUCP command, support for
routing mail based on wildcard domains, mail gateway
support, and bi-directional file transfer support.

UUPC/extended
UUPC/extended
UUPC/extended 1.11a again changed the internally generated
names of files waiting to be transmitted to other systems,
and was released June of 1991. Revisions of 1.11 also added
the UUSTAT and UUSUB commands, security, ability to
automatically set the system clock.anonymous UUCP, optional
mailbox extensions, automatic mailbox backup, and mailbox
update integrity checks.




- 3 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


For a full description of the changes to UUPC/extended
UUPC/extended
UUPC/extended and how
they affect upgrading from one release to the next, see
CHANGES.PRN
CHANGES.PRN
CHANGES.PRN included in this package. It should be duly noted
that there is no version 1.24b at this time. A user was having
nightmares in which she didn't have version 1.24b and everyone
else did . . .

Copyright and related credits
Copyright and related credits
Copyright and related credits

Portions of this software are copyrighted by the following
persons:

Copyright (c) Richard H. Lamb 1985, 1986, 1987
Copyright (c) Samuel Lam 1987
Changes Copyright (c) Stuart Lynne 1987
Changes Copyright (c) Andrew H. Derbyshire 1989, 1991
Copyright (c) Dewey Coffman 1989
Copyright (c) Mitch Mitchell 1991
Changes Copyright (c) Jordan Brown 1991
Changes Copyright (c) Mike Lipsie 1991

Additional thanks go to Harry Broomhall, Harald Boegeholz, John
DuBois, Edward Keith, Phillip Meese, Dave Platt, Mike O'Carroll,
Cliff Stanford, Wolfgang Tremmel, Dave Watt, and Katherine
Williams.

Honorable mention goes to Snuffles P. Bear, who says to please
send chocolate. Warm thanks to Russell Nelson, who, among many
other services rendered, did so.

This documentation is Copyright (c) 1989, 1991 Andrew H.
Derbyshire.

The run-time libraries for Borland C++ are copyrighted by Borland
International, and are used by permission. Likewise the run-
time libraries for Microsoft C are copyrighted by Microsoft 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 made to this software so that it
cannot be distributed freely. Whenever possible, the source must
distributed with the executable files.


Warranty Information
Warranty Information
Warranty Information

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.


System requirements
System requirements
System requirements

- 4 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


The following is required to set up a PC to use UUPC/extended
UUPC/extended
UUPC/extended:

An IBM-PC or compatible system with at least 386K of RAM.
A modem connected to a telephone line.
One megabyte of free space on your hard drive. This provides
space for the executables, the documentation, configuration
files, and mail received.


Required reading
Required reading
Required reading

Instructions on installing UUPC/extended
UUPC/extended
UUPC/extended are in INSTALL.PRN.
Instructions on using the programs are in COMMANDS.PRN and
MAIL.PRN.

This document and its companions supplied with UUPC/extended
UUPC/extended
UUPC/extended only
provide an overview of the software. The average person wishing
to set up UUPC/extended
UUPC/extended
UUPC/extended will require a reference such as Managing
UUCP and Usenet, part of the Nutshell Handbook series by O'Reilly
and Associates.12 This book, while not specifically addressing
UUPC/extended
UUPC/extended
UUPC/extended, includes detailed information on:

Format of the SYSTEMS file
Format of the PERMISSN (permissions) file
Information on debugging login scripts
Information on registering your site with various networks

For using UUPC/extended
UUPC/extended
UUPC/extended, the Nutshell Handbook Using UUCP and
Usenet will be helpful; it includes a description of the various
end user commands such as UUSTAT and UUCP, topics which are not
covered in detail in this documentation. Information on these
commands is also available by reading the manual pages for these
commands on a real UNIX system.

Note:
Note:
Note: The MAIL command is not compatible with most UNIX mail
programs, and does come with its own help file,
MAIL.PRN.


Special Notes
Special Notes
Special Notes

Previous versions of UUPC/extended
UUPC/extended
UUPC/extended documented a mail server on
omnigate.clarkson.edu at Clarkson University which would test
your mail address by echoing your mail back to you. This server
This server
This server
is no longer available, and mail should not be sent to it.
is no longer available, and mail should not be sent to it.
is no longer available, and mail should not be sent to it.

In addition, previous versions of UUPC/extended
UUPC/extended
UUPC/extended also included a
file called simtel.inf
simtel.inf
simtel.inf which documented a mail server for
retrieving files via FTP at Princeton University; like the server
at omnigate, this server is no longer available, and mail should
this server is no longer available, and mail should
this server is no longer available, and mail should
not be sent to it.
not be sent to it.
not be sent to it.




- 5 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


Questions and Answers
Questions and Answers
Questions and Answers

Q. Does UUPC/extended
UUPC/extended
UUPC/extended support news?

A. Not at this time. Please do NOT send mail on this subject,
as support will be announced when available. If you need
news support in the present tense, try the shareware
packages WAFFLE or FSUUCP.

Q. UUPOLL takes over my entire system when it runs; can I run
it under DOS and still use the system?

A. No, but you can run it under MS-Windows 3.0 in 386 enhanced
mode, or under OS/2. DESQView should also work.

Q. It takes forever for the system to recongize a busy signal
on the other end. What can I do?

A. Not much, except use Windows or OS/2 to let your system
multitask. UUPC/extended
UUPC/extended
UUPC/extended is designed to run unattended, and
uses a simple input scanner to determine if the connection
has been made to reduce CPU contention on a multi-tasking
system; it is not designed for fast interactive response.
If you need to watch the system because you have to re-dial
after a busy signal, run UUSTAT with the -P option to create
a dummy poll file, and then run UUPOLL with a very short
poll interval and a target system of 'any' so that it keeps
trying until UUCICO gets through.

Q. Can UUPC/extended
UUPC/extended
UUPC/extended support multiple users on one system?

A. Yes. Each user should have an entry in the PASSWD file
(described above) and a copy of PERSONAL.RC under a unique
name in the UUPC/extended
UUPC/extended
UUPC/extended configuration directory; to switch
the active user, a short command file similar to the sample
SU.BAT file provided can be used to change the active user.
UUPC/extended
UUPC/extended
UUPC/extended cannot prevent users from reading other user's
mail or mail queued for another system. This is an MS-DOS
restriction.

Q. UUPC/extended
UUPC/extended
UUPC/extended will connect but will not exchange data with a
UNIX system; what's wrong?

A. Any number of things, which is why you should seek
additional information from either an UNIX guru or the
Nutshell Handbooks. However, one hint is that any programs
communicating via the UUCP "g" protocol must have a clean
eight bit connection; a seven bit even parity connection or
connection with flow control will ruin your whole day. If
you can login as a normal user to the remote system, you can
use the STTY command to determine the parity and flow
control settings.



- 6 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


Q. After UUPC/extended
UUPC/extended
UUPC/extended picks up my mail, UUXQT tries to deliver
it and fails with a message "PERMISSION DENIED". What's
wrong?

A. A good chance is that UUXQT cannot find RMAIL. Any program
invoked by UUXQT must be a .COM or .EXE file and must be in
the path. Placing a command in the directory UUXQT is
invoked from is not enough, because UUXQT changes
directories as it runs.

Q. Why doesn't UUPC/extended
UUPC/extended
UUPC/extended come with better documents?

A. UUPC/extended
UUPC/extended
UUPC/extended was originally maintained for low-cost
communications between Kendra Electronic Wonderworks
Kendra Electronic Wonderworks
Kendra Electronic Wonderworks and the
outside world; it was given away to the unsuspecting public
because that is how it was originally received.3 We are in
the process of updating the documents by both correcting
errors and omissions to existing topics and covering
additional topics. Please submit comments on suggested
changes of general interest to [email protected].

Note:
Note:
Note: When submitting documentation suggestions, please be
specific as possible; for example, suggesting that more
examples of the PERMISSN file is needed will not gain
as much attention as suggesting an example of using
LOGNAME= for an anonymous host in the PERMISSN file.

Q. UUPC/extended
UUPC/extended
UUPC/extended is wonderful, but it doesn't run on my (insert
non-IBM compatible platform here).

A. While the original UUPC was targeted for both the Mac and
Atari-ST into addition to the IBM, but Kendra Electronic
Kendra Electronic
Kendra Electronic
Wonderworks
Wonderworks
Wonderworks only supports the MS-DOS and OS/2 environments.
Conact Dave Platt , on where to
find his version UUPC for the Macintosh. There are no known
reliable sources for UUPC for the Atari-ST.

Q. Who is kendra?

A. Kendra means "womanly knowledge" in Old English.

kendra actually is an 80286 based Epson Equity III+ running
MS-DOS 5.0 and (once in a great while) OS/2 1.30.1 Standard
Edition; her modem and hostname are shared with her little
sister pandora, a Leading Edge Model M, so kendra sometimes
borrows the name of her other sibling, a mostly retired
Zenith Z-100 named the Fantasy Factory.

Q. And Kendra Electronic Wonderworks
Kendra Electronic Wonderworks
Kendra Electronic Wonderworks?

A. The Wonderworks is made up of kendra, Drew, Snuffles,
Katherine, a PO Box, a filing with the local town clerk, and
about 8000 hours put into UUPC/extended
UUPC/extended
UUPC/extended over two years.


- 7 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


Mailing List
Mailing List
Mailing List

A electronic mailing list, [email protected], is
open to those interested in UUPC/extended
UUPC/extended
UUPC/extended; to join it, send a
command of the following format in the body of a e-mail message
to [email protected]:

add user@node uupc-info

Where user@node
user@node
user@node is the Internet format of your address. (UUCP
addresses are not accepted by the List Server; such addresses
must be specified as an address via a major gateway such as
UUNET.) The List Server also accepts the command:

help

To resign from the mailing list, send mail to the List Server of
the following format:

delete user@node uupc-info

Note:
Note:
Note: Do not send requests to be added or deleted to uupc--
[email protected]; mail sent to this address is
automatically forwarded to all users on the list.
Questions of an administrative nature which require
human attention should be directed to
[email protected].

Since any undeliverable addresses cause mail to be bounced to the
list administrator, the administrator reserves the right to drop
any user from the list for whom mailis rejected. In many cases,
the user will not be notified, since the mail to notify the user
will bounce for the same reason the address was deletedin first
place.


Registering
Registering
Registering

It is now possible to register UUPC/extended
UUPC/extended
UUPC/extended; see the enclosed
register.prn
register.prn
register.prn for details.


Problems
Problems
Problems

Please report problems with this version of UUPC/extended
UUPC/extended
UUPC/extended via
electronic mail to [email protected]. If you are unable to reach
Kendra Electronic Wonderworks
Kendra Electronic Wonderworks
Kendra Electronic Wonderworks via electronic mail, mail your
problem report to:

Drew Derbyshire - UUPC/extended
UUPC/extended
UUPC/extended Help Desk
Kendra Electronic Wonderworks
Post Office Box 132
Arlington, MA 02174-0002


- 8 -


October 29, 1991 UUPC/extended
UUPC/extended
UUPC/extended 1.11m
1.11m
1.11m Overview


Please include with your problem description listings of the
files which apply, including:

UUPC.RC
PERSONAL.RC
SYSTEMS
Directory of your UUPC configuration directory.
A log of the applicable program execution, if any. Both
UUCICO and RMAIL automatically write logs into the
UUPC/extended
UUPC/extended
UUPC/extended spool directory.

Note:
Note:
Note: Passwords and userids can and should be changed in the
SYSTEMS file.

No claim is made that the problem will be corrected, or the
person reporting the problem will be supplied a copy of the
corrected code4, but reasonable efforts will be made to correct
the program. The Wonderworks does not provide formal telephone
support to unregistered users; we do answer the telephone during
waking hours, but because of cost considerations, your calls will
not be returned at our expense.

Questions related to support of news software for UUPC/extended
UUPC/extended
UUPC/extended
should be directed to [email protected].

PLEASE read the Nutshell handbooks before sending mail.



1Kendra Electronic Wonderworks has no connection with O'Reilly
and Associates. However, both of these books are on the
bookshelf here.

2These are available from your local bookstore or software house,
call them at 1-800-338-NUTS, or send them electronic mail at
[email protected].

3Which is to say, it was free and we were unsuspecting.

4Registered users will be provided an update when a fix becomes
available if they explicitly request it. See register.prn
register.prn
register.prnofr
details.













- 9 -