home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / gigop806.zip / MAILLIST.CFG < prev    next >
Text File  |  1994-04-18  |  9KB  |  162 lines
  1.  
  2. ; MAILING LISTS!
  3. ; GIGO will now internally support hosting of mailing lists.
  4. ; If you are not hosting the mailing list, but instead trying
  5. ; to _gate_ the mailing list, see the MAPPING.CFG file instead.
  6. ;
  7. ; Once again:  This section is if you want to HOST a mailing list.
  8. ;
  9.  
  10.  
  11. ;  ┌──────────────────────────────────────────────────────────────┐
  12. ;  │ IF YOU WISH TO USE THE MAILING LIST FEATURES, YOU WILL       │
  13. ;  │ NEED TO MAKE SURE THAT THIS CONFIG FILE GETS INCLUDED IN YOUR│
  14. ;  │ SETUP!                                                       │
  15. ;  │ IE, ADD   "Include MailList.Cfg"  TO YOUR GATEWAY.CFG FILE!  │
  16. ;  └──────────────────────────────────────────────────────────────┘
  17. ;
  18. ; There are two keywords involved.  CAPTURE is what will capture
  19. ; the messages from a given email address, echomail area, or newsgroup,
  20. ; and save them as .MLQ files in the directory you specify.
  21. ; EXPLODE will take the MLQ files, and send them out to a list of recipients.
  22. ;
  23. ; In addition, you will need to setup SITE statements for the purpose of 
  24. ; giving the mailing list (which is email based) access to posting 
  25. ; into the newsgroups and into the echos with.
  26. ;  
  27.  
  28. SITE  pnews  news ; Any mail sent to  news.group@pnews.yoursite.domain gets posted
  29. SITE  pecho  echo ; Any mail sent to  echoname@pecho.yoursite.domain gets posted
  30.  
  31. ;
  32. ; The two commands are seperated, so that I (or someone else) can easily
  33. ; add in the ability to create Digest Messages (where one email message
  34. ; contains several mailing list messages), and also so that anyone who
  35. ; wishes to archive the messages into a text file may do so.
  36. ;
  37. ;CAPTURE dirname\ inputaddress owner  newsgroup       ECHONAME  badmail.ml Description
  38. ;EXPLODE dirname\ listfile.ml  owner  postnewsaddress postechoaddress
  39. ;
  40. ;  PHASE 1 : CAPTURING MESSAGES FOR THE MAILING LIST
  41. ;
  42. ; CAPTURE dirname\ inputaddress owner  newsgroup       ECHONAME  Description
  43. ;
  44. ; The CAPTURE statement is designed to capture the messages from various
  45. ; sources.
  46. ;    o dirname\    : You _must_ dedicate a single directory
  47. ;                    to each mailing list that you wish to support.
  48. ;    o inputaddress: This is the address that people send messages
  49. ;                    to when they want their message sent to everyone else.
  50. ;    o owner       : The address where errors in mail delivery should
  51. ;                    go to, examples are listname-err or listname-owner.
  52. ;    o newsgroup   : The newsgroup to capture and deliver to for gating
  53. ;                    (if not porting to a newsgroup, use a single dash "-")
  54. ;    o ECHONAME    : The echoarea that you want to capture and deliver to
  55. ;                    for gating (if not porting to an echo, use a single dash)
  56. ;    o badmail.ml  : This is a text file describing which messages you
  57. ;                    do _not_ want redistributed.  This would include
  58. ;                    provisions for watching for messages from mailer
  59. ;                    daemons and other message notification messages.
  60. ;                    A sample will be included in the GIGO archive.
  61. ;    o Description : A small line of text, ie "Foobar-Baz Mailing List"
  62. ;
  63. ; When GIGO is running, if it gets any messages to the inputadddress,
  64. ; or in the newsgroup or echo specified, it will save that message in
  65. ; the dirname\ as a *.MLQ file (.Mailing List Queue).  The first line
  66. ; of that text file should be a Ctrl-A  immediately followed by
  67. ; the email address of the person submitting the message, or NEWS,
  68. ; or ECHO.  This information, if present, will help GIGO not send a
  69. ; duplicate message back out to the source where the message came from.
  70. ; It will strip most headers off, only keeping the pertinant ones.
  71. ; It will also contain an "Errors-To:" address, with the address
  72. ; of owner in it.
  73.  
  74. ;
  75. ;  PHASE 2 : EXPLODING MESSAGES FROM THE MAILING LIST TO THE RECIPIENTS
  76. ;
  77. ; EXPLODE dirname\ listfile.ml  owner postnewsaddress postechoaddress
  78. ;
  79. ; The EXPLODE statement is used to take the MLQ files, and to send it to
  80. ; a list of recipients.
  81. ;
  82. ;    o dirname\    : You _must_ dedicate a single directory
  83. ;                    to each mailing list that you wish to support.
  84. ;    o listfile.ml : This is an ascii list of recipients that wish
  85. ;                    to receive messages from this mailing list.
  86. ;                    This file should contain one address per line.
  87. ;                    You may either edit the file manually, or look into
  88. ;                    installing LISTSERV which can automate subscription
  89. ;                    requests for multiple mailing lists.
  90. ;    o owner         This is where errors should be sent to.
  91. ;                    Common:  listname-owner or listname-err
  92. ;    o postnewsaddress  This is where messages that need to be posted
  93. ;                    to a newsgroup need to be sent.   GIGO provides
  94. ;                    an email-to-news interface, which you will need
  95. ;                    to have setup for this purpose (should be done up above!)
  96. ;                    (If you do not wish to have messages posted to the
  97. ;                    newsgroup, specify a single dash "-").
  98. ;    o postechoaddress  This is where messages that need to be posted
  99. ;                    to a fidonet echo need to be sent.   GIGO provides
  100. ;                    an email-to-echomail interface, which you will need
  101. ;                    to have setup for this purpose.
  102. ;                    (If you do not wish to have messages posted to the
  103. ;                    echo, specify a single dash "-").
  104. ;
  105. ;
  106. ;  Whenever GIGO runs, if there are any EXPLODE statements in the config
  107. ;  file, GIGO will look at the specified files for *.MLQ files.  If
  108. ;  it finds any, it will process those files, and rename them to
  109. ;  *.MLS files (Mailing List Sent).  You may either do further processing
  110. ;  on them, or simply delete them - that is up to you.  The author
  111. ;  saves them in an archive for later use.
  112. ;
  113. ;  When GIGO finds a MLQ file to be sent out, it will take a look at the
  114. ;  first line of the file.  If it starts with Ctrl-A (""), it will
  115. ;  assume that that first line contains the phrase "NEWS", "ECHO",
  116. ;  or the email address of the person that wrote the message (if the
  117. ;  message was sent as email instead of via the newsgroup or echo).
  118. ;
  119. ;  GIGO will then take a look at the list of recipients, and start generating
  120. ;  the appropriate information in the spool directory for sending messages
  121. ;  out to all of the recipients.  GIGO will bundle roughly 10 addresses at a
  122. ;  time to a single message (if you have 100 recipients, you are likely going
  123. ;  to send out 10 messages with 10 people on each one).  The exact number
  124. ;  will vary ; GIGO will never place more than 250 characters on the "rmail"
  125. ;  line in the XQT files.
  126. ;
  127. ;  GIGO will also want to send the message to an email->newsgroup address,
  128. ;  and an email->echomail address.  GIGO can provide these address.  These are
  129. ;  only neccessary if you wish have messages from the mailing list sent
  130. ;  to a newsgroup, or sent to an echo, or both.  This provides a 3-way gate
  131. ;  between all 3 medias.
  132.  
  133. ; First off, the generic template..
  134. ;CAPTURE dirname\ inputaddress owner  newsgroup       ECHONAME  badmail.ml Description
  135. ;EXPLODE dirname\ listfile.ml  owner  postnewsaddress postechoaddress
  136. ;
  137. ; Some samples..Be sure to create your email->news and email->echo site addresses!
  138. ;
  139. ; SITE  pnews  news ; Any mail sent to  news.group@pnews.yoursite.domain gets posted
  140. ; SITE  pecho  echo ; Any mail sent to  echoname@pecho.yoursite.domain gets posted
  141. ;
  142. ;;  This is a 3-way gate between foobar@wmeonlin.sacbbx.com, alt.foobar, and the FOOBAR echo
  143. ;
  144. ;CAPTURE c:\ml\foobar\ foobar    foobar-owner alt.foobar FOOBAR badmail.ml The Discussion on the meaing of Foobar vs Fubar
  145. ;EXPLODE c:\ml\foobar\ foobar.ml foobar-owner alt.foobar@pnews.wmeonlin.sacbbx.com FOOBAR@pecho.wmeonlin.sacbbx.com
  146. ;
  147. ;;  This is just a mailing list between quasi@wmeonlin.sacbbx.com and the QUASI echo
  148. ;
  149. ;CAPTURE c:\ml\quasi\ quasi     quasi-owner -  QUASI  badmail.ml The Disc                                       
  150. ;EXPLODE c:\ml\quasi\ quase.ml  quasi-owner -  QUASI@pecho.wmeonlin.sacbbx.com
  151. ;
  152. ;;  This is a between a newsgroup called alt.caffeine and a mailing list - but no echomail copy at all.
  153. ;
  154. ;CAPTURE c:\ml\caffeine\ caffeine    caffeine-owner alt.caffeine -  badmail.ml Caffeine Addicts Anonymous
  155. ;EXPLODE c:\ml\caffeine\ caffeine.ml caffeine-owner alt.caffeine@pnews.wmeonlin.sacbbx.com -  
  156. ;
  157.  
  158. ;
  159.  
  160.  
  161.  
  162.