CUFILTER(1p)						User Contributed Perl Documentation					      CUFILTER(1p)

NAME

       cufilter - Filter emails through Mail::CheckUser

SYNOPSIS

       Add the following lines to your ~/.procmailrc:

	 # Filter mail through Mail::CheckUser
	 :0f
	 | /usr/bin/cufilter

DESCRIPTION

       When email messages are filtered through this program using the procmail settings as outlined in the SYNOPSYS, the email address in the
       "From:" header is passed through Mail::CheckUser to ensure validity.  If there is a problem with the email address, the "Subject:" header
       is modified to show which email address failed along with the failure reason.  No messages are lost, but it provides an easy way for the
       mail client to organize, sort, or filter based on the subject tweaks.

EXAMPLES

       Lets say a spammer sends a message with the following headers:

	 From: god@heaven.org
	 To: you@host.com
	 Subject: Happy Pill

       Then the new headers might change to the following:

	 From: god@heaven.org
	 To: you@host.com
	 Subject: [CU!god@heaven.org!DNS failure: SERVFAIL] Happy Pill

       This makes it easy to filter for mail clients.

INSTALL

       This file can be installed into /usr/bin/cufilter and is intended to be utilized through the procmail functionality by adding the following
       lines to your ~/.procmailrc configuration.

	 # Filter mail through Mail::CheckUser
	 :0f
	 | /usr/bin/cufilter

AUTHORS

       Rob Brown bbb@cpan.org

COPYRIGHT

       Copyright (c) 2003 Rob Brown bbb@cpan.org.  All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       $Id: cufilter,v 1.3 2003/09/18 15:36:26 hookbot Exp $

SEE ALSO

       Mail::CheckUser(3), procmail(1).

perl v5.14.2							    2012-03-10							      CUFILTER(1p)