1Mail::Box::POP3s(3)   User Contributed Perl Documentation  Mail::Box::POP3s(3)
2
3
4

NAME

6       Mail::Box::POP3s - handle secure POP3 folders as client
7

INHERITANCE

9        Mail::Box::POP3s
10          is a Mail::Box::POP3
11          is a Mail::Box::Net
12          is a Mail::Box
13          is a Mail::Reporter
14

SYNOPSIS

16        use Mail::Box::POP3s;
17        my $folder = Mail::Box::POP3s->new(folder => $ENV{MAIL}, ...);
18

DESCRIPTION

20       This module mainly extends Mail::Box::POP3.
21
22       Extends "DESCRIPTION" in Mail::Box::POP3.
23

OVERLOADED

25       Extends "OVERLOADED" in Mail::Box::POP3.
26
27       overload: ""
28           Inherited, see "OVERLOADED" in Mail::Box
29
30       overload: @{}
31           Inherited, see "OVERLOADED" in Mail::Box
32
33       overload: cmp
34           Inherited, see "OVERLOADED" in Mail::Box
35

METHODS

37       Extends "METHODS" in Mail::Box::POP3.
38
39   Constructors
40       Extends "Constructors" in Mail::Box::POP3.
41
42       Mail::Box::POP3s->new(%options)
43            -Option           --Defined in     --Default
44             access             Mail::Box        'r'
45             authenticate       Mail::Box::POP3  'AUTO'
46             body_delayed_type  Mail::Box        Mail::Message::Body::Delayed
47             body_type          Mail::Box        Mail::Message::Body::Lines
48             coerce_options     Mail::Box        []
49             create             Mail::Box        <not applicable>
50             extract            Mail::Box        10240
51             field_type         Mail::Box        undef
52             fix_headers        Mail::Box        <false>
53             folder             Mail::Box        <not applicable>
54             folderdir          Mail::Box        <network location>
55             head_delayed_type  Mail::Box        Mail::Message::Head::Delayed
56             head_type          Mail::Box        Mail::Message::Head::Complete
57             keep_dups          Mail::Box        <false>
58             lock_file          Mail::Box        undef
59             lock_timeout       Mail::Box        1 hour
60             lock_type          Mail::Box        'NONE'
61             lock_wait          Mail::Box        10 seconds
62             locker             Mail::Box        undef
63             log                Mail::Reporter   'WARNINGS'
64             manager            Mail::Box        undef
65             message_type       Mail::Box        Mail::Box::POP3::Message
66             multipart_type     Mail::Box        Mail::Message::Body::Multipart
67             password           Mail::Box::Net   undef
68             pop_client         Mail::Box::POP3  undef
69             remove_when_empty  Mail::Box        <false>
70             save_on_exit       Mail::Box        <true>
71             server_name        Mail::Box::Net   undef
72             server_port        Mail::Box::Net   995
73             trace              Mail::Reporter   'WARNINGS'
74             trusted            Mail::Box        <false>
75             username           Mail::Box::Net   undef
76
77           access => MODE
78           authenticate => 'LOGIN'|'APOP'|'AUTO'
79           body_delayed_type => CLASS
80           body_type => CLASS|CODE
81           coerce_options => ARRAY
82           create => BOOLEAN
83           extract => INTEGER | CODE | METHOD | 'LAZY'|'ALWAYS'
84           field_type => CLASS
85           fix_headers => BOOLEAN
86           folder => FOLDERNAME
87           folderdir => DIRECTORY
88           head_delayed_type => CLASS
89           head_type => CLASS
90           keep_dups => BOOLEAN
91           lock_file => FILENAME
92           lock_timeout => SECONDS
93           lock_type => CLASS|STRING|ARRAY
94           lock_wait => SECONDS
95           locker => OBJECT
96           log => LEVEL
97           manager => MANAGER
98           message_type => CLASS
99           multipart_type => CLASS
100           password => STRING
101           pop_client => OBJECT
102           remove_when_empty => BOOLEAN
103           save_on_exit => BOOLEAN
104           server_name => HOSTNAME
105           server_port => INTEGER
106           trace => LEVEL
107           trusted => BOOLEAN
108           username => STRING
109
110   The folder
111       Extends "The folder" in Mail::Box::POP3.
112
113       $obj->addMessage($message)
114           Inherited, see "METHODS" in Mail::Box::POP3
115
116       $obj->addMessages($messages)
117           Inherited, see "METHODS" in Mail::Box::POP3
118
119       Mail::Box::POP3s->appendMessages(%options)
120           Inherited, see "The folder" in Mail::Box
121
122       $obj->close(%options)
123           Inherited, see "The folder" in Mail::Box
124
125       $obj->copyTo($folder, %options)
126           Inherited, see "The folder" in Mail::Box
127
128       $obj->delete(%options)
129           Inherited, see "METHODS" in Mail::Box::POP3
130
131       $obj->folderdir( [$directory] )
132           Inherited, see "The folder" in Mail::Box
133
134       $obj->name()
135           Inherited, see "The folder" in Mail::Box
136
137       $obj->organization()
138           Inherited, see "The folder" in Mail::Box
139
140       $obj->size()
141           Inherited, see "The folder" in Mail::Box
142
143       $obj->type()
144           Inherited, see "The folder" in Mail::Box
145
146       $obj->update()
147           Inherited, see "METHODS" in Mail::Box::POP3
148
149       $obj->url()
150           Inherited, see "The folder" in Mail::Box
151
152   Folder flags
153       Extends "Folder flags" in Mail::Box::POP3.
154
155       $obj->access()
156           Inherited, see "Folder flags" in Mail::Box
157
158       $obj->isModified()
159           Inherited, see "Folder flags" in Mail::Box
160
161       $obj->modified( [BOOLEAN] )
162           Inherited, see "Folder flags" in Mail::Box
163
164       $obj->writable()
165           Inherited, see "Folder flags" in Mail::Box
166
167   The messages
168       Extends "The messages" in Mail::Box::POP3.
169
170       $obj->current( [$number|$message|$message_id] )
171           Inherited, see "The messages" in Mail::Box
172
173       $obj->find($message_id)
174           Inherited, see "The messages" in Mail::Box
175
176       $obj->findFirstLabeled( $label, [BOOLEAN, [$msgs]] )
177           Inherited, see "The messages" in Mail::Box
178
179       $obj->message( $index, [$message] )
180           Inherited, see "The messages" in Mail::Box
181
182       $obj->messageId( $message_id, [$message] )
183           Inherited, see "The messages" in Mail::Box
184
185       $obj->messageIds()
186           Inherited, see "The messages" in Mail::Box
187
188       $obj->messages( <'ALL'|$range|'ACTIVE'|'DELETED'|$label|
189       !$label|$filter> )
190           Inherited, see "The messages" in Mail::Box
191
192       $obj->nrMessages(%options)
193           Inherited, see "The messages" in Mail::Box
194
195       $obj->scanForMessages($message, $message_ids, $timespan, $window)
196           Inherited, see "The messages" in Mail::Box
197
198   Sub-folders
199       Extends "Sub-folders" in Mail::Box::POP3.
200
201       $obj->listSubFolders(%options)
202       Mail::Box::POP3s->listSubFolders(%options)
203           Inherited, see "METHODS" in Mail::Box::POP3
204
205       $obj->nameOfSubFolder( $subname, [$parentname] )
206       Mail::Box::POP3s->nameOfSubFolder( $subname, [$parentname] )
207           Inherited, see "Sub-folders" in Mail::Box
208
209       $obj->openRelatedFolder(%options)
210           Inherited, see "Sub-folders" in Mail::Box
211
212       $obj->openSubFolder(%options)
213           Inherited, see "METHODS" in Mail::Box::POP3
214
215       $obj->topFolderWithMessages()
216       Mail::Box::POP3s->topFolderWithMessages()
217           Inherited, see "Sub-folders" in Mail::Box
218
219   Internals
220       Extends "Internals" in Mail::Box::POP3.
221
222       $obj->coerce($message, %options)
223           Inherited, see "Internals" in Mail::Box
224
225       $obj->create($folder, %options)
226       Mail::Box::POP3s->create($folder, %options)
227           Inherited, see "METHODS" in Mail::Box::POP3
228
229       $obj->determineBodyType($message, $head)
230           Inherited, see "Internals" in Mail::Box
231
232       Mail::Box::POP3s->foundIn( [$foldername], %options )
233           Inherited, see "Internals" in Mail::Box
234
235       $obj->getHead($message)
236           Inherited, see "Internals" in Mail::Box::POP3
237
238       $obj->getHeadAndBody($message)
239           Inherited, see "Internals" in Mail::Box::POP3
240
241       $obj->lineSeparator( [<STRING|'CR'|'LF'|'CRLF'>] )
242           Inherited, see "Internals" in Mail::Box
243
244       $obj->locker()
245           Inherited, see "Internals" in Mail::Box
246
247       $obj->popClient(%options)
248           Inherited, see "Internals" in Mail::Box::POP3
249
250       $obj->read(%options)
251           Inherited, see "Internals" in Mail::Box
252
253       $obj->readMessages(%options)
254           Inherited, see "Internals" in Mail::Box
255
256       $obj->storeMessage($message)
257           Inherited, see "Internals" in Mail::Box
258
259       $obj->toBeThreaded($messages)
260           Inherited, see "Internals" in Mail::Box
261
262       $obj->toBeUnthreaded($messages)
263           Inherited, see "Internals" in Mail::Box
264
265       $obj->updateMessages(%options)
266           Inherited, see "Internals" in Mail::Box
267
268       $obj->write(%options)
269           Inherited, see "Internals" in Mail::Box
270
271       $obj->writeMessages(%options)
272           Inherited, see "Internals" in Mail::Box::POP3
273
274   Other methods
275       Extends "Other methods" in Mail::Box::POP3.
276
277       $obj->timespan2seconds($time)
278       Mail::Box::POP3s->timespan2seconds($time)
279           Inherited, see "Other methods" in Mail::Box
280
281   Error handling
282       Extends "Error handling" in Mail::Box::POP3.
283
284       $obj->AUTOLOAD()
285           Inherited, see "Error handling" in Mail::Reporter
286
287       $obj->addReport($object)
288           Inherited, see "Error handling" in Mail::Reporter
289
290       $obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level,
291       $callback] )
292       Mail::Box::POP3s->defaultTrace( [$level]|[$loglevel,
293       $tracelevel]|[$level, $callback] )
294           Inherited, see "Error handling" in Mail::Reporter
295
296       $obj->errors()
297           Inherited, see "Error handling" in Mail::Reporter
298
299       $obj->log( [$level, [$strings]] )
300       Mail::Box::POP3s->log( [$level, [$strings]] )
301           Inherited, see "Error handling" in Mail::Reporter
302
303       $obj->logPriority($level)
304       Mail::Box::POP3s->logPriority($level)
305           Inherited, see "Error handling" in Mail::Reporter
306
307       $obj->logSettings()
308           Inherited, see "Error handling" in Mail::Reporter
309
310       $obj->notImplemented()
311           Inherited, see "Error handling" in Mail::Reporter
312
313       $obj->report( [$level] )
314           Inherited, see "Error handling" in Mail::Reporter
315
316       $obj->reportAll( [$level] )
317           Inherited, see "Error handling" in Mail::Reporter
318
319       $obj->trace( [$level] )
320           Inherited, see "Error handling" in Mail::Reporter
321
322       $obj->warnings()
323           Inherited, see "Error handling" in Mail::Reporter
324
325   Cleanup
326       Extends "Cleanup" in Mail::Box::POP3.
327
328       $obj->DESTROY()
329           Inherited, see "Cleanup" in Mail::Box
330

DETAILS

332       Extends "DETAILS" in Mail::Box::POP3.
333

DIAGNOSTICS

335       Error: Cannot create POP3 client for $name.
336           The connection to the POP3 server cannot be established.  You may
337           see more, related, error messages about the failure.
338
339       Error: Cannot find head back for $uidl on POP3 server $name.
340           The server told to have this message, but when asked for its
341           headers, no single line was returned.  Did the message get
342           destroyed?
343
344       Error: Cannot read body for $uidl on POP3 server $name.
345           The message's headers are retrieved from the server, but the body
346           seems to be lost.  Did the message get destroyed between reading
347           the header and reading the body?
348
349       Warning: Changes not written to read-only folder $self.
350           You have opened the folder read-only --which is the default set by
351           new(access)--, made modifications, and now want to close it.  Set
352           close(force) if you want to overrule the access mode, or close the
353           folder with close(write) set to "NEVER".
354
355       Error: Copying failed for one message.
356           For some reason, for instance disc full, removed by external
357           process, or read-protection, it is impossible to copy one of the
358           messages.  Copying will proceed for the other messages.
359
360       Error: Destination folder $name is not writable.
361           The folder where the messages are copied to is not opened with
362           write access (see new(access)).  This has no relation with write
363           permission to the folder which is controlled by your operating
364           system.
365
366       Warning: Different messages with id $msgid
367           The message id is discovered more than once within the same folder,
368           but the content of the message seems to be different.  This should
369           not be possible: each message must be unique.
370
371       Error: Folder $name is opened read-only
372           You can not write to this folder unless you have opened the folder
373           to write or append with new(access), or the "force" option is set
374           true.
375
376       Error: Invalid timespan '$timespan' specified.
377           The string does not follow the strict rules of the time span syntax
378           which is permitted as parameter.
379
380       Warning: Message $uidl on POP3 server $name disappeared.
381           The server indicated the existence of this message before, however
382           it has no information about the message anymore.
383
384       Warning: Message-id '$msgid' does not contain a domain.
385           According to the RFCs, message-ids need to contain a unique random
386           part, then an "@", and then a domain name.  This is made to avoid
387           the creation of two messages with the same id.  The warning emerges
388           when the "@" is missing from the string.
389
390       Warning: POP3 folders cannot be deleted.
391           Each user has only one POP3 folder on a server.  This folder is
392           created and deleted by the server's administrator only.
393
394       Error: Package $package does not implement $method.
395           Fatal error: the specific package (or one of its superclasses) does
396           not implement this method where it should. This message means that
397           some other related classes do implement this method however the
398           class at hand does not.  Probably you should investigate this and
399           probably inform the author of the package.
400
401       Error: Unable to create subfolder $name of $folder.
402           The copy includes the subfolders, but for some reason it was not
403           possible to copy one of these.  Copying will proceed for all other
404           sub-folders.
405
406       Error: Update of $nr messages ignored for POP3 folder $name.
407           The standard POP3 implementation does not support writing from
408           client back to the server.  Therefore, modifications may be lost.
409
410       Error: Writing folder $name failed
411           For some reason (you probably got more error messages about this
412           problem) it is impossible to write the folder, although you should
413           because there were changes made.
414
415       Error: You cannot write a message to a pop server (yet)
416           Some extensions to the POP3 protocol do permit writing messages to
417           the server, but the standard protocol only implements retreival.
418           Feel invited to extend our implementation with writing.
419

SEE ALSO

421       This module is part of Mail-Box-POP3 distribution version 3.005, built
422       on May 03, 2019. Website: http://perl.overmeer.net/CPAN/
423

LICENSE

425       Copyrights 2001-2019 by [Mark Overmeer]. For other contributors see
426       ChangeLog.
427
428       This program is free software; you can redistribute it and/or modify it
429       under the same terms as Perl itself.  See http://dev.perl.org/licenses/
430
431
432
433perl v5.36.0                      2022-07-22               Mail::Box::POP3s(3)
Impressum