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.