home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d152 / uucp.lha / UUCP / Readme < prev    next >
Text File  |  1987-06-15  |  9KB  |  228 lines
  1.                            AmigaUUCP
  2.  
  3.  
  4.  
  5.         Copyright 1988 by William Loftus.  All rights reserved.
  6.  
  7.  
  8. First -- I HOPE YOU'RE A UUCP EXPERT, because the documentation
  9. to learn UUCP is not contained here.  There is a good (?) book that
  10. describes UUCP and Usenet -- "Managing UUCP and Usenet," Tim
  11. O'Reilly and Grace Todino.  It is published by O'Reilly & Associates,
  12. Inc. -- 1-800-338-NUTS (cost is about $17.00).
  13.  
  14. This disk contains AmigaUUCP.   AmigaUUCP is a port of GNUUCP to the
  15. Amiga.  GNUUCP was based on uuslave.  In addition, many small support
  16. programs have been added.  This is version "BETA 0.30."  I hope
  17. that the first non BETA release will include software to connect to
  18. Usenet.  Currently, mostly mail is support (although netnews is not
  19. out of the question).
  20.  
  21. There are several files that are critical to the operation of AmigaUUCP.
  22. They are located in the "lib" directory on this disk.  Below is a short
  23. description of each file:
  24.  
  25.    L.sys  -- This file that contains the remote systems names, phone numbers,
  26.              login scripts, password, etc.  In short, this is the file that
  27.              has all the information needed to connect to remote sites.
  28.              Remote sites are the sites with which you will be exchanging mail
  29.              and news directly.
  30.  
  31.    config -- This file contains the name of your machine (node name), the
  32.              name of the user (it is assumed that only one person
  33.              will be using an Amiga for mail and news), the users real name,
  34.              a debugging level, etc..
  35.  
  36.    seq    -- This file contains a number that is used (and incremented)
  37.              for the creation of unique outgoing and incoming UUCP data files.
  38.  
  39.  
  40.  
  41. The first thing you must do is get a remote site that is willing to
  42. let you have UUCP access to their machine.  This can be your work machine,
  43. or a local university.
  44.  
  45. Next, you must add the appropriate data to the L.sys file (in the lib
  46. directory on this disk).  There are examples to follow in the L.sys
  47. file included on this disk.
  48.  
  49. Next, you must look at the modem.c file in the src/uucico directory.
  50. This file contains C code that controls the modem (just high level stuff).
  51. If your modem is not a HAYES compatible then you will have to modify the
  52. code, recompile modem.c (lc #?.c) and relink (blink with uucico.lnk).
  53. Sorry, but until I can abstract what is really needed for a lot of
  54. modems this part will have to be manually done.  I hope to write a small
  55. version of modemcap later.
  56.  
  57. Last, you have to make sure that the structure of this disk is intact. That
  58. means there needs to be a spool directory, mail directory, and a lib
  59. directory that can be referenced by UUCP:spool, UUCP:mail, and UUCP:lib.
  60. This disk is already setup in the correct fashion, but if you copy it
  61. to a hard disk you must assign UUCP: to the directory on the hard disk.
  62.  
  63. That's it.  Again the things you need to do before you can use
  64. AmigaUUCP:
  65.  
  66.    1) reconfigure the L.sys file to contain the machines YOU want to call.
  67.    2) change the uucp:lib/config file to suite your machine
  68.    3) recompile modem.c with the correct modem command
  69.    4) make sure UUCP: exists
  70.  
  71. Now you're ready.   Type "UUPOLL <system name>" and see what
  72. happens.
  73.  
  74. Programs included.
  75.  
  76.   uucico --  This program transmits files from your machine to
  77.              your host and back.  If no arguments are given, then
  78.              uucico will act as the slave (waiting for a call).
  79.              Before I go to work I type "brun uucp:c/uucico" and
  80.              then when I'm at work and something interesting comes
  81.              along I just "uucp" it to my Amiga.
  82.  
  83.              The stack must be set to 25000 to run this program.
  84.  
  85.              Usage: UUCICO [-x{0-9}] [-ssystemname]
  86.  
  87.              x - set debugging level.
  88.              s - call system.
  89.  
  90.   uucp --    This program queues files to be transferred to or
  91.              from a remote host.
  92.  
  93.              Usage: UUCP from_file to_file
  94.  
  95.              Example:
  96.  
  97.                  UUCP burdvax!/usr/spool/uucppublic/wpl/FILE df0:FILE
  98.  
  99.              This example will queue a request for a file on the machine
  100.              burdvax called /usr/spool/uucppublic/wpl/FILE to be
  101.              transferred to your Amiga and to be called df0:FILE.
  102.  
  103.              Example:
  104.  
  105.                  UUCP uucico.c burdvax!/usr/spool/uucppublic/wpl/uucico.c
  106.  
  107.              This example will put the file uucico.c (in the current working
  108.              directory) on machine burdvax in the directory
  109.              /usr/spool/uucppublic/wpl in a file named uucico.c.
  110.  
  111.              NOTE: transfers are done by uucico; uucp only queues
  112.              requests.
  113.  
  114.  
  115.   uuxqt  --  You should never have to execute this, since uucico will
  116.              do it for you, but if "X.#?" files exist in the
  117.              UUCP:spool directory, uuxqt should be run.  uuxqt figures
  118.              out what to do with the mail messages uucico transferred.
  119.  
  120.   uupoll --  This program will poll a system for mail and news (i.e
  121.              files to be transferred).  It starts up UUCICO with the
  122.              correct arguments in the background.
  123.  
  124.              Usage: UUPOLL <system-name>
  125.  
  126.   uuname --  This program will list the names of the systems that are
  127.              connect to your node (i.e. the systems listed in the L.sys
  128.              file).
  129.  
  130.   rmail  --  Mail coming into your system goes through rmail. Again
  131.              the system should handle running rmail.
  132.              Currently,  all mail coming into your Amiga will be
  133.              placed in the directory UUCP:mail in a file using the same
  134.              name as found on the To: field of the message.
  135.  
  136.   mail   --  Your link to the outside world.  Type mail<cr> to be prompted
  137.              for a out going mail message.   It uses old style UUCP
  138.              addressing (e.g., mach!mach!mach!mach!user).
  139.  
  140.   from   --  List the username and subject of all the mail messages for
  141.              the configured user in the UUCP:mail directory.
  142.  
  143.   readmsg--  This program will list a particular mail message.
  144.              For example:
  145.  
  146.                READMSG 3
  147.  
  148.              will print out mail message number 3.
  149.  
  150.  
  151. Other goodies included:
  152.  
  153.   vi     --  The latest version of DME (I call it vi).  You should
  154.              replace vi with your favorite editor.  The mail program
  155.              uses vi for editing your mail messages.
  156.  
  157.   compress, uuencode, uudecode, unshar, and tarsplit
  158.  
  159.          --  These programs are used to handle data transmitted
  160.              via UUCP connections.  I use tarsplit the most.
  161.  
  162.  
  163.  
  164. Also, all the programs in the C directory should remain there.  I know I
  165. should trust people to have them in there own C directory, but I don't.
  166. Various programs on this disk will reference these programs directly
  167. (e.g., brun and vi).  The compress program on this disk uses 16 bit
  168. compression as a default (not 14 that is usual on the Amiga).  I have
  169. a lot of ram (4.5 meg) so I can do it easily.  If you have problems you
  170. should use 14compress (this version uses the Amiga standard 14 bits for
  171. compression).
  172.  
  173. That's it for now.  Sorry for the lack of documentation, but this
  174. is a beta release.
  175.  
  176. Programs that are missing:
  177.  
  178.   uulog, uusnap, uucpanz, and a mail reader.
  179.   Usenet programs.
  180.  
  181.  
  182. Changes over BETA 0.20
  183.  
  184.   Uupoll, readmsg, from, and uuhosts programs added.
  185.   Locking is now done (i.e. you can't run two uucicos at once).
  186.   Bugs caused by short and long system names was squashed.
  187.   Bugs in the use of the timer device were squashed.
  188.   Reorganization of the system files (L.sys, config, seq now in
  189.     the lib directory, not spool).
  190.   The code for modem support was pulled into one file, so that
  191.     it can later be generalized.
  192.   Numerous little bugs squashed.
  193.   More documentation added (ha!).
  194.   Fixed bug with 3b2 UUCP connections (thanks erd!).
  195.   Added UUX command.
  196.  
  197. There will be another release soon that includes USENET news programs.
  198. Dan Schien and myself are currently working on these programs, and we
  199. currently have internal versions that will be ready for distribution soon.
  200.  
  201. I would really like to know the following information if you use
  202. AmigaUUCP:
  203.  
  204.   1) What modem are you using, and what changes (if any) to the modem.c
  205.      file did you make.
  206.  
  207.   2) What version of UUCP has AmigaUUCP talked to correctly? (i.e.,
  208.      what are you using AmigaUUCP with?)
  209.  
  210.   3) What Amiga configuration are you using?
  211.  
  212.   4) Any bugs.
  213.  
  214.  
  215. Any problems let me know.
  216.  
  217.   William Loftus
  218.   Unisys/Paoli Research Center
  219.   PO Box 517
  220.   Paoli, PA 19301-0517
  221.  
  222.   uucp:   wpl@burdvax.UUCP
  223.   arpa:   wpl@prc.unisys.com
  224.   Phone:  215-648-7248 (work) 215-354-0614 (home)
  225.  
  226.  
  227.  
  228.