NAME

       sm-archive - a sendmail milter to add recipients to messages

SYNOPSIS

       sm-archive [-c] [-d n] [-p sendmail-socket] [-t timeout]

OPTIONS

       -c     Load the configuration file, print a cannonical form of the configuration on stdout, and exit.

       -d n   Set the debug level to n.

       -p sendmail-socket
              Set  the  socket used for the milter connection to sendmail. This is either "inet:port@ip-address"
              or "local:local-domain-socket-file-name".

       -t timeout
              Set the timeout in seconds used for communication with sendmail.

USAGE

       sm-archive -c

       sm-archive -d 10 -p local:sm-archive.sock

INSTALLATION

       This is now a standard GNU autoconf/automake installation, so the normal "./configure; make; su; make in‐
       stall" works. "make chkconfig" will setup the init.d runlevel scripts. Alternatively,  you  can  use  the
       source  or  binary RPMs at http://www.five-ten-sg.com/sm-archive/packages: http://www.five-ten-sg.com/sm-
       archive/packages.

       Note that this has ONLY been tested on Linux, specifically RedHat Linux. You will need at a minimum a C++
       compiler with a minimally thread safe STL implementation. The distribution includes a  test.cpp  program.
       If it fails this milter won't work. If it passes, this milter might work.

       Modify your sendmail.mc by adding the following line in your sendmail.mc and rebuild the .cf file

              INPUT_MAIL_FILTER(`sm-archive',         `S=local:/var/run/sm-archive/sm-archive.sock,         F=T,
              T=C:30s;S:5m;R:5m;E:5m')

       Modify the default sm-archive.conf(5) configuration.

CONFIGURATION

       The configuration file is documented in sm-archive.conf(5). Any change to the config file,  or  any  file
       included from that config file, will cause it to be reloaded within three minutes.

INTRODUCTION

       Consider  the  problem  of  archiving all the mail sent to or from particular email addresses or domains.
       This milter allows you to configure archive mailboxes for each address or domain. It will add the address
       of the archive mailbox to messages that pass thru this milter.

       The archive milter reads a text configuration file (sm-archive.conf) on startup, and whenever the  config
       file  (or any of the referenced include files) is changed. The entire configuration file is case insensi‐
       tive. If the configuration cannot be loaded due to a syntax error, the milter  will  log  the  error  and
       quit.  If  the  configuration  cannot be reloaded after being modified, the milter will log the error and
       send an email to root from sm-archive@$hostname. You probably want to added sm-archive@$hostname to  your
       /etc/mail/virtusertable since otherwise sendmail will reject that message.

TODO

       Placeholder for future ideas.

COPYRIGHT

       Copyright (C) 2007 by 510 Software Group <carl@five-ten-sg.com>

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU Gener‐
       al Public License as published by the Free Software Foundation; either version 3, or (at your option) any
       later version.

       You  should  have received a copy of the GNU General Public License along with this program; see the file
       COPYING. If not, please write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

VERSION

       1.7

                                                   2008-03-21                                      SM-ARCHIVE(1)