home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / mercury / english.doc < prev    next >
Text File  |  1992-01-25  |  15KB  |  428 lines
  1.                                               Stuttgart, 5. 9. 1990
  2.  
  3. Hi Netlanders,
  4.  
  5. Feel free to copy Mercury UUCP and to redistribute it. Please maintain
  6. the given file structure, and do only pass the complete distribution
  7. file/disk on to other people. I encourage you to have the files put to
  8. archive-servers, BBS systems and so on, or to distribute them via any
  9. kind of networks.
  10.  
  11. I forbid to pass Mercury UUCP to organizations, that gain money from
  12. distributing Shareware or Public-Domain-Software. I further do not
  13. allow these organizations to distribute Mercury UUCP.
  14.  
  15. -Rod
  16.  
  17.                          ---------------
  18.  
  19.  
  20.                                       Freitag, 31. August 1990 2:06 AM
  21. Hello ya all, out there on the net!
  22.  
  23. Okay; I'll try to write a short description of "Rodney's UUCP modules".
  24. Cos I just made rmail handle domain-routing and the rest of these
  25. routing-algorithms right, I won't spend more than an hour for it.
  26. I'm listening to Dire Strait's "Brothers in arms" and am very tired.
  27. Hmm, now that I'm talking about myself: I'm 18 years old, so just call
  28. me "Rod" - (not "Mr. Volz" or some similar strange things) if you phone
  29. me or write postcard to me. Thankya.
  30.  
  31. My english is not very well. Don't blame me, blame my english-teacher
  32. (the ones who know me personally, probably know what I'm talking
  33. about). What I wanna say: don't expect me to fullfill wonders!
  34.  
  35. Let's begin.
  36.  
  37. "Mercury UUCP" (how I first called the stuff) or "Rodney's UUCP
  38. Modules" which is the current name,  has it's origin in the fact that
  39. there was no mail- and news-handling package for the ST, when I got
  40. fascinated by usenet and mail and all. Once when I talked to a friend
  41. who told me about the exciting world of usenet, I decided to write on
  42. my own what I was looking for. Guess that was a mistake. :-) Mercury is
  43. (except uucico) written in K&R C - without indecent things such as
  44. prototype declarations.
  45.  
  46. Mercury UUCP is shareware, so I'd appreciate to see my bank account
  47. raise a bit sometimes. I had to call Aragon, Delos and other sites here
  48. in germany many times to test uucico, and that made my phone charges go
  49. higher and higher. I felt that 50 german Mark or alternatively $40
  50. would be a reasonable amount, which really anyone should be able to
  51. pay. Don't misunderstand me; I'll take even Escudos or Rubel...
  52.  
  53. My Account no. in germany is:
  54.  
  55. Account 371 22 61
  56. at the "Landesgirokasse" in Stuttgart,
  57. BLZ or Bank code 600 501 01.
  58.  
  59. For it may be complicated to remit money from other countries to
  60. germany, I'll tell you my adress. It would also be nice of you guys out
  61. there, if some people who perhaps can't pay the money for some reason
  62. would send me at least a picture postcard. I'm always interested in how
  63. much people use the stuff.
  64.  
  65. my address is:
  66.  
  67. Rodney Volz
  68. Klugestrasse 12
  69. 7000 Stuttgart 1
  70.  
  71. my international phone number is: +49 711 651864
  72.  
  73. In the US for example you'd have to dial "01149 711 651864". Within
  74. germany, just dial "0711 651864". Feel free to call me any time you
  75. want. At night I might be sleeping and have disabled the phone ringer.
  76. But don't worry...
  77.  
  78.  
  79. Concept of Mercury UUCP
  80. -----------------------
  81.  
  82. All files, as there are mail messages and news articles, are first
  83. placed into something called "mailqueue". Then, other programs pick
  84. them up and put them where they belong to.
  85.  
  86. All main configuration data is put in a file named "config.sys". This
  87. file has to be put in the folder "\etc" or "\mercury" of drive C, D, E
  88. or A. The best idea is to put it in the \etc folder of the partition
  89. you run Mercury UUCP from. Now, I'll show you my config-file, and try
  90. to tell ya after each line, what it means.
  91.  
  92.  
  93. 0001 "D:"                               # System-drive
  94.  
  95. That's the name of the partition where you wanna put Mercury UUCP.
  96. Don't append a backslash at the end of the drive id; just use
  97. "D:" or "A:" or something like that.
  98.  
  99.  
  100. 0002 "merkur"                           # Sitename
  101.  
  102. The name you wanna call your host.
  103.  
  104.  
  105. 0003 "HD Crashtest Center"              # Organisation
  106.  
  107. Your organization line. If you dunno what to put in here,
  108. just leave it as it is.
  109.  
  110.  
  111. 0004 ".gtc.de"                          # Domain
  112.  
  113. Important! Here you should put the name of your domain. For
  114. example, if uunet should come to use an ST someday, they
  115. would have to insert ".uu.net" here. If you dunno what to
  116. write in here, insert ".UUCP".
  117.  
  118.  
  119. 0005 "D:\usr\adm"                       # Logfile-Directory
  120.  
  121. A directory, where our log-files go to. Create it on your
  122. Merucry-partition, and insert it's name her.
  123.  
  124.  
  125. 0006 "postmaster"                       # Postmaster-Account.
  126.  
  127. Every unix-machine should have a postmaster who's reliable for
  128. mailing problems. Choose a name for him here (or leave it
  129. unchanged).
  130.  
  131.  
  132. 0007 "D:\bin.uu\uucico.prg"             # uucico
  133.  
  134. uupoll has got to know, where to find uucico.prg. Tell it, and don't
  135. forget the extension!
  136.  
  137.  
  138. 0008 "D:\usr\bin\c16.ttp"               # Compress
  139.  
  140. Rnews and batch will be looking for Mercury's 16bit-compress. Insert
  141. it's name with full path and extension here.
  142.  
  143.  
  144. 0009 "D:\etc\passwd"                    # Password-File
  145.  
  146. The password-file. Ya know /etc/passwd on unix-machines? Something made
  147. me think it would be the best idea to have an equivalent to it. Look
  148. into my passwd-file, and try to understand it (shouldn't be difficult).
  149. Ahm, by the way: the one you have entitled to be your postmaster has to
  150. have an entry ("account") in here!
  151.  
  152.  
  153. 0010 "2"                                # Redial-counter for uucico
  154.  
  155. How many times do you want uucico to redial, if the remote host should
  156. be busy? A value of 2 will result in a max. of three attempts: first
  157. call, and two re-trys.
  158.  
  159.  
  160. 0011 "D:\bin.uu\mail.prg"               # Mailer
  161.  
  162. Location of "mail.prg". Don't try to insert "elm" here, it won't
  163. cause anything but trouble.
  164.  
  165.  
  166. 0012 "D:\usr\lib\news\active"           # Active-file for newsgroups
  167.  
  168. This file determines, which newsgroups to accept, and which
  169. to send to "junk". If you don't come along with creating
  170. an aproppriate active-file, just leave it away.
  171.  
  172.  
  173. 0013 "D:\usr\lib\news\sys"              # Sys-File
  174.  
  175. Here you have to determine, which host you want to give which
  176. news, and how you want to compress the news.
  177.  
  178. delos:comp,rec,alt,!alt.flame:c13
  179.  
  180. ...means: your host will spool comp, rec and alt (except alt.sex)
  181. to delos, and will compress with 13 bit.
  182.  
  183. Another example:
  184.  
  185. delos:all:c16
  186.  
  187. will grant a full news-feed to delos, and will run compress with full
  188. 16 bit. If you put a percent-sign before a newsgroup's name, only
  189. locally posted articles will be spooled to the concerned host. Example:
  190. "delos:%all:c16". The sys-file may contain empty lines and remarks. The
  191. latter ones have to be preceeded by a "#". If an entry for a system is
  192. becoming too long, just break it into two or more lines with a backslash:
  193.  
  194. delos:rec.arts.poems,alt.cyberspace,dnet.general,foo.bar.useless,\
  195. comp.sys.trarari.st:c16
  196.  
  197.  
  198. 0014 "D:\usr\spool\mqueue"              # Mailqueue
  199.  
  200. The mail-queue-directory I talked about in the above. It's
  201. a directory, you have to create.
  202.  
  203.  
  204. 0015 "D:\etc\hosts"                     # Host-File
  205.  
  206. Hmm, another one of this non-standard-but-complicated files.
  207.  
  208. This is a part of my hosts-file:
  209.  
  210. delos|atx4b0e0|ANY|2400|7288526|ogin:|uumerkur|ssword:|foobar|D:\usr\spool\uucp\delos
  211. aragon|atx4b0e0|ANY|2400|0703136724|ogin:|umerkur|ssword:|foobar|D:\usr\spool\uucp\aragon
  212.  
  213. The meaning of the fields is:
  214.  
  215. - Name of the host you wanna call
  216. - Modem init string. Just leave it as it is!
  217. - Time to call. A value like "18:27" will cause uucico to wait until
  218.   18:27 before calling a system. "ANY" should be reasonable.
  219. - Baudrate
  220. - The phone number of the host you wanna call. If you use
  221.   touch-tone dialing, feel free to start the number with a "t". ;-)
  222. - A string we expect, before sending the next field's content.
  223. - Login name
  224. - A second string we expect, before sending next field's content.
  225. - our password for the remote host
  226. - The spooldirectory for our remote host. You'll have to create
  227.   a spooldirectory for every host you want to call.
  228.  
  229. That's it! Ahm, yeah: the hosts file may only contain up to 20 lines.
  230.  
  231.  
  232. 0016 ""                                 # Reserved for future use
  233.  
  234. Currently unused.
  235.  
  236.  
  237. 0017 "aragon"                           # General relay host
  238.  
  239. Here you should have to insert the name of a host called by you,
  240. which you consider to be a good mail router. Rmail will send
  241. your mail messages to this host, if it doesn't know how to
  242. route 'em.
  243.  
  244.  
  245. 0018 "E:\news"                          # News-Directory
  246.  
  247. In this directory (which you have to create) rnews will create (itself
  248. - wow!) a file- and directory-structure similar to to /usr/spool/news
  249. on unix-systems running news211.
  250.  
  251.  
  252. 0019 "D:\usr\lib\mail\mydomain"         # File discribing our domain(s)
  253.  
  254. This (mandatory) file has to contain the name of the domain
  255. you belong to. If you belong to more than one domain, your domain-file
  256. may look like:
  257.  
  258. .uu.net
  259. .chi.il.us
  260. .edu
  261. .nasa.cia.kgb.mil.gov
  262.  
  263.  
  264. 0020 "D:\bin\me.prg"                    # Default-Editor
  265.  
  266. Your favourite text editor. I use Micro-Emacs.
  267.  
  268.  
  269. 0021 "D:\usr\tmp"                       # Temp-Directory
  270.  
  271. We need a directory where we can put our trash...
  272.  
  273.  
  274. 0022 "D:\usr\lib\mail\paths"            # Paths-file for rmail
  275.  
  276. Rmail uses this (unix-compatible) file to find a fast path to a target
  277. host. You should create this file using "pathalias" on a unix system.
  278.  
  279. pathalias -l [your_hostname] <map_data >paths
  280.  
  281. ...should work. But be careful: It's better to leave away the
  282. paths-file, than using an old - or worse - a wrong one.
  283.  
  284.  
  285. 0023 "D:\bin\des.prg"                   # Data encryption standard
  286.  
  287. Thanks to Phil Karn; Ka9q for his DES program. We use it to
  288. en- and decrypt our secret messages.
  289.  
  290.  
  291. 0024 "D:\bin\uuenc.prg"                 # 8-Bit -> 7-Bit
  292.  
  293. uuencode-program. Please *don't* use another uuencode or
  294. uudecode, because ELM and mail expect them to provide
  295. certain special features.
  296.  
  297.  
  298. 0025 "D:\bin\uudec.prg"                 # 7-Bit -> 8-Bit
  299.  
  300. See last entry for comments.
  301.  
  302.  
  303. 0026 "D:\bin.uu\pnews.prg"              # Postnews
  304.  
  305. Insert path, name and extension of rnews here.
  306.  
  307.  
  308. 0027 "server"                           # Name of server-User
  309.  
  310. Gotcha! Mercury UUCP provides a archive-server-function. Insert the
  311. name of the user you want to entitle as server here. Common names are
  312. "server" or "archive-server". This user has to have a home-directory
  313. and an entry in the password-file.
  314.  
  315.  
  316. 0028 "D:\guests\server\stuff"           # Server-Directory
  317.  
  318. You should create this directory, and insert it's name here. The server
  319. accepts only one real command, which is "send". Aliases for this command
  320. are "mail", "get" and some others which I don't remember anymore.
  321.  
  322. The program server.prg searches in the home-directory of the user who
  323. acts as server (Field 0027) for mail-files, and scans the message-body
  324. for requests. If it can find a requested file, it'll just take it, and
  325. mail it to the sender of the request-message. Server.prg doesn't
  326. perform any 8-bit->7-bit-transformation, so you are recommended to put
  327. only files to the stuff-directory, which are "mailable" without changes.
  328.  
  329.                             ---------
  330.  
  331. Okay, that's all about config.sys!
  332.  
  333. I assume you've managed to install the stuff properly now (strange
  334. assumption, ha?). Further, I assume you are using GULAM or a similar
  335. command-line-interpreter. Now you need to tell Mercury UUCP, which user
  336. is "currently logged on". Do this, by typing "login root", or "login
  337. johnny" or whatever you've chosen to be your user-name. Login.prg
  338. will create a file "\etc\current.usr" with the current user's data.
  339.  
  340. Create a file "signatur.mai" and a file "signatur.net" in your
  341. home-directory. signatur.net will be appended to postings, signatur.mai
  342. to mails.
  343.  
  344. Now, you're ready to send me a mail!
  345.  
  346. type "elm rodney@merkur.gtc.de"... And hope it'll work!
  347.  
  348.                            ---------
  349.  
  350. Alright. You've written your mail, but now you want it to be
  351. piped to your remote host. It's a good idea to have shell-script
  352. which performs all necessary actions. For GULAM, you could use the
  353. following one:
  354.  
  355. server
  356. rmail
  357. rnews
  358. batch $1
  359. uupoll $1
  360. rmail
  361. rnews
  362.  
  363. If you call this script with "poll uunet", it'll execute server,
  364. rmail and rnews. Then it'll execute "batch uunet", and batch all news
  365. articles which are to be spooled to uunet. "uupoll uunet" calls uucico
  366. with the necessary parameters. Never call uucico directly!! After
  367. the call is completed, the script will run rmail and rnews again, so
  368. the received mail-messages and news-articles will be delivered.
  369.  
  370. If leave out one of the above commands, either your mail and your
  371. postings won't leave your machine, (n)or incoming mail and news will
  372. reach you.
  373.  
  374. I'll include the source code of uucico, too, because it's a hacked-up
  375. version of the uucico that came with "mailtruk" from John Logajan.
  376. Thank you very much, John! Our uucico now can even be called by other
  377. hosts - but don't ask me how to do this, ask jan@janhh.sub.org. Also,
  378. the version of Jan and Carsten seem to contain still bugs, so I'll
  379. include the source of my uucico, too.
  380.  
  381. Other programs:
  382.  
  383. rn             -        read news
  384. showmail       -        show, which users have mail
  385. statnews       -        Give a statistic of newsgroups
  386. expire n       -        delete news articles execept the ones
  387.                         of the last n days
  388.  
  389.  
  390. If there should be further problems, try to read the german
  391. documentation (mercury.doc), or just gimme a call.
  392.  
  393.  
  394.                           --------------
  395.                              Credits
  396.  
  397. Many thanks...
  398.  
  399. ...to norman@delos.stgt.sub.org, vaxima@aragon.gtc.de,
  400.   and pi@complx.stgt.sub.org
  401.                                 for patience and kind help
  402.  
  403.                                   
  404. Many thanks...
  405.  
  406. ...to jan@nasobem.stgt.sub.org, jan@janhh.sub.org,
  407.       bjoern@drdhh.sub.org, martini@heaven7.sub.org,
  408.       gmaster@malihh, nox@jelal and many others
  409.  
  410.                                  for bug-reports and ideas
  411.  
  412.                                       
  413. Thanks to Sting, Dire Straits, Joan Baez and others
  414.  
  415.                                       for their music
  416.  
  417.  
  418.                   Especially many thanks
  419.  
  420.                to saskia@lysis.stgt.sub.org
  421.  
  422.                                       for joy of life
  423.  
  424.  
  425.  
  426.                                       Freitag, 31. August 1990 4:16 AM
  427. -Rodney
  428.