See METHODS in Mail::Reporter
Create a new pop3 server connection. One object can only handle one
connection: for a single user to one single server. If the server
could not be reached, or when the login fails, this instantiating new
will return undef
.
Option | Defined in | Default |
---|---|---|
authenticate |
| |
executable | Mail::Transport |
|
hostname | Mail::Transport |
|
interval | Mail::Transport |
|
log | Mail::Reporter |
|
password | Mail::Transport | undef |
port | Mail::Transport |
|
proxy | Mail::Transport | undef |
retry | Mail::Transport | <false> |
timeout | Mail::Transport |
|
trace | Mail::Reporter |
|
username | Mail::Transport | undef |
via | Mail::Transport |
|
Mark all messages that have been fetched with message() for deletion. See fetched().
Either mark the specified message(s) to be deleted on the remote server or unmark them for deletion (if the first parameter is false). Deletion of messages will take place only when the connection is specifically disconnected or the last reference to the object goes out of scope.
Break contact with the server, if that (still) exists. Returns true if successful. Please note that even if the disconnect was not successful, all knowledge of messages etc. will be removed from the object: the object basically has reverted to the state in which it was before anything was done with the mail box.
Returns a reference to a list of ID's that have been fetched using message(). This can be used to update a database of messages that were fetched (but maybe not yet deleted) from the mailbox.
Please note that if the POP3 server did not support the UIDL command, this method will always return undef because it is not possibly to reliably identify messages between sessions (other than looking at the contents of the messages themselves).
See also deleteFetched().
Returns the total number of octets used by the mailbox on the remote server.
Returns a reference to an array which contains the header of the message
with the specified ID. undef
is returned if something has gone wrong.
The optional integer BODYLINES specifies the number of lines from the body which should be added, by default none.
my $ref_lines = $pop3->header($uidl); print @$ref_lines;
Translates the unique ID of a message into a sequence number which
represents the message as long a this connection to the POP3 server
exists. When the message has been deleted for some reason, undef
is returned.
Returns a list (in list context) or a reference to a list (in scalar context) of all ID's which are known by the server on this moment.
Returns the size of the message which is indicated by the ID, in octets.
If the message has been deleted on the remote server, this will return
undef
.
Returns (in scalar context only) the number of messages that are known to exist in the mailbox.
It is not possible to retreive all messages on a remote POP3 folder at once: each shall be taken separately. The POP3 folder will hide this for you.
The follow methods handle protocol internals, and should not be used by a normal user of this class.
Establish a new connection to the POP3 server, using username and password.
Unsuccesful in connecting to the remote POP3 server.
The authenication method to get access to the POP3 server did not result in a connection. Maybe you need a different authentication protocol, or your username with password are invalid.
No authentication method was explicitly prescribed, so both AUTH and APOP were tried. However, both failed. There are other authentication methods, which are not defined by the main POP3 RFC rfc1939. These protocols are not implemented yet. Please contribute your implementation.
No username and/or no password specified for this POP3 folder, although these are obligatory parts in the protocol.
The remote server did not respond to an initial exchange of messages as is expected by the POP3 protocol. The server has probably a different service on the specified port.
Send data to the indicated socket and return the first line read from that socket. Logs an error if either writing to or reading from socket failed.
This method does not attempt to reconnect or anything: if reading or writing the socket fails, something is very definitely wrong.
It is not possible to read the success status of the previously given POP3 command. Connection lost?
It is not possible to send a protocol command to the POP3 server. Connection lost?
Sends the indicated COMMAND to the specified socket, and retrieves the
response. It returns a reference to an array with all the lines that
were reveived after the first +OK
line and before the end-of-message
delimiter (a single dot on a line). Returns undef
whenever something has gone wrong.
Returns a connection to the POP3 server. If there was no connection yet, it will be created transparently. If the connection with the POP3 server was lost, it will be reconnected and the assures that internal state information (STAT and UIDL) is up-to-date in the object.
If the contact to the server was still present, or could be established,
an IO::Socket::INET object is returned. Else, undef
is returned and
no further actions should be tried on the object.
The connection to the remote POP3 was lost, and cannot be re-established because the server's protocol implementation lacks the necessary information.
Update the current status of folder on the remote POP3 server.
For some weird reason, the server does not respond to the STAT call.
Represent this pop3 connection as URL.