This documentation is for Dovecot v1.x, see wiki2 for v2.x documentation.

Mail User

src/lib-storage/mail-user.h describes mail user. The struct contains all kinds of useful information about the user that can be accessed directly. Some of the most useful things you can do with a user are:

Typically each new IMAP/POP3/etc. connection creates a single mail user. Currently multiple connections for same user don't even try to share the mail user, but this may change in future. If a user has shared mailboxes from other users (not public namespaces), a mail user is also created whenever necessary to list/access the user's mailboxes. Again there is no attempt to share the created mail user with other connections.