debian man page for cufilter

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)