home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / airport / utils / antutils / predeliver / !Help2 next >
Text File  |  1996-12-09  |  4KB  |  94 lines
  1. PreDeliver
  2. ==========
  3. by Tony Houghton <curler@tonyh.tcp.co.uk>
  4.  
  5. Version 1.00 (4 December 1996)
  6.  
  7. Allows users with multiple users on one POP3 mailbox to have their mail
  8. filtered to the correct user without using Newsbase. This requires a special
  9. facility to be set up on the mail server by the ISP.
  10.  
  11. For details of PreDeliver2, which does not require a special mailbox
  12. facility, see below, but also read the instructions for PreDeliver.
  13.  
  14. How it works
  15. ------------
  16. InetSuite's mail fetcher places mail in InetSpool:Input, adding a RCPT TO
  17. line at the top of each message to indicate which mailbox it came from. When
  18. mail is delivered, the MTA uses this line to determine whose mailbox to
  19. deliver it to in InetSpool:Mail.
  20.  
  21. PreDeliver works by checking for an alternative address in a configurable
  22. header (default X-RCPT-To), replacing the one in the RCPT TO line.  Once this
  23. process is done PreDeliver optionally sends a message to InetSuite to deliver
  24. the mail as normal.
  25.  
  26. Warning
  27. -------
  28. It's a bit limited, because the header must contain nothing but an email
  29. address, although it is allowed to be enclosed in angle-brackets and/or have
  30. leading whitespace. Any attempt to use it on headers that aren't this simple
  31. will result in "undefined behaviour" ie although PreDeliver will probably
  32. muddle on, what it does to the file might well cause InetSuite to do
  33. something nasty.
  34.  
  35. Installing
  36. ----------
  37. The most important thing is to edit Inet:Files.!InetMail and turn off
  38. automatic delivery by making sure the appropriate line reads:
  39.  
  40. DeliverAuto: OFF
  41.  
  42. Otherwise the suite will periodically deliver mail without calling PreDeliver
  43. first, so no filtering will be done.
  44.  
  45. I keep predeliver in the Inet:Bin directory and have added the line:
  46.  
  47. Pin Inet:Bin.predeliver 0 0
  48.  
  49. to InetSuite's !Run file so that it's easy to access. Remember to run it
  50. whenever you want to deliver any mail *INCLUDING OUTGOING MAIL* because the
  51. suite will no longer do this automatically for you.
  52.  
  53. Options
  54. -------
  55. I've tried to make sure the default settings are the most useful, but some
  56. can be overridden by adding options to the command used to run predeliver.
  57. You will need to use an Obey or TaskObey file if you want to be able to run
  58. it with parameters by double-clicking.
  59.  
  60.   -h<Header>    Look for alternative email address in <Header> (case sensitive)
  61.           Default value is X-RCPT-To
  62.   -g        Don't turn on hourglass (default turns on hourglass)
  63.   -d<n>        Whether to send Deliver message to InetSuite when finished 
  64.           Default value is 2
  65.       0    No message
  66.       1    Send message without calling Wimp_Initialise
  67.       2    Call Wimp_Initialise before sending message
  68.  
  69. -g and -d1 are provided so that it cn be run in a taskwindow. PreDeliver is
  70. much faster than the actual delivery process, so I haven't found a pressing
  71. need to make it multitask myself.
  72.  
  73. PreDeliver2
  74. ===========
  75. Version 1.00 (8 December 1996)
  76.  
  77. This is similar to PreDeliver, but more powerful because it can extract email
  78. addresses from more complicated headers, such as the To header. This means it
  79. can be used to filter messages from mailing lists by users with a normal POP3
  80. account. For each mailing list you will need to provide a local user with the
  81. same name as used by the list eg inetchat. 
  82.  
  83. PreDeliver uses the To header by default instead of X-RCPT-To.
  84.  
  85. If a header contains more than one email address, PreDeliver2 will use the
  86. first one. It will not be able to find any email addresses after the first
  87. line of a multiline header.
  88.  
  89. One limitation is that to prevent InetSuite helpfully delivering messages
  90. from mailing lists back to the list instead of to you, all incoming mail must
  91. be delivered to users on 'localhost' ie your machine. This means it is not
  92. possible to run a public mailing list - but that isn't practical with a
  93. single email address anyway.
  94.