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