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.DOC < prev    next >
Text File  |  1990-09-09  |  15KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.      September 9, 1990                           UUPC/extended 1.08a README
  6.  
  7.      Revision:
  8.      
  9.      This document applies to UUPC/extended version 1.08a, and was
  10.      formatted on September 9, 1990 at 17:41:39.
  11.      
  12.      Introduction:
  13.      
  14.      This document provides information on installing UUPC/extended 1.08a,
  15.      (refered to in this document as UUPC/extended).  UUPC/extended is
  16.      based on the widely distributed interim version of UUPC, version 1.05,
  17.      written by Stuart Lynne, Richard H. Lamb, and Samuel Lamb, in
  18.      Vancouver, BC.  UUPC is no longer maintained in Vancouver;
  19.      UUPC/extended  1.08a is the official current release.
  20.      
  21.      The differences between UUPC/extended and UUPC version 1.05 include
  22.      user aliases, routing to multiple hosts, dial in support, limited
  23.      domain address parsing and routing, and various improvements in the
  24.      user interface.  Because of these changes, much of what is contained
  25.      in this document does not apply to the original UUPC 1.05 package.
  26.      
  27.      UUPC/extended is written in Borland Turbo C++ 1.0, with one additional
  28.      module in 8086 Assembler (MASM).  This documentation is written in a
  29.      derivative of the SCRIPT document composition language.
  30.      
  31.      Copyright:
  32.      
  33.      Portions of this software are copyrighted by the following persons:
  34.      
  35.  
  36.           Copyright (c) Richard H. Lamb 1985, 1986, 1987
  37.  
  38.           Copyright (c) Samuel Lamb 1987
  39.  
  40.           Changes Copyright (c) Stuart Lynne 1987
  41.  
  42.           Changes Copyright (c) Andrew H. Derbyshire 1989, 1990
  43.      
  44.      Additional thanks go to Wolfgang Tremmel, Jordan Brown, John DuBois,
  45.      and Phillip Meese.
  46.      
  47.      This documentation is Copyright (c) 1989, 1990 Andrew H. Derbyshire.
  48.      
  49.      The runtime libraries for Turbo C++ are Copyright (c) 1986, 1990, by
  50.      Borland International, and are used by permission.
  51.      
  52.      This software may be used and copied freely so long as the applicable
  53.      copyright notices are retained, but no money shall be charged for its
  54.      distribution beyond reasonable handling costs, nor shall proprietary
  55.      changes be make to this software so that it cannot be distributed
  56.      freely.
  57.      
  58.  
  59.  
  60.  
  61.  
  62.                                      - 1 -                                 
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      September 9, 1990                           UUPC/extended 1.08a README
  72.  
  73.      Warranty Information:
  74.      
  75.      This software is distributed on a "as-is" basis, without any warranty,
  76.      expressed or implied.  Use of this software and the associated
  77.      documentation is at your own risk.
  78.      
  79.      Function:
  80.      
  81.      UUPC/extended is a PC based version (and pun of) UUCP (UNIX-to-UNIX
  82.      copy).  UUPC/extended allows a MS-DOS based Personal Computer to
  83.      exchange mail and files with a UNIX system or other UUPC/extended
  84.      system over dial up or dedicated phone lines using the UUCP "g"
  85.      protocol.
  86.      
  87.      System requirements:
  88.      
  89.      The following required to set up a PC to use UUPC/extended:
  90.  
  91.        1. An IBM-PC or compatible system with at least 256K of RAM.
  92.  
  93.        2. A modem connected to a telephone line.  Special support exists in
  94.           UUPC/extended for Hayes compatible modems.
  95.  
  96.        3. 300K of free space on your hard drive.1
  97.  
  98.      
  99.      Suggested reading:
  100.      
  101.      Using UUCP and Usenet and Managing UUCP and Usenet, both by O'Reilly
  102.      and Associates.2 These are available from your local bookstore or
  103.      software house, or call them at 1-800-338-NUTS.  These books make no
  104.      mention of UUPC/extended, but do explain the details of Usenet and the
  105.      general format of many of the files (especially the SYSTEMS file) that
  106.      UUPC/extended uses.
  107.      
  108.      Installing UUPC/extended:
  109.      
  110.      Each file that must be customized for UUPC/extended has comments in it
  111.      describing the information that goes in the file.  The general
  112.      procedure for installing UUPC/extended is as follows:
  113.  
  114.        1. Choose a host name for your system, and user id for yourself.
  115.  
  116.        2. Get the phone number, user id & password, and login procedure for
  117.           the system that will act as your mail server.
  118.  
  119.        3. Copy the MAIL.EXE, UUIO.EXE, and UUPOLL.EXE files to a directory
  120.           in your path.
  121.  
  122.                             ------------------------                       
  123.      1Use of a floppy based system is possible, but will greatly increase
  124.       the time to transfer a file.
  125.      2The author has no connection with O'Reilly and Associates.  However,
  126.       both of these books are on my bookshelf.
  127.  
  128.                                      - 2 -                                 
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      September 9, 1990                           UUPC/extended 1.08a README
  138.  
  139.        4. Customize the UUPC.RC file, and copy it to the directory defined
  140.           in the file as the 'ConfDir' within the file.
  141.  
  142.        5. Customize the SYSTEMS file and copy it to the 'ConfDir' directory
  143.           defined in UUPC.RC.
  144.  
  145.        6. If and only if other systems are going to call you, customize the
  146.           PASSWD file, and copy it to the 'ConfDir' directory defined in
  147.           UUPC.RC.
  148.  
  149.        7. Copy MAIL.HLP and TILDE.HLP to the 'ConfDir' directory defined in
  150.           UUPC.RC.
  151.  
  152.        8. If special routing is required for hosts, customize the HOSTPATH
  153.           file, and copy it to the 'ConfDir' directory defined in UUPC.RC.
  154.           This is not usually needed.
  155.  
  156.        9. Customize the PERSONAL.RC file, and copy it to the 'ConfDir'
  157.           directory defined in UUPC.RC.
  158.  
  159.       10. Customize the PERSONAL.SIG file, and copy it to the 'Home'
  160.           directory defined in PERSONAL.RC.3
  161.  
  162.       11. Customize the ALIASES.TXT file, and copy it to the directory
  163.           defined in the PERSONAL.RC file as your Home directory.
  164.  
  165.       12. Edit your AUTOEXEC.BAT, adding SET commands for the variables
  166.           UUPCSYSRC, the fully qualified name of your UUPC.RC file,
  167.           UUPCUSRRC, fully qualified name of your PERSONAL.RC file, for TZ,
  168.           your local time zone.  Sample TZ variable SET commands are as
  169.           follows:
  170.           
  171.                     SET TZ=EST5EDT or       (Eastern Time, 5 hours behind GMT)
  172.                     SET TZ=CST6CDT or                      .
  173.                     SET TZ=MST7MDT or                      .
  174.                     SET TZ=PST8PDT or       (Pacific Time, 8 hours behind GMT)
  175.                     SET TZ=GMT0             (GMT, no offset, no daylight savings)
  176.           
  177.           Time zones ahead of GMT should use a minus size in front of the
  178.           hours offset.
  179.  
  180.       13. Test the system by sending mail to yourself (see below).
  181.  
  182.      
  183.      Syntax:
  184.      
  185.      To obtain the syntax of the various commands, enter the command name
  186.      followed by '-?'; for example:
  187.      
  188.                mail -?
  189.                             ------------------------                       
  190.      3If this file is not installed, then the line in the PERSONAL.RC file
  191.       describing it must be commented out with a pound sign (#) in column
  192.       1.
  193.  
  194.                                      - 3 -                                 
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      September 9, 1990                           UUPC/extended 1.08a README
  204.  
  205.                uuio -?
  206.                uupoll -?
  207.      
  208.      For a listing of the commands available when readng mail, see the file
  209.      MAIL.HLP in the configuration directory; for commands available when
  210.      reading mail see the file TILDE.HLP in the configuration directory
  211.      Using UUPC/extended:
  212.      
  213.      Note:  These are general instructions, and you may require additional
  214.             assistance if you have never used a UNIX-like mail system
  215.             before.
  216.             
  217.      The components of UUPC/extended are used as follows:
  218.  
  219.        1. To send mail, with the body of the message being typed in from
  220.           the PC keyboard:
  221.           
  222.           MAIL -s "the subject" address1 address2 ...  Where "the subject"
  223.           is the topic of the message, enclosed in quotes; if the subject
  224.           is omitted, then the '-s' flag should be omitted as well.
  225.           
  226.           Addresses are in the form user@node, node!user, localuser, or
  227.           nick, where nick is a nickname in your aliases.txt file.  The
  228.           flags '-c' and '-b' may also be inserted between addresses; all
  229.           addresses after '-c' are sent as Carbon copies, and addresses
  230.           following '-b' are Blind Carbon copies (and not displayed in the
  231.           header of the message).   Thus, a valid mail command may be:
  232.           
  233.           mail -s "Hello" help@kendra.kew.com echo@omnigate.clarkson.edu
  234.           
  235.           The mail program will then prompt you for the message to be
  236.           sent.  Note that ~? may be entered for commands available when
  237.           entering the mail.
  238.           
  239.           Note that this only queues the mail for sending if it is going to
  240.           another system connected via a modem; UUIO (below) must be
  241.           invoked to actually transfer the mail to the other system.
  242.  
  243.        2. To send mail which already exists in a file, the procedure is as
  244.           above, but the standard syntax for MS-DOS file redirection is
  245.           added to the end of the command line:
  246.           
  247.           MAIL -s "the subject" address1 address2 ... < filename
  248.  
  249.        3. To read your new mail, enter the command:
  250.           
  251.           MAIL
  252.           
  253.           If you do not have a mailbox, your mail is being forwarded, or
  254.           the mailbox is empty, MAIL will report this fact and exit.  If
  255.           you have mail, the program will animate an asterisk for each
  256.           message in the mailbox, display the subjects of all the messages,
  257.           and then prompt you with the message number you are on and a
  258.           question mark (?).  For a list of commands within MAIL, enter a
  259.  
  260.                                      - 4 -                                 
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      September 9, 1990                           UUPC/extended 1.08a README
  270.  
  271.           question mark at the prompt (?); to exit MAIL, enter 'q' at the
  272.           prompt.
  273.  
  274.        4. To read mail saved in other than your mailbox, enter:
  275.           
  276.           MAIL -f filename
  277.           
  278.           Where filename is the file to be processed for mail.  This may be
  279.           the file you specified to store outgoing mail in, or mail you
  280.           saved into another file when reading your new mail.
  281.           
  282.           Note that when reading or saving mail, use of the equals sign (=)
  283.           in front of a file name directs MAIL to look for the specified
  284.           file in your home directory, the path of which was specified in
  285.           your PERSONAL.RC file.
  286.  
  287.        5. To make UUIO call your mail server to deliver and pickup remote
  288.           mail:
  289.           
  290.           UUIO -s all
  291.           
  292.           This will make UUIO poll all the systems listed in the SYSTEMS
  293.           file.
  294.  
  295.        6. To make UUIO wait for an incoming call:
  296.           
  297.           BREAK ON
  298.           UUIO
  299.           
  300.           UUIO will wait for a successful telephone call, and exit upon
  301.           completion; UUIO may be terminated by entering Cntrl-Break from
  302.           the keyboard.4
  303.  
  304.        7. To use UUPOLL to have UUIO call out on a regular basis:
  305.           
  306.           UUPOLL -f 0240 -i 0600
  307.           
  308.           This will cause UUIO to call out at 2:40 A.M. and every six hours
  309.           thereafter until the user presses Cntrl-Break.  Both flags are
  310.           specified as hhmm (hours and minutes).
  311.  
  312.        8. To use UUPOLL to have UUIO call out on a regular basis, and
  313.           automatically answer the telephone between outgoing calls:
  314.           
  315.           UUPOLL -f 0240 -i 0600 -r 0
  316.           
  317.           This will cause UUIO to call out at 2:40 A.M. and every six hours
  318.           thereafter until the user presses Cntrl-Break, and in addition
  319.           UUIO will be invoked in passive mode to answer the telephone
  320.           between outgoing calls.
  321.                             ------------------------                       
  322.      4The BREAK ON command is required to insure that MS-DOS polls the
  323.       keyboard for the Cntrl-Break sequence; otherwise, you may have to
  324.       reboot your system to terminate UUIO.
  325.  
  326.                                      - 5 -                                 
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      September 9, 1990                           UUPC/extended 1.08a README
  336.  
  337.      
  338.      Problems:
  339.      
  340.      PLEASE read the Nutshell handbooks before sending mail about
  341.      problems.
  342.      
  343.      Please report problems with this version of UUPC/extended via E-mail
  344.      to help@kendra.kew.com.  If you are unable to reach kendra via e-mail,
  345.      mail your problem report to:
  346.      
  347.                Drew Derbyshire
  348.                UUPC/Extended Help Desk
  349.                108 Decatur Street, Apt 9
  350.                Arlington, MA 02174
  351.                
  352.      Please include with your problem description listings of:
  353.  
  354.        1. AUTOEXEC.BAT
  355.  
  356.        2. CONFIG.SYS
  357.  
  358.        3. UUPC.RC
  359.  
  360.        4. PERSONAL.RC
  361.  
  362.        5. Directory of your UUPC configuration directory.
  363.  
  364.      
  365.      No claim is made that the problem will be corrected, or the person
  366.      reporting the problem will be supplied a copy of the corrected code,
  367.      but reasonable efforts will be made to correct the program.
  368.      
  369.      I do not provide formal telephone support; I do answer my telephone,
  370.      but because of cost considerations, your calls will not be returned at
  371.      my expense.  Nor do I provide help in setting up systems, if you can't
  372.      call it a bug please don't tell me about it.
  373.      
  374.      Where to get new versions:
  375.      
  376.      UUPC/extended is available on the Internet from SIMTEL20.ARMY.MIL, via
  377.      anonymous FTP; it is located in directory PD2:<MSDOS2.UUCP>.  It is
  378.      also available from the Clarkson University HUG Bulletin Board,
  379.      315-268-6667, file area 4. UUPC/extended is NO LONGER available from
  380.      kendra.
  381.      
  382.      In general, the files for UUPC/extended are distributed in two files:
  383.  
  384.        *  UUPCxxxU.ZIP contains the files a user needs to run
  385.           UUPC/extended, including the executables, formatted
  386.           documentation, and sample configuration files.
  387.  
  388.        *  UUPCxxxS.ZIP contains the files needed to build UUPCxxxU.ZIP,
  389.           including the source to UUPC, MAKE and TLINK input files, the
  390.           unformatted documents, and sample configuration files.
  391.  
  392.                                      - 6 -                                 
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.      September 9, 1990                           UUPC/extended 1.08a README
  402.  
  403.      
  404.      In both of the above names, "xxx" is the release/revision number.
  405.      
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                                      - 7 -                                 
  459.  
  460.  
  461.  
  462.  
  463.