GSP
Quick Navigator
Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Net::IMAP::Server::DefaultModel(3) User Contributed Perl Documentation Net::IMAP::Server::DefaultModel(3)

Net::IMAP::Server::DefaultModel - Encapsulates per-connection information about the layout of IMAP folders.

This class represents an abstract model backend to the IMAP server; it it meant to be overridden by server implementations. Primarily, subclasses are expected to override "init" to set up their folder structure.

Methods in the model can "die" with messages which start with "NO" or "BAD", which will be propagated back to the client immediately. See "handle_command" in Net::IMAP::Server::Connection.

This class is created when the client has successfully authenticated to the server.

Called when the class is instantiated, with no arguments. Subclasses should override this method to inspect the "auth" object, and determine what folders the user should have. The primary purpose of this method is to set "root" to the top level of the mailbox tree. The root is expected to contain a mailbox named "INBOX".

Gets or sets the root Net::IMAP::Server::Mailbox for this model. The root mailbox should contain no messages, and have no name -- it exists purely to contain sub-mailboxes, like "INBOX". The "init" method is responsible for setting up the appropriate root mailbox, and all sub-mailboxes for the model.

Returns the Net::IMAP::Server::DefaultAuth object for this model; this is set by the connection when the model is created, and will always reference a valid authentication object.

Called when this model's connection closes, for any reason. By default, does nothing.

Utility method which splits a given "PATH" according to the mailbox separator, as determined by the "separator" in Net::IMAP::Server::Mailbox of the "root". May "die" if the path (which is expected to be encoded using IMAP-UTF-7) is invalid. See Encode::IMAPUTF7. If the mailbox hierarchy is flat (i.e. the separator is undef), returns the name without change.

Given a "PATH", returns the Net::IMAP::Server::Mailbox for that path, or undef if none matches. May die if the path contains unvalid IMAP-UTF-7 (see "split").

Returns the namespaces of this model, per RFC 2342. Defaults to "INBOX" being the personal namespace, with no "shared" or "other users" namespaces.

2016-05-01 perl v5.40.2
Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.