Quick Navigator

Search Site

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

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  NET::IMAP::SERVER::DEFAULTMODEL (3)

.ds Aq ’


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.

    root MAILBOX

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.

    split PATH

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.

    lookup PATH

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.
Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 NET::IMAP::SERVER::DEFAULTMODEL (3) 2011-10-26

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