Mail::Transport::Receive(3pm)

1Mail::Transport::ReceivUes(e3r)Contributed Perl DocumentMaatiilo:n:Transport::Receive(3)
2
3
4

NAME

6       Mail::Transport::Receive - receive messages
7

INHERITANCE

9        Mail::Transport::Receive
10          is a Mail::Transport
11          is a Mail::Reporter
12
13        Mail::Transport::Receive is extended by
14          Mail::Transport::IMAP4
15          Mail::Transport::POP3
16

SYNOPSIS

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

DESCRIPTION

22       Each object which extends Mail::Transport::Receive implement a protocol
23       which can get messages into your application.  The internals of each
24       implementation can differ quite a lot, so have a look at each separate
25       manual page as well.
26
27       Current message receivers:
28
29       ·   Mail::Transport::POP3
30
31           Implements the POP3 protocol.  See also Mail::Box::POP3.
32

METHODS

34   Constructors
35       Mail::Transport::Receive->new(OPTIONS)
36           See "METHODS" in Mail::Transport
37
38   Receiving mail
39       $obj->receive([UNIQUE-MESSAGE-ID])
40           Receive one message from the remote server.  Some receivers will
41           provide the next message automatically, other are random access and
42           use the specified ID.
43
44   Server connection
45       $obj->findBinary(NAME [, DIRECTORIES])
46           See "Server connection" in Mail::Transport
47
48       $obj->remoteHost
49           See "Server connection" in Mail::Transport
50
51       $obj->retry
52           See "Server connection" in Mail::Transport
53
54   Error handling
55       $obj->AUTOLOAD
56           See "Error handling" in Mail::Reporter
57
58       $obj->addReport(OBJECT)
59           See "Error handling" in Mail::Reporter
60
61       $obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])
62           Mail::Transport::Receive->defaultTrace([LEVEL]|[LOGLEVEL,
63           TRACELEVEL]|[LEVEL, CALLBACK])
64
65           See "Error handling" in Mail::Reporter
66
67       $obj->errors
68           See "Error handling" in Mail::Reporter
69
70       $obj->log([LEVEL [,STRINGS]])
71           Mail::Transport::Receive->log([LEVEL [,STRINGS]])
72
73           See "Error handling" in Mail::Reporter
74
75       $obj->logPriority(LEVEL)
76           Mail::Transport::Receive->logPriority(LEVEL)
77
78           See "Error handling" in Mail::Reporter
79
80       $obj->logSettings
81           See "Error handling" in Mail::Reporter
82
83       $obj->notImplemented
84           See "Error handling" in Mail::Reporter
85
86       $obj->report([LEVEL])
87           See "Error handling" in Mail::Reporter
88
89       $obj->reportAll([LEVEL])
90           See "Error handling" in Mail::Reporter
91
92       $obj->trace([LEVEL])
93           See "Error handling" in Mail::Reporter
94
95       $obj->warnings
96           See "Error handling" in Mail::Reporter
97
98   Cleanup
99       $obj->DESTROY
100           See "Cleanup" in Mail::Reporter
101
102       $obj->inGlobalDestruction
103           See "Cleanup" in Mail::Reporter
104

DIAGNOSTICS

106       Warning: Avoid program abuse: specify an absolute path for $exec.
107           Specifying explicit locations for executables of email transfer
108           agents should only be done with absolute file names, to avoid
109           various pontential security problems.
110
111       Warning: Executable $exec does not exist.
112           The explicitly indicated mail transfer agent does not exists. The
113           normal settings are used to find the correct location.
114
115       Error: Package $package does not implement $method.
116           Fatal error: the specific package (or one of its superclasses) does
117           not implement this method where it should. This message means that
118           some other related classes do implement this method however the
119           class at hand does not.  Probably you should investigate this and
120           probably inform the author of the package.
121

LICENSE

127       Copyrights 2001-2011 by Mark Overmeer. For other contributors see
128       ChangeLog.
129
130       This program is free software; you can redistribute it and/or modify it
131       under the same terms as Perl itself.  See
132       http://www.perl.com/perl/misc/Artistic.html
133
134
135
136perl v5.12.3                      2011-01-26       Mail::Transport::Receive(3)