| 1 |
WHAT IS IT? |
| 2 |
|
| 3 |
This is a POP3 client module for perl5. It provides an |
| 4 |
object-oriented interface to a POP3 server. It can be used to write |
| 5 |
perl-based biff clients, mail readers, or whatever. See the inline |
| 6 |
POD doco for more details. (perldoc Mail::POP3Client) |
| 7 |
|
| 8 |
|
| 9 |
HOW DO I INSTALL/TEST IT? |
| 10 |
|
| 11 |
To install Mail::POP3Client: |
| 12 |
|
| 13 |
% perl Makefile.PL |
| 14 |
% make |
| 15 |
% make test |
| 16 |
% make install |
| 17 |
|
| 18 |
NOTE: if you want to test against a real mailbox, set the environment |
| 19 |
variable POPTESTACCOUNT to some POP3 account in the following format: |
| 20 |
user:password:host. |
| 21 |
|
| 22 |
% export POPTESTACCOUNT=jsmith:secret:pop3.my.do.main |
| 23 |
% make test |
| 24 |
|
| 25 |
On Win32 ActiveState perl, you can install it using the Perl Package |
| 26 |
Manager (ppm). |
| 27 |
|
| 28 |
|
| 29 |
HOW DO I USE THIS WHEN MY ISP WON'T INSTALL IT FOR ME? |
| 30 |
|
| 31 |
You have 2 choices. You can go through the installation process using |
| 32 |
a prefix option to the make command like this: |
| 33 |
|
| 34 |
% perl Makefile.PL prefix=/some/other/directory |
| 35 |
|
| 36 |
then just make; make install as above. |
| 37 |
|
| 38 |
Or you can create a directory called Mail somewhere and just put |
| 39 |
POP3Client.pm in there. You will then have to put this directory into |
| 40 |
your include path (@INC) either on the command line or in your code |
| 41 |
(i.e. use lib '/path/to/directory'; ). You need to include the |
| 42 |
directory above Mail and case does matter. |
| 43 |
|
| 44 |
Choice 1 is better because you can track what modules you have |
| 45 |
installed but if you don't have command line access you'll have to go |
| 46 |
with choice 2. |
| 47 |
|
| 48 |
|
| 49 |
WHERE IS THE DOCUMENTATION? |
| 50 |
|
| 51 |
The documentation is in the code in POD format. To read it, use |
| 52 |
'perldoc Mail::POP3Client' or you can extract it to html using |
| 53 |
pod2html. |
| 54 |
|
| 55 |
|
| 56 |
I'M SURE MY USERNAME AND PASSWORD ARE CORRECT BUT IT WON'T CONNECT. |
| 57 |
WHAT'S WRONG? |
| 58 |
|
| 59 |
Most likely, the server is claiming to support APOP, but for some |
| 60 |
reason, doesn't. Try adding 'AUTH_MODE=>PASS' to the constructor. |
| 61 |
|
| 62 |
|
| 63 |
Written by Sean Dowd <[email protected]> |
| 64 |
|
| 65 |
|