sa-learn wrapper script

Written and maintained by
Stefan Jakobs <stefan.jakobs@rus.uni-stuttgart.de>


How do I install to use it with postfix?

  Just unpack the script sal-wrapper.pl and copy it to a place you like
  (e.g. /usr/local/sbin/). Edit the file and change the configuration 
  parameters to your habbits.

  The simplest solution is to add the following two lines to a new alias like 
  file (here: /etc/report_aliases):

    spam: "|/PATH/TO/sal-wrapper.pl --spam"
    ham:  "|/PATH/TO/sal-wrapper.pl --ham"

  Then add the new alias file to alias_maps in postfix's main.cf:

    ...
    alias_maps = hash:/etc/aliases, hash:/etc/report_aliases
    ...

  Finally change the owner of the new alias file to the user which should run
  the script, create the new alias database and reload postfix:

    # chown YOUR_USER /etc/report_aliases
    # postaliases /etc/report_aliases
    # /etc/init.d/postfix reload

  Now spamassassin can learn messages by just forwarding the mail in the 
  appendix to ham@/spam@.

There is a second solution to use this script with postfix. It's more
complicated, but also more flexible.

  In this solution you must edit the master.cf and add the following lines:

    sa-wrapper unix -       n       n       -       -       pipe
      user=YOURUSER argv=/PATH/TO/sal-wrapper.pl --${mailbox}

  You must also make sure that the users (in this expample ham and spam)
  exists. Therefore you can add them in /etc/aliases:

    spam:	postmaster
    ham:	postmaster

  Then edit your transport file and add the following two lines:

    spam@<YourDomain>             sa-wrapper:
    ham@<YourDomain>              sa-wrapper:

  You have to enable the use of a transport map by adding
    transport_map = hash:/etc/postfix/transport
  to your main.cf file. Make 'postmap transport' and after all you can 
  learn spam through sending the spam message in the appendix to
  spam@<YourDomain>. In the same way you learn ham, but send it to
  ham@<YourDomain>.


How do I install to use it with other programs?

  I don't know exactly but the script reads a message from STDIN.
  So it should be easy to make it work with procmail and other progs.


Where can I find additional informations?

  See: https://po2.uni-stuttgart.de/~rusjako/sal-wrapper


### last update of this file: 30.12.2008 by Stefan Jakobs ###