UMS_UUCP V0.6 04.04.1993 This is an UUCP importer/exporter package for UMS V9. It contains all binaries and documentation to run a *minimum* UUCP node with UMS. If you need more features, please get the AmigaUUCP 1.16 package. You only need to replace the uuxqt binary in that package with the UMS uuxqt. Files: bin (dir) testaddress ums2uucp uucico uucico116a uuxqt docs (dir) L.Sys Security UUcico uucico116a.doc lib (dir) config L.sys security History ums_uucp.doc Directory "bin" This directory does contain the UUCP binaries. "uucico" handles all outgoing calls (taken from AmigaUUCP 1.16). "uucico116a" is a improved version of this program with some extended features (see docs/uucico116a.doc). "uuxqt" is the UMS importer, which will be called by "uucico" if new files have been received. "ums2uucp" is the UMS exporter, which you must execute before a call to remote node to export all mail and news for this system. "testaddress" lets you test RFC addresses (only useful for debugging). Directory "docs" This directory does contain some documents from the AmigaUUCP 1.16 package. Please read them if you have a question which is not answered by this document. Directory "lib" Sample UUCP configuration files. Installation: - Think up a node name for your machine, like "foobar". This name should be no longer than 7-8 characters. Set the UMS config variable "uucp.nodename" to this name. - Get a domain name for your machine. Set the UMS config variable "uucp.domainname" to the domain name of your machine. - If your node name is registered in the UUCP maps, then set the UMS config variable "uucp.pathname" to the node name. If it is not registered, then set this variable to the domain name. - Add the alias "postmaster" to a user entry. This user will receive all error mails from uuxqt. - Add the assigns for "UUSPOOL:"/"UUPUB:"(/"UULIB:") to your s:user-startup. * UUSPOOL: points to a directory, where all incoming/outgoing data is stored. * UUPUB: is the public directory, which can be accessed by other machines * UULIB: contains the configuration files - Copy the files from "lib" to UULIB:. Install the files from "bin" in one of the directories in your command path. - Edit UULib:config. You normally only need to set the node name and the path for UULIB: (if you don't want to assign it). Copy this file to S:UUConfig. - Get in contact to the sysop of another UUCP node, who is willing to let your machine receive/sent mail and news from/to his node. You will get a user name and a password for this machine. He will tell you in which format his node will send the data. The current version of uuxqt can handle the following formats: * Unbatched and uncompressed Mail (command: "C rmail user") * Batched SMTP Mail (command: "C rsmtp") * Batched SMTP Mail (compressed) (command: "C rcsmtp") * Batched SMTP Mail (frozen) (command: "C rfsmtp") * (Un)batched and (un)compressed/frozen News (command: "C rnews") With or without "#! cunbatch"/"#! funbatch" header lines. uuxqt *NEEDS* the Amiga binaries "compress"/"freeze" to handle compressed or frozen data files. - Obtain the same information for sending mail and news to the other UUCP node. This information must be stored in the following two UMS config variables: * uucp.mailexport information about mail export * uucp.newsexport information about news export The values for both variables must conform to the following syntax: , , | | | | | --- Number of bytes for one batch (Default: 65536) | ---------------- Compress command id (Default: None) | 0 - none, 1 - compress, 2 - freeze | 3 - cbatch 4 - fbatch -------------------------- Batch? y,Y - Yes; n,N - No (Default: No) The compress commands "cbatch/fbatch" are ignored for mail export. Examples: * uucp.mailexport=N Not batched * uucp.newsexport=Y,3 Batched & compressed (cbatch), 64K batches * uucp.mailexport=Y,2,100000 Batched (BSMTP) & frozen, 100K batches ums2uucp *NEEDS* the Amiga binaries "compress"/"freeze" to create compressed or frozen data files. - If the other node uses outdated or dumb UUCP software, which relies on the information in the UUCP mail envelope (RFC976 format) instead of parsing the RFC822 header, you must to set the UMS config variable "uucp.dumbhost" to "Y". The exporter will then create UUCP mail envelopes in the RFC976 format. - Every UMS user entry, which wants to write UUCP mails & news, must have an additional UMS config variable "uucp.username" in his entry. This variable contains the "account" name for this user, which will be used to build his domain EMail address. In order to get replies, this "account" name should also be an alias name for the user. - Add the information about the other UUCP node to the UULIB:L.sys file (see docs/L.sys) - Create a UMS importer/exporter entry for this node. The name for this new entry is "uucp.". One UUCP importer/exporter entry *MUST* have an alias for "uucp.default", or otherwise uuxqt can't access the config variables. Use the "writeaccess" entry to suppress the creation of new groups through unwanted crosspostings. - Before calling the remote node, you must call the UMS exporter to export the mail and news for the other system. Use "ums2uucp -s". - Now you should be able to call the other node with "uucico -s". Please look into the docs for uucico on how you can tune the transfer rate with its options. ----------------------- Sample UMS config for UMS_UUCP ------------------ ; Our node name uucp.nodename = foobar ; Our path name ; Path name for registered UUCP nodes (= node name) uucp.pathname = foobar ; Path name for non-registered UUCP nodes (= domain name) ;uucp.pathname = foobar.earth.net ; Our domain name uucp.domainname = foobar.earth.net ; Add an alias "postmaster" for the sysop user ... alias = postmaster ... enduser ; Add an alias & "account" name to a user ; His EMail address is "jduser@foobar.earth.net" user name = "Joe D. User" ... alias = jduser uucp.username = jduser ... enduser ; Sample UMS_UUCP importer/exporter entry for UUCP node "bbrother" (Default) ; News export: Batched & compressed (cbatch), 64K batches. ; Don't export mail to the "*.edu" domain to this system. ; Mail export: Not batched. user name = uucp.bbrother priority = -20 writeaccess = #? readaccess = #? netaccess = #? distribution = #? import = #? export = ~(#?.edu) alias = uucp.default uucp.mailexport = N uucp.newsexport = Y,3 enduser ; Sample UMS_UUCP importer/exporter entry for UUCP node "dummy" ; Only import news from the "comp.sys.amiga.*" groups. This suppresses ; the creation of new newsgroups through crosspostings. ; Only export news from the "comp.sys.amiga.*" groups. ; News export: Batched & frozen, 100K batches. ; Only export mail to the "*.edu" domain through this system. ; Mail export: Batched (BSMTP) & frozen, 64K batches. user name = uucp.dummy priority = -20 writeaccess = comp.sys.amiga.#? readaccess = comp.sys.amiga.#? netaccess = #? distribution = #? import = #? export = #?.edu uucp.mailexport = Y,2 uucp.newsexport = Y,2,100000 enduser ; Sample UMS_UUCP importer/exporter entry for UUCP node "dumb" ; This host uses outdated UUCP software, so uucp.dumbhost is set. ; No news export or import user name = uucp.dumb priority = -20 writeaccess = % readaccess = % netaccess = #? distribution = % import = #? export = #?.dummy.dumb.org uucp.mailexport = N uucp.dumbhost = Y enduser ----------------------- Sample UMS config for UMS_UUCP ------------------ Environment variables: - "UMSUUCP.mb" name of the UMS message base to use for import (default: default message base) Credits: The sources for uuxqt are loosely (very loosely!) based on: - AmigaUUCP/rmail.c V1.15, (c) Matt Dillon - AmigaUUCP/rnews.c V1.15, (c) Matt Dillon - AmigaUUCP/uuxqt.c V1.16, (c) William Loftus & Matt Dillon - ums/rmail.c V0.2a, (c) Christian Rütgers - ums/rnews.c V0.3, (c) Christian Rütgers - bsmtp/RxSMTP.rexx V1.3, (c) Georg Sassen & Christian Balzer The sources for AmigaUUCP compatibility where taken from the 1.16 distribution. Send bug reports to: stefanb@pool.informatik.rwth-aachen.de stefanb@yello.adsp.sub.org