src/lib-storage/mail-storage-private.h

	mail-storage-private.h revision a27e065f1a1f91c7fbdf7c2ea1c387441af0cbb3
45312f52ff3a3d4c137447be4c7556500c2f8bf2Timo Sirainen#ifndef __MAIL_STORAGE_PRIVATE_H
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen#define __MAIL_STORAGE_PRIVATE_H
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen#include "mail-storage.h"
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen/* Some error strings that should be used everywhere to avoid
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen   permissions checks from revealing mailbox's existence */
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen#define MAIL_STORAGE_ERR_MAILBOX_NOT_FOUND "Mailbox doesn't exist: %s"
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen#define MAIL_STORAGE_ERR_NO_PERMISSION "Permission denied"
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen/* Called after mailbox has been opened */
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainenextern void (*hook_mailbox_opened)(struct mailbox *box);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainenstruct mail_storage_vfuncs {
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    void (*class_init)(void);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    void (*class_deinit)(void);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    struct mail_storage *
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen        (*create)(const char *data, const char *user,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen              enum mail_storage_flags flags,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen              enum mail_storage_lock_method lock_method);
4ded3d18fa391ae5908f9834f1390cf55e8c99d5Timo Sirainen    void (*destroy)(struct mail_storage *storage);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    bool (*autodetect)(const char *data, enum mail_storage_flags flags);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    void (*set_callbacks)(struct mail_storage *storage,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                  struct mail_storage_callbacks *callbacks,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                  void *context);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    const char *(*get_mailbox_control_dir)(struct mail_storage *storage,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                           const char *name);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    const char *(*get_mailbox_index_dir)(struct mail_storage *storage,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                         const char *name);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    struct mailbox *(*mailbox_open)(struct mail_storage *storage,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                    const char *name,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                    struct istream *input,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                    enum mailbox_open_flags flags);
4ded3d18fa391ae5908f9834f1390cf55e8c99d5Timo Sirainen
4ded3d18fa391ae5908f9834f1390cf55e8c99d5Timo Sirainen    int (*mailbox_create)(struct mail_storage *storage, const char *name,
4ded3d18fa391ae5908f9834f1390cf55e8c99d5Timo Sirainen                  bool directory);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    int (*mailbox_delete)(struct mail_storage *storage, const char *name);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    int (*mailbox_rename)(struct mail_storage *storage, const char *oldname,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen                  const char *newname);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
ba153863e55d75a7c2f28c9c010a905b8887b62bTimo Sirainen    int (*is_mailbox)(struct mail_storage *storage,
b3a069922c8150a1cb14ec7683444f60dee98b55Timo Sirainen              const char *dir, const char *fname,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen              enum mailbox_list_iter_flags iter_flags,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen              enum mailbox_info_flags *flags,
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen              enum mailbox_list_file_type type);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    const char *(*get_last_error)(struct mail_storage *storage,
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen                      bool *syntax_error_r,
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen                      bool *temporary_error_r);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen};
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainenstruct mail_storage {
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    char *name;
7b9f0c6aba07358e5520dc60c058126a4cae4056Timo Sirainen    bool mailbox_is_file;
7b9f0c6aba07358e5520dc60c058126a4cae4056Timo Sirainen
7b9f0c6aba07358e5520dc60c058126a4cae4056Timo Sirainen        struct mail_storage_vfuncs v;
7b9f0c6aba07358e5520dc60c058126a4cae4056Timo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen/* private: */
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    pool_t pool;
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    char *error;
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    struct mailbox_list *list;
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    enum mail_storage_flags flags;
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen        enum mail_storage_lock_method lock_method;
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    /* Module-specific contexts. See mail_storage_module_id. */
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    ARRAY_DEFINE(module_contexts, void);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    /* IMAP: Give a BAD reply instead of NO */
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    unsigned int syntax_error:1;
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    /* Internal temporary error, as opposed to visible user errors like
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen       "permission denied" or "out of disk space" */
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    unsigned int temporary_error:1;
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen};
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainenstruct mailbox_vfuncs {
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    bool (*is_readonly)(struct mailbox *box);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    bool (*allow_new_keywords)(struct mailbox *box);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen    int (*close)(struct mailbox *box);
128ab2c52a29068be87e12ab5aebbb8fdc933adfTimo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    int (*get_status)(struct mailbox *box, enum mailbox_status_items items,
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen              struct mailbox_status *status);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    struct mailbox_sync_context *
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen        (*sync_init)(struct mailbox *box,
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen                 enum mailbox_sync_flags flags);
e156adefc1260d31a145df2f5e9b3c82050d4163Timo Sirainen    int (*sync_next)(struct mailbox_sync_context *ctx,
             struct mailbox_sync_rec *sync_rec_r);
    int (*sync_deinit)(struct mailbox_sync_context *ctx,
               struct mailbox_status *status_r);

    void (*notify_changes)(struct mailbox *box, unsigned int min_interval,
                   mailbox_notify_callback_t *callback,
                   void *context);

    struct mailbox_transaction_context *
        (*transaction_begin)(struct mailbox *box,
                     enum mailbox_transaction_flags flags);
    int (*transaction_commit)(struct mailbox_transaction_context *t,
                  enum mailbox_sync_flags flags);
    void (*transaction_rollback)(struct mailbox_transaction_context *t);

    struct mail_keywords *
        (*keywords_create)(struct mailbox_transaction_context *t,
                   const char *const keywords[]);
    void (*keywords_free)(struct mailbox_transaction_context *t,
                  struct mail_keywords *keywords);

    int (*get_uids)(struct mailbox *box, uint32_t uid1, uint32_t uid2,
            uint32_t *seq1_r, uint32_t *seq2_r);

    struct mail *
        (*mail_alloc)(struct mailbox_transaction_context *t,
                  enum mail_fetch_field wanted_fields,
                  struct mailbox_header_lookup_ctx *wanted_headers);

    struct mailbox_header_lookup_ctx *
        (*header_lookup_init)(struct mailbox *box,
                      const char *const headers[]);
    void (*header_lookup_deinit)(struct mailbox_header_lookup_ctx *ctx);

    struct mail_search_context *
    (*search_init)(struct mailbox_transaction_context *t,
               const char *charset, struct mail_search_arg *args,
               const enum mail_sort_type *sort_program);
    int (*search_deinit)(struct mail_search_context *ctx);
    int (*search_next)(struct mail_search_context *ctx, struct mail *mail);
    /* Internal search function which updates ctx->seq */
    int (*search_next_update_seq)(struct mail_search_context *ctx);

    int (*save_init)(struct mailbox_transaction_context *t,
             enum mail_flags flags,
             struct mail_keywords *keywords,
             time_t received_date, int timezone_offset,
             const char *from_envelope, struct istream *input,
             struct mail *dest_mail,
             struct mail_save_context **ctx_r);
    int (*save_continue)(struct mail_save_context *ctx);
    int (*save_finish)(struct mail_save_context *ctx);
    void (*save_cancel)(struct mail_save_context *ctx);

    int (*copy)(struct mailbox_transaction_context *t, struct mail *mail,
            enum mail_flags flags, struct mail_keywords *keywords,
            struct mail *dest_mail);

    bool (*is_inconsistent)(struct mailbox *box);
};

struct mailbox {
    char *name;
    struct mail_storage *storage;

        struct mailbox_vfuncs v;
/* private: */
    pool_t pool;

    /* Module-specific contexts. See mail_storage_module_id. */
    ARRAY_DEFINE(module_contexts, void);
};

struct mail_vfuncs {
    void (*free)(struct mail *mail);
    int (*set_seq)(struct mail *mail, uint32_t seq);
    int (*set_uid)(struct mail *mail, uint32_t uid);

    enum mail_flags (*get_flags)(struct mail *mail);
    const char *const *(*get_keywords)(struct mail *mail);
    const struct message_part *(*get_parts)(struct mail *mail);

    time_t (*get_date)(struct mail *mail, int *timezone);
    time_t (*get_received_date)(struct mail *mail);
    time_t (*get_save_date)(struct mail *mail);
    uoff_t (*get_virtual_size)(struct mail *mail);
    uoff_t (*get_physical_size)(struct mail *mail);

    const char *(*get_first_header)(struct mail *mail, const char *field);
    const char *const *(*get_headers)(struct mail *mail, const char *field);
    struct istream *
        (*get_header_stream)(struct mail *mail,
                     struct mailbox_header_lookup_ctx *headers);
    struct istream *(*get_stream)(struct mail *mail,
                      struct message_size *hdr_size,
                      struct message_size *body_size);

    const char *(*get_special)(struct mail *mail,
                   enum mail_fetch_field field);

    int (*update_flags)(struct mail *mail, enum modify_type modify_type,
                enum mail_flags flags);
    int (*update_keywords)(struct mail *mail, enum modify_type modify_type,
                   struct mail_keywords *keywords);

    int (*expunge)(struct mail *mail);
};

struct mail_private {
    struct mail mail;
    struct mail_vfuncs v;

    pool_t pool;
    ARRAY_DEFINE(module_contexts, void);
};

struct mailbox_list_context {
    struct mail_storage *storage;
    enum mailbox_list_flags flags;
    bool failed;
};

struct mailbox_transaction_context {
    struct mailbox *box;
    ARRAY_DEFINE(module_contexts, void);
};

struct mail_search_context {
    struct mailbox_transaction_context *transaction;

    char *charset;
    struct mail_search_arg *args;
    struct mail_search_sort_program *sort_program;

    uint32_t seq;
    ARRAY_DEFINE(module_contexts, void);
};

struct mail_save_context {
    struct mailbox_transaction_context *transaction;
    struct mail *dest_mail;
};

struct mailbox_sync_context {
    struct mailbox *box;
};

struct mailbox_header_lookup_ctx {
    struct mailbox *box;
};

/* Modules should use do "my_id = mail_storage_module_id++" and
   use objects' module_contexts[id] for their own purposes. */
extern unsigned int mail_storage_module_id;

/* Storage's module_id for mail_index. */
extern unsigned int mail_storage_mail_index_module_id;

#define MAIL_STORAGE_INDEX(index) \
    *((void **)array_idx_modifiable( \
        &(index)->mail_index_module_contexts, \
        mail_storage_mail_index_module_id))

#define MAIL_STORAGE_VIEW(view) \
    *((void **)array_idx_modifiable( \
        &(view)->mail_index_view_module_contexts, \
        mail_storage_mail_index_module_id))

#define MAIL_STORAGE_TRANSACTION(trans) \
    *((void **)array_idx_modifiable( \
        &(trans)->mail_index_transaction_module_contexts, \
        mail_storage_mail_index_module_id))

/* Set error message in storage. Critical errors are logged with i_error(),
   but user sees only "internal error" message. */
void mail_storage_clear_error(struct mail_storage *storage);
void mail_storage_set_error(struct mail_storage *storage,
                const char *fmt, ...) __attr_format__(2, 3);
void mail_storage_set_syntax_error(struct mail_storage *storage,
                   const char *fmt, ...) __attr_format__(2, 3);
void mail_storage_set_critical(struct mail_storage *storage,
                   const char *fmt, ...) __attr_format__(2, 3);
void mail_storage_set_internal_error(struct mail_storage *storage);

const char *mail_storage_class_get_last_error(struct mail_storage *storage,
                          bool *syntax_error_r);

enum mailbox_list_flags
mail_storage_get_list_flags(enum mail_storage_flags storage_flags);
int mailbox_storage_list_is_mailbox(const char *dir, const char *fname,
                    enum mailbox_list_file_type type,
                    enum mailbox_list_iter_flags iter_flags,
                    enum mailbox_info_flags *flags,
                    void *context);

#endif