NAME

Mail::Transport::POP3 - receive messages via POP3

CLASS HIERARCHY

Mail::Transport::POP3
is a Mail::Transport::Receive
is a Mail::Transport
is a Mail::Reporter

SYNOPSIS

my $receiver = Mail::Transport::POP3->new(...);
my $message = $receiver->receive($id);

DESCRIPTION

Receive messages via the POP3 protocol. This object handles the contact with one POP3 server, and recovers broken connections automatically.

METHOD INDEX

Methods prefixed with an abbreviation are described in Mail::Reporter (MR), Mail::Transport (MT), Mail::Transport::Receive (MTR).

The general methods for Mail::Transport::POP3 objects:

 MR errors                            MR reportAll [LEVEL]
 MR log [LEVEL [,STRINGS]]               top UIDL, [MAXLINES]
    new OPTIONS                       MR trace [LEVEL]
MTR receive [UNIQUE-MESSAGE-ID]          url
 MR report [LEVEL]                    MR warnings

The extra methods for extension writers:

MR AUTOLOAD                          MR logPriority LEVEL
MR DESTROY                           MR logSettings
   contactServer                     MR notImplemented
MT findBinary NAME [, DIRECTOR...    MT remoteHost
MR inGlobalDestruction               MT retry

METHODS

new OPTIONS
OPTION        DESCRIBED IN             DEFAULT
authenticate  Mail::Transport::POP3    'LOGIN'
head_type     Mail::Transport::Receive 'Mail::Message::Head::Complete'
head_opts     Mail::Transport::Receive {}
hostname      Mail::Transport          'localhost'
interval      Mail::Transport          30
message_type  Mail::Transport::Receive 'Mail::Message'
message_opts  Mail::Transport::Receive undef
log           Mail::Reporter           'WARNINGS'
password      Mail::Transport          undef
proxy         Mail::Transport          undef
retry         Mail::Transport          undef
timeout       Mail::Transport          120
trace         Mail::Reporter           'WARNINGS'
username      Mail::Transport          undef
via           Mail::Transport          'pop3'
  • authenticate => 'LOGIN'|'APOP'

    Use the old LOGIN authentication (unencryped, default) or the newer APOP.

url

Represent this pop3 connection as URL.

top UIDL, [MAXLINES]

Returns a reference to an array which contains the header of the message with the specified UIDL. The optional integer MAXLINES specifies the number of lines from the body which are wanted: by default all.

METHODS for extensions writers

contactServer

SEE ALSO

Mail::Box-Overview

For support and additional documentation, see http://perl.overmeer.net/mailbox/

AUTHOR

Mark Overmeer (mailbox@overmeer.net). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION

This code is beta, version 2.018.

Copyright (c) 2001-2002 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.