home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / answers / mailpaths / part1 < prev    next >
Internet Message Format  |  1993-12-02  |  8KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!nic.hookup.net!decwrl!ames!haven.umd.edu!news.umbc.edu!europa.eng.gtefsd.com!uunet!not-for-mail
  2. From: tale@uunet.uu.net (David C Lawrence)
  3. Newsgroups: news.lists,news.admin.misc,news.answers
  4. Subject: How to Construct the Mailpaths File
  5. Supersedes: <mailpaths_748904457@uunet.uu.net>
  6. Followup-To: news.admin.misc
  7. Date: 30 Nov 1993 18:35:52 -0500
  8. Organization: UUNET Technologies Inc, Falls Church, VA, USA
  9. Lines: 140
  10. Approved: tale@uunet.uu.net
  11. Expires: 30 Jan 94 11:35:50 GMT
  12. Message-ID: <mailpaths_754702550@uunet.uu.net>
  13. NNTP-Posting-Host: rodan.uu.net
  14. Xref: senator-bedfellow.mit.edu news.lists:2893 news.admin.misc:6376 news.answers:15210
  15.  
  16. Archive-name: mailpaths/part1
  17. Original-author: Gene Spafford (spaf@cs.purdue.edu)
  18. Comment: enhanced & edited until 5/93 by spaf@cs.purdue.edu (Gene Spafford)
  19. Last-change: 7 Nov 1993 by tale@uunet.uu.net (David C Lawrence)
  20.  
  21. UNIX News software after B-news version 2.10 -- including C news and INN --
  22. has been designed to make it simpler to submit articles to moderated
  23. newsgroups and to reply via mail to posted articles.  For these
  24. functions to work, the file "mailpaths" must exist in the news library
  25. and contain current information.  This file describes the syntax of
  26. the contents of the file and how to construct it for your B News or C
  27. News system.
  28.  
  29. INN's method is described in the moderators(5) and inn.conf(5) manual
  30. pages; if you do not have locally moderated groups to worry about it
  31. is probably easiest to simply define moderatormailer in inn.conf as
  32. one of the machines listed below.
  33.  
  34. Some systems may not work in precisely the manner described here.  In
  35. particular, some user-agent programs may consult a file of moderator
  36. addresses directly.  The system news administrator should consult the
  37. documentation and man pages to determine if this description applies
  38. to the local configuration and modify it accordiningly.
  39.  
  40. Syntax
  41. ------
  42. All lines in the file consist of a keyword followed by whitespace,
  43. followed by a printf-style format string which is used to encode a mail
  44. address.  The format string should be constructed so that there is a
  45. single "%s" in the field, and other information necessary to construct
  46. a valid address to the appropriate site (see below).
  47.  
  48. The keyword field consists of either the word "internet", the word
  49. "backbone", or some newsgroup pattern.  These are examined by the
  50. software to determine which format-string to use.  Note that the FIRST
  51. appropriate line matched is the one used -- thus, the "backbone"
  52. keyword line should be placed last in the line if regional or local
  53. moderated groups are supported.
  54.  
  55. Also note that the match software quits if it runs out of newsgroup
  56. pattern, and if the pattern present matches the newsgroup.  Thus,
  57. having the entries:
  58.     comp.foo        foo@nowhere.edu
  59.     comp.foo.bar    bar@someplace.org
  60. would always send mail to the moderator of "comp.foo" and not to the
  61. moderator of "comp.foo.bar", no matter which of the two newsgroups was
  62. specified!   For proper operation, you would need to list them thusly:
  63.     comp.foo.bar    bar@someplace.org
  64.     comp.foo        foo@nowhere.edu
  65.  
  66. Addresses that end up with both "!" and "@" symbols in the resulting
  67. address get converted so that only "!" symbols appear in the final
  68. address.  An address of the form "foo!bar!baz@barf" will get converted
  69. to "foo!bar!barf!baz" and then mailed.  This should work properly, for
  70. "dumb" mailers but you should test it to make sure; "smart" mailers
  71. should have the format fields encoded as a simple "%s". Note that *any*
  72. address with more than a single "@" in it is illegal.
  73.  
  74. Submissions to moderated groups
  75. -------------------------------
  76. When you attempt to post to a moderated newsgroup (indicated by the
  77. letter "m" in the 4th field of the "active" file for that group), 
  78. the action of "inews" is to mail the submission to the moderator.
  79. This is done by searching through "mailpaths" file for a keyword
  80. matching the newsgroup being posted to, or, by default, the keyword
  81. "backbone".  Matching occurs as in the "sys" file -- thus,
  82. "world" and "all" will also match everything, while "news" or 
  83. "news.all" will only match articles posted in the "news" category.
  84. This feature can be used to support local moderated groups.
  85.  
  86. Once a line has been matched, the name of the moderated group is
  87. transformed into an address.  This is done by first turning all the
  88. imbedded periods within the newsgroup name into hyphens (e.g.,
  89. "news.lists" becomes "news-lists") because many mailers mishandle
  90. addresses with periods in the username (periods are supposed to be
  91. delimiters only in the host/domain part of RFC822 addresses, but some
  92. mailers "overreact").  Next, the transformed group name is encoded into
  93. an address using the format-string present on the line matched from
  94. "mailpaths" and the article is mailed.  Thus, a posting to "news.lists"
  95. from a site with the line
  96.     backbone        emory!gatech!%s 
  97. in the mailpaths file would have the article mailed to
  98. "emory!gatech!news-lists".  Likewise, a line like
  99.     backbone    %s@gatech.edu
  100. would result in the article being mailed to "news-lists@gatech.edu".
  101. To make the mechanism for moderated postings simpler, a subset of the 
  102. best-connected sites (plus some others) have committed to keeping a complete
  103. up-to-date set of mail aliases for the moderated groups.  Therefore, to
  104. build this line in your "mailpaths" file, you need only construct
  105. an address to get the mail to one of these sites.  In turn, once the
  106. submission reaches that site, it will be forwarded on to the
  107. appropriate moderator's mailbox.
  108.  
  109. The sites currently maintaining these lists are given in the following
  110. list.  Pick the one that is "closest" to your site and use it in your
  111. "backbone" format string:
  112.  
  113.     ames.arc.nasa.gov        beaver.cs.washington.edu  cis.ohio-state.edu
  114.     decuac.dec.com           decwrl.dec.com            eddie.mit.edu
  115.     moderators.univ-lyon1.fr linus.b.mitre.org         math.waterloo.edu
  116.     pipex.co.uk *            mcnc.org                  ncar.ucar.edu
  117.     rutgers.edu              tektronix.tek.com         ucsd.edu
  118.     uunet.uu.net             wrdis01.af.mil
  119.  
  120. (* pipex.co.uk is also pipex.net.  Sites served by EUnet have other
  121. arrangements, and non-EUnet sites may forward through pipex.)
  122.  
  123. Internet Mail
  124. -------------
  125. If you define the "INTERNET" flag when you build 2.11 news, the
  126. software will use the internet-style "From:" header when addressing
  127. replies mailed to postings.  If your mailer does not have this capability,
  128. you can still (possibly) achieve the same thing by defining the
  129. "internet" line in your "mailpaths" file to forward such mail to
  130. a host that does have a mailer which understands internet-style addresses.
  131.  
  132. The format of this line is very similar to the "backbone" line.  As an
  133. example, consider:
  134.     internet    emory!gatech!mcnc!%s
  135. Thus, if "INTERNET" was defined when this version of news was built,
  136. any reply to a news article would not travel along the "Path:", but
  137. would instead be sent to "mcnc" for interpretation and remailing.
  138. For example, to reply to this article, the mail would be sent to
  139. "emory!gatech!mcnc!spaf@cs.purdue.edu"  ->
  140. "emory!gatech!mcnc!cs.purdue.edu!spaf"
  141.  
  142. Note:  This is being provided as a service to sites which do not
  143. have routing mailers or which have difficulty replying to articles.
  144. It is *NOT* intended for everyone to pass mail to other sites to send.
  145. Excessive use of this feature may result in severe problems for
  146. the sites doing the relaying, so please simply define this field to
  147. be "%s" if your mailer understands domain-style (internet-style)
  148. addressing.
  149.  
  150. The following sites will accept internet-format mail for forwarding:
  151.  
  152.     beaver.cs.washington.edu    decuac.dec.com  kddlab.kddlabs.co.jp
  153.     math.waterloo.edu           mcnc.org        ucsd.edu
  154.     uunet.uu.net
  155.  
  156.