mail-storage-private.h revision 65f8fb656051f1059f7b5a2da9c5555adcc30439
#ifndef MAIL_STORAGE_PRIVATE_H
#define MAIL_STORAGE_PRIVATE_H
#include "module-context.h"
#include "file-lock.h"
#include "mail-storage.h"
#include "mail-storage-settings.h"
#include "mail-index-private.h"
/* Block size when read()ing message. */
/* Called after mail storage has been created */
/* Called after mailbox has been opened */
/* Called after mailbox index has been opened */
struct mail_storage_module_register {
unsigned int id;
};
struct mail_module_register {
unsigned int id;
};
struct mail_storage_vfuncs {
const struct setting_parser_info *(*get_setting_parser_info)(void);
void (*class_init)(void);
void (*class_deinit)(void);
struct mail_storage *(*alloc)(void);
const char **error_r);
const char *name,
enum mailbox_open_flags flags);
bool directory);
};
union mail_storage_module_context {
struct mail_storage_vfuncs super;
struct mail_storage_module_register *reg;
};
struct mail_storage {
const char *name;
bool mailbox_is_file;
struct mail_storage_vfuncs v;
/* private: */
char *error_string;
enum mail_error error;
const struct mail_storage *storage_class;
struct mail_namespace *ns;
struct mailbox_list *list;
const char *temp_path_prefix;
const struct mail_storage_settings *set;
enum mail_storage_flags flags;
enum file_lock_method lock_method;
struct mail_storage_callbacks *callbacks;
void *callback_context;
/* Module-specific contexts. See mail_storage_module_id. */
};
struct mailbox_vfuncs {
struct mailbox_status *status_r);
/* Lookup sync extension record and figure out if it mailbox has
changed since. Returns 1 = yes, 0 = no, -1 = error. */
struct mail_index_view *list_view,
/* Update the sync extension record. Returns 0 = ok, -1 = error. */
struct mail_index_transaction *trans,
struct mailbox_sync_context *
enum mailbox_sync_flags flags);
struct mailbox_sync_rec *sync_rec_r);
struct mailbox_status *status_r);
/* Called once for each expunge. Called one or more times for
uid=0 and sync_type=0. */
enum mailbox_sync_type sync_type);
struct mailbox_transaction_context *
enum mailbox_transaction_flags flags);
int (*transaction_commit)(struct mailbox_transaction_context *t,
void (*transaction_rollback)(struct mailbox_transaction_context *t);
void (*transaction_set_max_modseq)(struct mailbox_transaction_context *t,
const char *const keywords[],
struct mail_keywords **keywords_r,
bool skip_invalid);
const char **error_r);
const char *backend_mailbox,
bool only_with_msgs);
struct mail *
(*mail_alloc)(struct mailbox_transaction_context *t,
struct mailbox_header_lookup_ctx *wanted_headers);
struct mailbox_header_lookup_ctx *
const char *const headers[]);
struct mail_search_context *
(*search_init)(struct mailbox_transaction_context *t,
struct mail_search_args *args,
const enum mail_sort_type *sort_program);
/* Internal search function which updates ctx->seq */
struct mail_save_context *
(*save_alloc)(struct mailbox_transaction_context *t);
};
union mailbox_module_context {
struct mailbox_vfuncs super;
struct mail_storage_module_register *reg;
};
struct mailbox {
char *name;
struct mail_storage *storage;
struct mailbox_vfuncs v;
/* private: */
enum mailbox_open_flags open_flags;
unsigned int transaction_count;
/* User's private flags if this is a shared mailbox */
enum mail_flags private_flags_mask;
/* Mailbox notification settings: */
unsigned int notify_min_interval;
void *notify_context;
/* Saved search results */
/* Module-specific contexts. See mail_storage_module_id. */
/* When FAST open flag is used, the mailbox isn't actually opened until
it's synced for the first time. */
unsigned int opened:1;
/* Mailbox was deleted while we had it open. */
unsigned int mailbox_deleted:1;
};
struct mail_vfuncs {
const ARRAY_TYPE(keyword_indexes) *
const struct message_part **parts_r);
bool decode_to_utf8, const char **value_r);
bool decode_to_utf8, const char *const **value_r);
struct mailbox_header_lookup_ctx *headers,
struct message_size *body_size,
const char **value_r);
enum mail_flags flags);
struct mail_keywords *keywords);
enum mail_fetch_field field);
};
union mail_module_context {
struct mail_vfuncs super;
struct mail_module_register *reg;
};
struct mail_private {
struct mail_vfuncs v;
struct mailbox_header_lookup_ctx *wanted_headers;
};
struct mailbox_list_context {
struct mail_storage *storage;
enum mailbox_list_flags flags;
bool failed;
};
struct mail_storage_module_register *reg;
};
struct mailbox_transaction_context {
union mailbox_transaction_module_context *);
};
union mail_search_module_context {
struct mail_storage_module_register *reg;
};
struct mail_search_context {
struct mailbox_transaction_context *transaction;
struct mail_search_args *args;
struct mail_search_sort_program *sort_program;
/* if non-NULL, specifies that a search resulting is being updated.
this can be used as a search optimization: if searched message
already exists in search result, it's not necessary to check if
static data matches. */
struct mail_search_result *update_result;
/* add matches to these search results */
unsigned int seen_lost_data:1;
unsigned int progress_hidden:1;
};
struct mail_save_context {
struct mailbox_transaction_context *transaction;
enum mail_flags flags;
struct mail_keywords *keywords;
int received_tz_offset;
char *guid, *from_envelope;
};
struct mailbox_sync_context {
};
struct mailbox_header_lookup_ctx {
const char *const *headers;
};
/* Modules should use do "my_id = mail_storage_module_id++" and
use objects' module_contexts[id] for their own purposes. */
extern struct mail_storage_module_register mail_storage_module_register;
/* Storage's module_id for mail_index. */
extern struct mail_module_register mail_module_register;
#define MAIL_STORAGE_CONTEXT(obj) \
/* Set error message in storage. Critical errors are logged with i_error(),
but user sees only "internal error" message. */
const char *mail_generate_guid_string(void);
#endif