POE-Filter-Transparent-SMTP

The filter aims to make SMTP data transparent just before going onto the wire as per RFC 821 Simple Mail Transfer Protocol Section 4.5.2. TRANSPARENCY. See L<http://www.faqs.org/rfcs/rfc821.html> for details.

Conversely the filter takes transparent data from the wire and converts it to the original format.

The main purpose of this filter is to help L<POE::Component::Client::SMTP> create transparent messages when comunicating with an SMTP server. However the filter can be used by any Perl SMTP client or server.

Internally it uses L<POE::Filter::Line> in order to split messages into lines. Also as stated in the RFC every line it puts on the wire is ended by <CRLF>.

When receiving data from the wire (as it is the case for an SMTP server), lines should be separated with <CRLF> as the RFC specifies. However this is not always true as some SMTP clients are broken. So if you are using the filter on the receiving end maybe you would like to specify a regular expression that is more flexible for the line terminator.

INSTALLATION

To install this module, run the following commands:

        perl Makefile.PL
        make
        make test
        make install

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

perldoc POE::Filter::Transparent::SMTP

You can also look for information at:

RT, CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=POE-Filter-Transparent-SMTP

AnnoCPAN, Annotated CPAN documentation

http://annocpan.org/dist/POE-Filter-Transparent-SMTP

CPAN Ratings

http://cpanratings.perl.org/d/POE-Filter-Transparent-SMTP

Search CPAN

http://search.cpan.org/dist/POE-Filter-Transparent-SMTP

COPYRIGHT AND LICENCE

Copyright (c) 2008-2009 George Nistorica All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See the LICENSE file that comes with this distribution for more details.