README
1POE-Filter-Transparent-SMTP
2
3The filter aims to make SMTP data transparent just before going onto
4the wire as per RFC 821 Simple Mail Transfer Protocol Section
54.5.2. TRANSPARENCY. See L<http://www.faqs.org/rfcs/rfc821.html> for
6details.
7
8Conversely the filter takes transparent data from the wire and
9converts it to the original format.
10
11The main purpose of this filter is to help
12L<POE::Component::Client::SMTP> create transparent messages when
13comunicating with an SMTP server. However the filter can be used by
14any Perl SMTP client or server.
15
16Internally it uses L<POE::Filter::Line> in order to split messages
17into lines. Also as stated in the RFC every line it puts on the wire
18is ended by <CRLF>.
19
20When receiving data from the wire (as it is the case for an SMTP
21server), lines should be separated with <CRLF> as the RFC
22specifies. However this is not always true as some SMTP clients are
23broken. So if you are using the filter on the receiving end maybe you
24would like to specify a regular expression that is more flexible for
25the line terminator.
26
27INSTALLATION
28
29To install this module, run the following commands:
30
31 perl Makefile.PL
32 make
33 make test
34 make install
35
36SUPPORT AND DOCUMENTATION
37
38After installing, you can find documentation for this module with the
39perldoc command.
40
41 perldoc POE::Filter::Transparent::SMTP
42
43You can also look for information at:
44
45 RT, CPAN's request tracker
46 http://rt.cpan.org/NoAuth/Bugs.html?Dist=POE-Filter-Transparent-SMTP
47
48 AnnoCPAN, Annotated CPAN documentation
49 http://annocpan.org/dist/POE-Filter-Transparent-SMTP
50
51 CPAN Ratings
52 http://cpanratings.perl.org/d/POE-Filter-Transparent-SMTP
53
54 Search CPAN
55 http://search.cpan.org/dist/POE-Filter-Transparent-SMTP
56
57
58COPYRIGHT AND LICENCE
59
60Copyright (c) 2008-2009 George Nistorica
61All rights reserved.
62This program is free software; you can redistribute it and/or
63modify it under the same terms as Perl itself. See the LICENSE
64file that comes with this distribution for more details.
65
66