AmigaUUCP Copyright 1988 by William Loftus. All rights reserved. First -- I HOPE YOU'RE A UUCP EXPERT, because the documentation to learn UUCP is not contained here. There is a good (?) book that describes UUCP and Usenet -- "Managing UUCP and Usenet," Tim O'Reilly and Grace Todino. It is published by O'Reilly & Associates, Inc. -- 1-800-338-NUTS (cost is about $17.00). This disk contains AmigaUUCP. AmigaUUCP is a port of GNUUCP to the Amiga. GNUUCP was based on uuslave. In addition, many small support programs have been added. This is version "BETA 0.30." I hope that the first non BETA release will include software to connect to Usenet. Currently, mostly mail is support (although netnews is not out of the question). There are several files that are critical to the operation of AmigaUUCP. They are located in the "lib" directory on this disk. Below is a short description of each file: L.sys -- This file that contains the remote systems names, phone numbers, login scripts, password, etc. In short, this is the file that has all the information needed to connect to remote sites. Remote sites are the sites with which you will be exchanging mail and news directly. config -- This file contains the name of your machine (node name), the name of the user (it is assumed that only one person will be using an Amiga for mail and news), the users real name, a debugging level, etc.. seq -- This file contains a number that is used (and incremented) for the creation of unique outgoing and incoming UUCP data files. The first thing you must do is get a remote site that is willing to let you have UUCP access to their machine. This can be your work machine, or a local university. Next, you must add the appropriate data to the L.sys file (in the lib directory on this disk). There are examples to follow in the L.sys file included on this disk. Next, you must look at the modem.c file in the src/uucico directory. This file contains C code that controls the modem (just high level stuff). If your modem is not a HAYES compatible then you will have to modify the code, recompile modem.c (lc #?.c) and relink (blink with uucico.lnk). Sorry, but until I can abstract what is really needed for a lot of modems this part will have to be manually done. I hope to write a small version of modemcap later. Last, you have to make sure that the structure of this disk is intact. That means there needs to be a spool directory, mail directory, and a lib directory that can be referenced by UUCP:spool, UUCP:mail, and UUCP:lib. This disk is already setup in the correct fashion, but if you copy it to a hard disk you must assign UUCP: to the directory on the hard disk. That's it. Again the things you need to do before you can use AmigaUUCP: 1) reconfigure the L.sys file to contain the machines YOU want to call. 2) change the uucp:lib/config file to suite your machine 3) recompile modem.c with the correct modem command 4) make sure UUCP: exists Now you're ready. Type "UUPOLL " and see what happens. Programs included. uucico -- This program transmits files from your machine to your host and back. If no arguments are given, then uucico will act as the slave (waiting for a call). Before I go to work I type "brun uucp:c/uucico" and then when I'm at work and something interesting comes along I just "uucp" it to my Amiga. The stack must be set to 25000 to run this program. Usage: UUCICO [-x{0-9}] [-ssystemname] x - set debugging level. s - call system. uucp -- This program queues files to be transferred to or from a remote host. Usage: UUCP from_file to_file Example: UUCP burdvax!/usr/spool/uucppublic/wpl/FILE df0:FILE This example will queue a request for a file on the machine burdvax called /usr/spool/uucppublic/wpl/FILE to be transferred to your Amiga and to be called df0:FILE. Example: UUCP uucico.c burdvax!/usr/spool/uucppublic/wpl/uucico.c This example will put the file uucico.c (in the current working directory) on machine burdvax in the directory /usr/spool/uucppublic/wpl in a file named uucico.c. NOTE: transfers are done by uucico; uucp only queues requests. uuxqt -- You should never have to execute this, since uucico will do it for you, but if "X.#?" files exist in the UUCP:spool directory, uuxqt should be run. uuxqt figures out what to do with the mail messages uucico transferred. uupoll -- This program will poll a system for mail and news (i.e files to be transferred). It starts up UUCICO with the correct arguments in the background. Usage: UUPOLL uuname -- This program will list the names of the systems that are connect to your node (i.e. the systems listed in the L.sys file). rmail -- Mail coming into your system goes through rmail. Again the system should handle running rmail. Currently, all mail coming into your Amiga will be placed in the directory UUCP:mail in a file using the same name as found on the To: field of the message. mail -- Your link to the outside world. Type mail to be prompted for a out going mail message. It uses old style UUCP addressing (e.g., mach!mach!mach!mach!user). from -- List the username and subject of all the mail messages for the configured user in the UUCP:mail directory. readmsg-- This program will list a particular mail message. For example: READMSG 3 will print out mail message number 3. Other goodies included: vi -- The latest version of DME (I call it vi). You should replace vi with your favorite editor. The mail program uses vi for editing your mail messages. compress, uuencode, uudecode, unshar, and tarsplit -- These programs are used to handle data transmitted via UUCP connections. I use tarsplit the most. Also, all the programs in the C directory should remain there. I know I should trust people to have them in there own C directory, but I don't. Various programs on this disk will reference these programs directly (e.g., brun and vi). The compress program on this disk uses 16 bit compression as a default (not 14 that is usual on the Amiga). I have a lot of ram (4.5 meg) so I can do it easily. If you have problems you should use 14compress (this version uses the Amiga standard 14 bits for compression). That's it for now. Sorry for the lack of documentation, but this is a beta release. Programs that are missing: uulog, uusnap, uucpanz, and a mail reader. Usenet programs. Changes over BETA 0.20 Uupoll, readmsg, from, and uuhosts programs added. Locking is now done (i.e. you can't run two uucicos at once). Bugs caused by short and long system names was squashed. Bugs in the use of the timer device were squashed. Reorganization of the system files (L.sys, config, seq now in the lib directory, not spool). The code for modem support was pulled into one file, so that it can later be generalized. Numerous little bugs squashed. More documentation added (ha!). Fixed bug with 3b2 UUCP connections (thanks erd!). Added UUX command. There will be another release soon that includes USENET news programs. Dan Schien and myself are currently working on these programs, and we currently have internal versions that will be ready for distribution soon. I would really like to know the following information if you use AmigaUUCP: 1) What modem are you using, and what changes (if any) to the modem.c file did you make. 2) What version of UUCP has AmigaUUCP talked to correctly? (i.e., what are you using AmigaUUCP with?) 3) What Amiga configuration are you using? 4) Any bugs. Any problems let me know. William Loftus Unisys/Paoli Research Center PO Box 517 Paoli, PA 19301-0517 uucp: wpl@burdvax.UUCP arpa: wpl@prc.unisys.com Phone: 215-648-7248 (work) 215-354-0614 (home)