home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / OWL100.ZIP / OWL.DOC < prev    next >
Encoding:
Text File  |  1992-07-28  |  5.2 KB  |  194 lines
  1.                           Owl
  2.  
  3.                 Copyright 1992 Rick Ellis
  4.  
  5.  
  6.  
  7.  
  8. Introduction
  9. ============
  10.  
  11. What is Owl?  Owl is a mailing list utility for use with Ufgate
  12. and other Fido<->uucp gateway programs that support the *.msg
  13. format to import uucp mail into a *.msg directory and to export
  14. new mail from a directory to a mailing list host.  Owl also can
  15. act as its own mailing list host.
  16.  
  17.  
  18. OWL.CFG
  19. =======
  20.  
  21. The OWL.CFG file contains the basic configuration information. 
  22. Here are the valid configuration verbs:
  23.  
  24. GateAddress             1:103/208
  25. MyAddress               1:103/208
  26. OwlControlFile          owl.ctl
  27. Netmail                 i:\bbs\opus\netmail
  28. Echotoss                echotoss.log
  29. Areas                   areas.bbs
  30.  
  31.  
  32. OWL.CTL
  33. =======
  34.  
  35. The OWL.CTL file consists of lines with three fields.  The first
  36. field is a path or an echomail area name.  The second field
  37. consists of a single type character that specifies the action to
  38. be taken.  The third field is a string specific to the type. 
  39. The three fields are separated by spaces.
  40.  
  41.  
  42. Importing from a mailing list
  43. =============================
  44.  
  45. The best way to import mailing list messages is to have them
  46. sent to an alias at your site.  Owl is then told to move all
  47. mail address to that alias from your netmail directory using a
  48. 't' in the type field.
  49.  
  50. For example the following entry in OWL.CTL would move all mail
  51. address to "novell-l" to the directory i:\msg\novell"
  52.  
  53. i:\msg\novell      t   novell-l
  54.  
  55.  
  56.  
  57. Exporting to a mailing list
  58. ===========================
  59.  
  60. Simply give Owl the path or echoname to export from and the uucp
  61. address to send to using a "u" in the type field.  The following
  62. example sends new messages in i:\msg\novell to
  63. NOVELL@SUVM.ACS.SYR.EDU:
  64.  
  65. i:\msg\novell      u   NOVELL@SUVM.ACS.SYR.EDU
  66.  
  67.  
  68. Hosting a mailing list
  69. ======================
  70.  
  71. To host a mailing list use an entry similar to the "u" entry. 
  72. Instead of a mail address give a filename.  The file should
  73. contain a list of uucp addresses to send to, one per line (and
  74. nothing else).  Here's what I use to port the FILK echo to a
  75. mailing list:
  76.  
  77. i:\msg\filk        m   filk.ml
  78.  
  79.  
  80. Summary of type characters
  81. ==========================
  82.  
  83. importing:      t       match the "To" field
  84.                 f       match the "From" field
  85.                 j       find a string (case sensitive) in the
  86.                         subject field
  87.                 s       find a string (case sensitive) in the first
  88.                         32k of the message body
  89.  
  90. exporting:      u       send new message to a uucp address
  91.                 m       send new messages to a list of addresses
  92.  
  93.  
  94. Echotoss.log
  95. ============
  96.  
  97. When importing Owl will log areas that new messages are imported
  98. into in the echotoss.log (or whatever name you with to use)
  99. file.  Only areas specified with an echo name instead of a path
  100. are logged.  The log file can be used to reply link, scan out
  101. messages to fidonet, or for other purposes.
  102.  
  103.  
  104. Command line switches
  105. =====================
  106.  
  107.    -s=<file>     specify alternate OWL.CFG file
  108.  
  109.    -ne           don't export
  110.    -ni           don't import
  111.  
  112.  
  113. These switches override the entries in OWL.CFG:
  114.  
  115.    -nm=<dir>     netmail directory
  116.    -f=<file>     echotoss.log
  117.    -a=<file>     areas.bbs
  118.    -c=<file>     owl.ctl
  119.    -ga=<addr>    uucp gateway fidonet address
  120.    -my=<addry>   my fidonet address
  121.  
  122.  
  123. Limitations
  124. ===========
  125.  
  126. lines in owl.ctl        255 lines
  127. line length             255 characters
  128. message size            available disk space
  129. paths                   255 characters
  130.  
  131. Most of  these limits can be changed.  If you have a special
  132. need, let me know.
  133.  
  134.  
  135. Note:  Owl keeps a zero length file (OWL.!) in each directory it
  136. deals with this file is used to record the date and time Owl
  137. last scanned the directory to avoid looking at old messages
  138. again.  If you have a reason to rescan a directory (such as
  139. owl.ctl changing), be sure to delete OWL.! in that directory.
  140.  
  141.  
  142. Bug reports
  143. ===========
  144.  
  145. Bug reports and ideas for improvements should be sent to
  146. rick@ofa123.fidonet.org or Rick Ellis @ 1:103/208.
  147.  
  148.  
  149. 25 Oct 1990, 15:00                      OWL 0.8b
  150.  
  151. Added -c<file> for control file name.
  152.  
  153.  
  154. 03 Feb 1991, 23:03                      OWL 0.9b
  155.  
  156. Speed improvements
  157.  
  158.  
  159. 30 Oct 1991, 19:32                      OWL 0.9f
  160.  
  161. added code to find address from origin line
  162. remove origin line and below for output uucp mail
  163.  
  164.  
  165. 19 Nov 1991, 15:55                      OWL 0.9g
  166.  
  167. mailing lists now get a from name of <listname>-error to prevent
  168. posters from getting the bounce messages.  Version 1 (RSN) will
  169. directly create the outbound file and make proper headers with
  170. Reply-To: fields.
  171.  
  172.  
  173. 22 Nov 1991, 15:31                      OWL 0.9h
  174.  
  175. Fixed reply-to field to use '.' for spaces
  176.  
  177.  
  178. 23 Nov 1991, 13:10                      OWL 0.9i
  179.  
  180. Added 'j' tab for searching subject field
  181.  
  182.  
  183. 01 Apr 1992, 16:02                      OWL 0.9j
  184.  
  185. Minor correction in the mailing list host code to fix problem
  186. that occurred when no origin line existed.  (garbage was being
  187. inserted into the outgoing message)
  188.  
  189.  
  190. 28 Jul 1992, 17:52                      OWL 1.00
  191.  
  192. Added configuration file OWL.CFG and removed all MAIL.SYS code. 
  193. Fist draft of doc file.
  194.