src/lib-storage/mail-namespace.h

	mail-namespace.h revision a10ed8c47534b4c6b6bf2711ccfe577e720a47b4
#ifndef MAIL_NAMESPACE_H
#define MAIL_NAMESPACE_H

#include "mail-user.h"

struct mail_storage_callbacks;

enum namespace_type {
    NAMESPACE_PRIVATE   = 0x01,
    NAMESPACE_SHARED    = 0x02,
    NAMESPACE_PUBLIC    = 0x04
};

enum namespace_flags {
    /* Namespace contains the user's INBOX mailbox (there can be only
       one) */
    NAMESPACE_FLAG_INBOX_USER   = 0x01,
    /* Namespace contains someone's INBOX. This is set for both user's
       INBOX namespace and also for any other users' shared namespaces. */
    NAMESPACE_FLAG_INBOX_ANY    = 0x02,
    /* Namespace is visible only by explicitly using its full prefix */
    NAMESPACE_FLAG_HIDDEN       = 0x04,
    /* Namespace prefix is visible with LIST */
    NAMESPACE_FLAG_LIST_PREFIX  = 0x08,
    /* Namespace prefix isn't visible with LIST, but child mailboxes are */
    NAMESPACE_FLAG_LIST_CHILDREN    = 0x10,
    /* Namespace uses its own subscriptions. */
    NAMESPACE_FLAG_SUBSCRIPTIONS    = 0x20,

    /* Namespace was created automatically (for shared mailboxes) */
    NAMESPACE_FLAG_AUTOCREATED  = 0x1000,
    /* Namespace has at least some usable mailboxes. Autocreated namespaces
       that don't have usable mailboxes may be removed automatically. */
    NAMESPACE_FLAG_USABLE       = 0x2000,
    /* Automatically created namespace for a user that doesn't exist. */
    NAMESPACE_FLAG_UNUSABLE     = 0x4000,
    /* Don't track quota for this namespace */
    NAMESPACE_FLAG_NOQUOTA      = 0x8000,
    /* Don't enforce ACLs for this namespace */
    NAMESPACE_FLAG_NOACL        = 0x10000
};

struct mail_namespace {
    /* Namespaces are sorted by their prefix length, "" comes first */
    struct mail_namespace *next;
    int refcount;

        enum namespace_type type;
    enum namespace_flags flags;

    char *prefix;
    size_t prefix_len;

    /* If non-NULL, this points to a namespace with identical mail location
       and it should be considered as the primary way to access the
       mailboxes. This allows for example FTS plugin to avoid duplicating
       indexes for same mailboxes when they're accessed via different
       namespaces. */
    struct mail_namespace *alias_for;
    /* alias_for->alias_chain_next starts each chain. The chain goes
       through all namespaces that have the same alias_for. */
    struct mail_namespace *alias_chain_next;

    struct mail_user *user, *owner;
    struct mailbox_list *list;
    /* FIXME: we should support multiple storages in one namespace */
    struct mail_storage *storage;

    struct mail_namespace_settings *set, *unexpanded_set;
    const struct mail_storage_settings *mail_set;

    unsigned int destroyed:1;
};

int mail_namespaces_init(struct mail_user *user, const char **error_r);
int mail_namespaces_init_location(struct mail_user *user, const char *location,
                  const char **error_r) ATTR_NULL(2);
struct mail_namespace *mail_namespaces_init_empty(struct mail_user *user);
/* Deinitialize all namespaces. mail_user_deinit() calls this automatically
   for user's namespaces. */
void mail_namespaces_deinit(struct mail_namespace **namespaces);

void mail_namespace_ref(struct mail_namespace *ns);
void mail_namespace_unref(struct mail_namespace **ns);

/* Set storage callback functions to use in all namespaces. */
void mail_namespaces_set_storage_callbacks(struct mail_namespace *namespaces,
                       struct mail_storage_callbacks *callbacks,
                       void *context);

/* Add a new storage to namespace. */
void mail_namespace_add_storage(struct mail_namespace *ns,
                struct mail_storage *storage);
/* Destroy a single namespace and remove it from user's namespaces list. */
void mail_namespace_destroy(struct mail_namespace *ns);

/* Returns the default storage to use for newly created mailboxes. */
struct mail_storage *
mail_namespace_get_default_storage(struct mail_namespace *ns);

/* Return namespace's hierarchy separator. */
char mail_namespace_get_sep(struct mail_namespace *ns);
/* Returns the hierarchy separator for mailboxes that are listed at root. */
char mail_namespaces_get_root_sep(struct mail_namespace *namespaces)
    ATTR_PURE;

/* Returns namespace based on the mailbox name's prefix, or NULL if no matching
   namespace could be found. */
struct mail_namespace *
mail_namespace_find(struct mail_namespace *namespaces, const char *mailbox);
/* Find namespace for mailbox and return it. If the namespace has alias_for
   set, return that namespace instead and change mailbox name to be a valid
   inside it. */
struct mail_namespace *
mail_namespace_find_unalias(struct mail_namespace *namespaces,
                const char **mailbox);
/* Like above, but ignore hidden namespaces. */
struct mail_namespace *
mail_namespace_find_visible(struct mail_namespace *namespaces,
                const char *mailbox);
/* Like above, but find only from namespaces with subscriptions flag set. */
struct mail_namespace *
mail_namespace_find_subscribable(struct mail_namespace *namespaces,
                 const char *mailbox);
/* Like above, but find only from namespaces with subscriptions flag not set. */
struct mail_namespace *
mail_namespace_find_unsubscribable(struct mail_namespace *namespaces,
                   const char *mailbox);
/* Returns the INBOX namespace */
struct mail_namespace *
mail_namespace_find_inbox(struct mail_namespace *namespaces);
/* Find a namespace with given prefix. */
struct mail_namespace *
mail_namespace_find_prefix(struct mail_namespace *namespaces,
               const char *prefix);
/* Like _find_prefix(), but ignore trailing separator */
struct mail_namespace *
mail_namespace_find_prefix_nosep(struct mail_namespace *namespaces,
                 const char *prefix);

/* Called internally by mailbox_list_create(). */
void mail_namespace_finish_list_init(struct mail_namespace *ns,
                     struct mailbox_list *list);

#endif