Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mail::milter::module::maildomaindotmx(3pm) [debian man page]

Mail::Milter::Module::MailDomainDotMX(3pm)		User Contributed Perl Documentation		Mail::Milter::Module::MailDomainDotMX(3pm)

NAME

       Mail::Milter::Module::MailDomainDotMX - milter to reject mail whose sender domain publishes a null MX record

SYNOPSIS

	   use Mail::Milter::Module::MailDomainDotMX;

	   my $milter = new Mail::Milter::Module::MailDomainDotMX;

	   my $milter2 = &MailDomainDotMX; # convenience

	   $milter2->set_message('Mail from %M domain invalid (has dot-MX record)');

DESCRIPTION

       This milter module rejects any mail from a sender's domain (in the MAIL FROM part of the SMTP transaction, not in the From: header) if that
       domain publishes a "null", or "dot" MX record.  Such a record looks like the following in DNS:

	   example.com. IN MX 0 .

       This lookup requires the Net::DNS module to be installed in order to fetch the MX record.

       An extra check as to whether the MX is valid is not (yet) done here.  It is currently assumed that the MTA does rudimentary checking for
       the presence of a valid MX or A record on the sending domain.

METHODS

       new()
	   Creates a MailDomainDotMX object.  There are no arguments to configure this module, as it is a fixed check.

       ignore_tempfail(FLAG)
	   If FLAG is 0 (the default), a DNS lookup which fails the underlying DNS query will cause the milter to return a temporary failure
	   result (SMFIS_TEMPFAIL).

	   If FLAG is 1, a temporary DNS failure will be treated as if the lookup resulted in an empty record set (SMFIS_CONTINUE).

	   This method returns a reference to the object itself, allowing this method call to be chained.

       set_message(MESSAGE)
	   Sets the message used when rejecting messages.  This string may contain the substring %M, which will be replaced by the matching e-mail
	   address.

	   This method returns a reference to the object itself, allowing this method call to be chained.

AUTHOR

       Todd Vierling, <tv@duh.org> <tv@pobox.com>

SEE ALSO

       Mail::Milter::Object

perl v5.8.8							    2004-02-26				Mail::Milter::Module::MailDomainDotMX(3pm)

Check Out this Related Man Page

Mail::Milter::Wrapper::DecodeSRS(3pm)			User Contributed Perl Documentation		     Mail::Milter::Wrapper::DecodeSRS(3pm)

NAME

       Mail::Milter::Wrapper::DecodeSRS - milter wrapper to decode SRS-encoded return path

SYNOPSIS

	   use Mail::Milter::Wrapper::DecodeSRS;

	   my $milter = ...;
	   my $wrapper = new Mail::Milter::Wrapper::DecodeSRS($milter);

	   my $wrapper2 = &DecodeSRS($milter); # convenience

DESCRIPTION

       Mail::Milter::Wrapper::DecodeSRS is a convenience milter wrapper which decodes MAIL FROM: return paths which have been encoded by the
       Sender Rewrite Scheme, SRS.  (More information:	http://www.libsrs2.org/) This wrapper internally understands both the SRS0 and SRS1 encod-
       ing schemes documented by the Mail::SRS author.

       The decoded address is made available to the contained milter via the "envfrom" callback, in the same way that a raw address would.

       NOTE:  If the address is not SRS encoded, the contained milter is NOT called for the duration of the message; instead, SMFIS_ACCEPT is
       returned.  This is because the milter writer is expected to use this wrapper in a chain that also includes the contained milter without
       wrapping, in order to prevent a malicious sender from using SRS to bypass access checks.

       For instance, the following is a proper usage of this wrapper in a chain:

	   my $envfrommilter = ...;

	   my $combinedmilter = new Mail::Milter::Chain(
	       new Mail::Milter::Wrapper::UnwrapSRS($envfrommilter),
	       $envfrommilter
	   );

       This behavior can also be used if, e.g., the MTA already does one form of MAIL FROM: check, and the contained milter repeats that same
       database check against SRS rewritten addresses.	(A good example would be a milter emulating Sendmail's access_db map.)

AUTHOR

       Todd Vierling, <tv@duh.org> <tv@pobox.com>

SEE ALSO

       Mail::Milter::Wrapper

perl v5.8.8							    2004-02-26				     Mail::Milter::Wrapper::DecodeSRS(3pm)
Man Page