home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / unix_c / usenet / umalpths.txt < prev    next >
Text File  |  1990-10-30  |  6KB  |  142 lines
  1. From sparkyfs!hercules!apple!julius.cs.uiuc.edu!wuarchive!decwrl!purdue!spaf Fri Oct  5 08:39:50 PDT 1990
  2.  
  3. Original-from: Gene Spafford (spaf@cs.purdue.edu)
  4. [Most recent change: 5  Sep 1990 by spaf@cs.purdue.edu (Gene Spafford)]
  5.  
  6. News 2.11 has been designed to make it simpler to submit articles to
  7. moderated newsgroups and to reply via mail to posted articles.  For
  8. these functions to work, the file "mailpaths" must exist in the news
  9. library and contain current information.  This file describes the
  10. syntax of the contents of the file and how to construct it for your site.
  11.  
  12. Syntax
  13. ------
  14. All lines in the file consist of a keyword followed by whitespace,
  15. followed by a printf-style format string which is used to encode a mail
  16. address.  The format string should be constructed so that there is a
  17. single "%s" in the field, and other information necessary to construct
  18. a valid address to the appropriate site (see below).
  19.  
  20. The keyword field consists of either the word "internet", the word
  21. "backbone", or some newsgroup pattern.  These are examined by the
  22. software to determine which format-string to use.  Note that the first
  23. appropriate line matched is the one used -- thus, the "backbone"
  24. keyword line should be placed last in the line if regional or local
  25. moderated groups are supported.
  26.  
  27. Addresses that end up with both "!" and "@" symbols in the resulting
  28. address get converted so that only "!" symbols appear in the final
  29. address.  An address of the form "foo!bar!baz@barf" will get converted
  30. to "foo!bar!barf!baz" and then mailed.  This should work properly, for
  31. "dumb" mailers but you should test it to make sure; "smart" mailers
  32. should have the format fields encoded as a simple "%s". Note that *any*
  33. address with more than a single "@" in it is illegal.
  34.  
  35. Submissions to moderated groups
  36. -------------------------------
  37. When you attempt to post to a moderated newsgroup (indicated by the
  38. letter "m" in the 4th field of the "active" file for that group), 
  39. the action of "inews" is to mail the submission to the moderator.
  40. This is done by searching through "mailpaths" file for a keyword
  41. matching the newgroup being posted to, or, by default, the keyword
  42. "backbone".  Matching occurs as in the "sys" file -- thus,
  43. "world" and "all" will also match everything, while "news" or 
  44. "news.all" will only match articles posted in the "news" category.
  45. This feature can be used to support local moderated groups.
  46.  
  47. Once a line has been matched, the name of the moderated group is
  48. transformed into an address.  This is done by first turning all the
  49. imbedded periods within the newsgroup name into hyphens (e.g.,
  50. "news.lists" becomes "news-lists") because many mailers mishandle
  51. addresses with periods in the username (periods are supposed to be
  52. delimiters only in the host/domain part of RFC822 addresses, but some
  53. mailers "overreact").  Next, the transformed group name is encoded into
  54. an address using the format-string present on the line matched from
  55. "mailpaths" and the article is mailed.  Thus, a posting to "news.lists"
  56. from a site with the line
  57.     backbone        emory!gatech!%s 
  58. in the mailpaths file would have the article mailed to
  59. "emory!gatech!news-lists".  Likewise, a line like
  60.     backbone    %s@gatech.edu
  61. would result in the article being mailed to "news-lists@gatech.edu".
  62. To make the mechanism for moderated postings simpler, a subset of the 
  63. best-connected sites (plus some others) have committed to keeping a complete
  64. up-to-date set of mail aliases for the moderated groups.  Therefore, to
  65. build this line in your "mailpaths" file, you need only construct
  66. an address to get the mail to one of these sites.  In turn, once the
  67. submission reaches that site, it will be forwarded on to the
  68. appropriate moderator's mailbox.
  69.  
  70. The sites currently maintaining these lists are given in the following
  71. list.  Pick the one that is "closest" to your site and use it in your
  72. "backbone" format string:
  73.  
  74.     ames        (ames.arc.nasa.gov)
  75.     bpa        (bell-atl.com)
  76.     decuac        (decuac.dec.com)
  77.     decwrl        (decwrl.dec.com)
  78.     gatech        (gatech.edu)
  79.     ncar        (ncar.ucar.edu)
  80.     husc6        (husc6.harvard.edu)
  81.     kddlab        (kddlab.kddlabs.jp)
  82.     linus        (linus.b.mitre.org)
  83.     mcnc        (mcnc.org)
  84.     mit-eddie    (eddie.mit.edu)
  85.     osu-cis        (cis.ohio-state.edu)
  86.     rutgers        (rutgers.edu)
  87.     ucsd        (ucsd.edu)
  88.     tektronix    (tektronix.tek.com)
  89.     ucbvax        (ucbvax.berkeley.edu)
  90.     uflorida    (uflorida.cis.ufl.edu)
  91.     uunet        (uunet.uu.net)
  92.     uw-beaver    (beaver.cs.washington.edu)
  93.     watmath        (math.waterloo.edu)
  94.  
  95.  
  96. Internet Mail
  97. -------------
  98. If you define the "INTERNET" flag when you build 2.11 news, the
  99. software will use the internet-style "From:" header when addressing
  100. replies mailed to postings.  If your mailer does not have this capability,
  101. you can still (possibly) achieve the same thing by defining the
  102. "internet" line in your "mailpaths" file to forward such mail to
  103. a host that does have a mailer which understands internet-style addresses.
  104.  
  105. The format of this line is very similar to the "backbone" line.  As an
  106. example, consider:
  107.     internet    emory!gatech!mcnc!%s
  108. Thus, if "INTERNET" was defined when this version of news was built,
  109. any reply to a news article would not travel along the "Path:", but
  110. would instead be sent to "mcnc" for interpretation and remailing.
  111. For example, to reply to this article, the mail would be sent to
  112. "emory!gatech!mcnc!spaf@cs.purdue.edu"  ->
  113. "emory!gatech!mcnc!cs.purdue.edu!spaf"
  114.  
  115. Note:  This is being provided as a service to sites which do not
  116. have routing mailers or which have difficulty replying to articles.
  117. It is *NOT* intended for everyone to pass mail to other sites to send.
  118. Excessive use of this feature may result in severe problems for
  119. the sites doing the relaying, so please simply define this field to
  120. be "%s" if your mailer understands domain-style (internet-style)
  121. addressing.
  122.  
  123. The following sites will accept internet-format mail for forwarding:
  124.  
  125.     clyde
  126.     decuac
  127.     kddlab
  128.     mcnc
  129.     ucsd
  130.     uunet
  131.     uw-beaver
  132.     watmath
  133.  
  134.  
  135. -- 
  136. Gene Spafford
  137. NSF/Purdue/U of Florida  Software Engineering Research Center,
  138. Dept. of Computer Sciences, Purdue University, W. Lafayette IN 47907-2004
  139. Internet:  spaf@cs.purdue.edu    uucp:    ...!{decwrl,gatech,ucbvax}!purdue!spaf
  140.  
  141.  
  142.