• user "xyz" on my system "xyz.com" subscribes to a mailing list called "abc" that comes from "abc.com". The mailing list messages always come with "abc(at)abc(dot)com" in the To header.
  
• the procmail app needs to be functioning on the system, and there is a .procmailrc file (probably in xyz's home directory). As long as procmail is running, and there is a valid .procmailrc file in the right place, then procmail "checks" all incoming mail to the user - and can optionally do some action based on the mail it looks at.
  
• for the fudforum mailing list integration, the .procmailrc file needs to contain something like
  

  :0:
  * ^TO_.*DOMAINNAME.COM
  | /web/fudfiles/scripts/maillist.php 1 

  
  where DOMAINNAME.COM is the address the mailing list messages contain in the header (like "abc.com" above) and where the second line depends on your installation of fudforum.
  
• If you have this stuff set up correctly, when user "xyz" receives email, mailproc checks it. If mailproc finds email that was sent TO "abc.com" it then executes the maillist.php script.
  
• The maillist.php script requires a binary version of PHP in order to run, and it may need to be modified so that it can find the PHP app.
  
• Assuming the maillist.php script is triggered ok, it takes the email message that triggered it and puts it in the designated forum, as if it had just been typed in by a person using the web interface.
  

TESTDIR=/Users/admin
MAILDIR=${TESTDIR}
LOGFILE=${TESTDIR}/Proctest.log
LOG="--- Logging for ${LOGNAME}, "
VERBOSE=yes
LOGABSTRACT=all

:0:
* ^TO_.*.com
| /web/fudfiles/scripts/maillist.php 1 

 --- Logging for admin, procmail: [503] Fri May 16 13:28:19 2003
procmail: Assigning "LOGABSTRACT=all"
procmail: Match on "(^((Original-)?(Resent-)?(To|Cc|Bcc)|(X-Envelope|Apparently(-Resent)?)-To):(.*[^-a-zA-Z0-9_.])?).*.com"
procmail: Couldn't determine implicit lockfile from "/web/fudfiles/scripts/maillist.php"
procmail: Locking ".lock"
procmail: Executing "/web/fudfiles/scripts/maillist.php,1"
/web/fudfiles/scripts/maillist.php: ?php: No such file or directory
/web/fudfiles/scripts/maillist.php: /Applications: is a directory
/web/fudfiles/scripts/maillist.php: line 5: syntax error near unexpected token `(C'
/web/fudfiles/scripts/maillist.php: line 5: `*   copyright            : (C) 2001,2002 Advanced Internet Designs Inc.'
procmail: Non-zero exitcode (2) from "/web/fudfiles/scripts/maillist.php"
procmail: Assigning "LASTFOLDER=/web/fudfiles/scripts/maillist.php 1"
procmail: Unlocking ".lock"
procmail: Bypassed locking "/var/mail/admin.lock"
procmail: Assigning "LASTFOLDER=/var/mail/admin"
procmail: Opening "/var/mail/admin"
procmail: Acquiring kernel-lock
procmail: Notified comsat: "admin@0:/var/mail/admin"
From zzzzz(at)zzzzzz(dot)com  Fri May 16 13:28:19 2003
 Subject: hi at 1:30
  Folder: /var/mail/admin                                                   832