Transport::POP3(3)

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.