mail-storage-private.h revision d3280fe317a4598c0868cc440e7a1191c06d0db3
cd56a23e21f1df3f79648cf07e2f4385e2fadebbTimo Sirainen/* Block size when read()ing message header. */
cd56a23e21f1df3f79648cf07e2f4385e2fadebbTimo Sirainen/* Block size when read()ing message (header and) body. */
cd56a23e21f1df3f79648cf07e2f4385e2fadebbTimo Sirainen#define MAIL_READ_FULL_BLOCK_SIZE IO_BLOCK_SIZE
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen unsigned int id;
d5cebe7f98e63d4e2822863ef2faa4971e8b3a5dTimo Sirainen unsigned int id;
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen const struct setting_parser_info *(*get_setting_parser_info)(void);
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen int (*create)(struct mail_storage *storage, struct mail_namespace *ns,
d5cebe7f98e63d4e2822863ef2faa4971e8b3a5dTimo Sirainen const char **error_r);
d5cebe7f98e63d4e2822863ef2faa4971e8b3a5dTimo Sirainen void (*destroy)(struct mail_storage *storage);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen void (*add_list)(struct mail_storage *storage,
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen void (*get_list_settings)(const struct mail_namespace *ns,
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen bool (*autodetect)(const struct mail_namespace *ns,
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen struct mailbox *(*mailbox_alloc)(struct mail_storage *storage,
c0435c854a0e7246373b9752d163095cc4fbe985Timo Sirainen /* mailboxes are files, not directories */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen MAIL_STORAGE_CLASS_FLAG_MAILBOX_IS_FILE = 0x01,
c0435c854a0e7246373b9752d163095cc4fbe985Timo Sirainen /* root_dir points to a unique directory */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* mailbox_open_stream() is supported */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* never use quota for this storage (e.g. virtual mailboxes) */
20344c0e814139e3c365fbb9287478f91512089eTimo Sirainen/* private: */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* counting number of times mail_storage_create() has returned this
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen same storage. */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* counting number of objects (e.g. mailbox) that have a pointer
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen to this storage. */
601f5f14c6cde28f0e0c6ca7c5d735315d3d48dfTimo Sirainen /* Module-specific contexts. See mail_storage_module_id. */
601f5f14c6cde28f0e0c6ca7c5d735315d3d48dfTimo Sirainen ARRAY_DEFINE(module_contexts, union mail_storage_module_context *);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen const char *content_type, *content_disposition;
602a0434db30d8e3292d1c161a803d96a879a74fTimo Sirainen bool (*allow_new_keywords)(struct mailbox *box);
602a0434db30d8e3292d1c161a803d96a879a74fTimo Sirainen int (*enable)(struct mailbox *box, enum mailbox_feature features);
602a0434db30d8e3292d1c161a803d96a879a74fTimo Sirainen int (*create)(struct mailbox *box, const struct mailbox_update *update,
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen int (*update)(struct mailbox *box, const struct mailbox_update *update);
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen int (*rename)(struct mailbox *src, struct mailbox *dest,
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen int (*get_status)(struct mailbox *box, enum mailbox_status_items items,
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen int (*get_guid)(struct mailbox *box, uint8_t guid[MAIL_GUID_128_SIZE]);
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen /* Lookup sync extension record and figure out if it mailbox has
6ef7e31619edfaa17ed044b45861d106a86191efTimo Sirainen changed since. Returns 1 = yes, 0 = no, -1 = error. */
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen int (*list_index_has_changed)(struct mailbox *box,
548e394330621952db0f03dd667b70184c4a37b6Timo Sirainen /* Update the sync extension record. Returns 0 = ok, -1 = error. */
548e394330621952db0f03dd667b70184c4a37b6Timo Sirainen int (*list_index_update_sync)(struct mailbox *box,
7e1f68ad71d3485f1882142837b01f7a98ca8467Timo Sirainen bool (*sync_next)(struct mailbox_sync_context *ctx,
7e1f68ad71d3485f1882142837b01f7a98ca8467Timo Sirainen int (*sync_deinit)(struct mailbox_sync_context *ctx,
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen /* Called once for each expunge. Called one or more times for
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen flag/keyword changes. Once the sync is finished, called with
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen uid=0 and sync_type=0. */
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen void (*sync_notify)(struct mailbox *box, uint32_t uid,
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen int (*transaction_commit)(struct mailbox_transaction_context *t,
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen struct mail_transaction_commit_changes *changes_r);
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen void (*transaction_rollback)(struct mailbox_transaction_context *t);
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen enum mail_flags (*get_private_flags_mask)(struct mailbox *box);
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen (*mail_alloc)(struct mailbox_transaction_context *t,
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen struct mailbox_header_lookup_ctx *wanted_headers);
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen (*search_init)(struct mailbox_transaction_context *t,
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen int (*search_deinit)(struct mail_search_context *ctx);
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen bool (*search_next_nonblock)(struct mail_search_context *ctx,
e0c3d5460d1cc0c440cb7723c8c2eef8d0afe9b9Timo Sirainen /* Internal search function which updates ctx->seq */
c0435c854a0e7246373b9752d163095cc4fbe985Timo Sirainen bool (*search_next_update_seq)(struct mail_search_context *ctx);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen (*save_alloc)(struct mailbox_transaction_context *t);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen int (*save_begin)(struct mail_save_context *ctx, struct istream *input);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen int (*save_continue)(struct mail_save_context *ctx);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen int (*save_finish)(struct mail_save_context *ctx);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen void (*save_cancel)(struct mail_save_context *ctx);
0611067f385a37773800225256dcd5cf6aa34212Timo Sirainen int (*copy)(struct mail_save_context *ctx, struct mail *mail);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* mode and GID to use for newly created files/dirs */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* origin (e.g. path) where the file_create_gid was got from */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* mailbox's virtual name (from mail_namespace_get_vname()) */
89e195dfb5c4b0efd9b9f459771a4467674e5b1fTimo Sirainen/* private: */
89e195dfb5c4b0efd9b9f459771a4467674e5b1fTimo Sirainen /* these won't be set until mailbox is opened: */
89e195dfb5c4b0efd9b9f459771a4467674e5b1fTimo Sirainen /* Filled lazily by mailbox_get_permissions() */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* Filled lazily by mailbox_get_path() */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* default vfuncs for new struct mails. */
8d80659e504ffb34bb0c6a633184fece35751b18Timo Sirainen /* Mailbox notification settings: */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* Saved search results */
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen ARRAY_DEFINE(search_results, struct mail_search_result *);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* Module-specific contexts. See mail_storage_module_id. */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen ARRAY_DEFINE(module_contexts, union mailbox_module_context *);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* When FAST open flag is used, the mailbox isn't actually opened until
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen it's synced for the first time. */
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen /* Mailbox was deleted while we had it open. */
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* Mailbox is being deleted */
6ef7e31619edfaa17ed044b45861d106a86191efTimo Sirainen /* Mailbox was already marked as deleted within this allocation. */
37ab3cde96bfa4bc5304c0c348fc420aec79572dTimo Sirainen /* TRUE if this is an INBOX for this user */
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen /* TRUE if this is an INBOX for this namespace (user or shared) */
37ab3cde96bfa4bc5304c0c348fc420aec79572dTimo Sirainen /* When copying to this mailbox, require that mailbox_copy() uses
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen mailbox_save_*() to actually save a new physical copy rather than
f4bbeadda12fbd7c219063db68f3e78646d83c2cTimo Sirainen simply incrementing a reference count (e.g. via hard link) */
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen void (*set_seq)(struct mail *mail, uint32_t seq);
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen bool (*set_uid)(struct mail *mail, uint32_t uid);
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen void (*set_uid_cache_updates)(struct mail *mail, bool set);
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen enum mail_flags (*get_flags)(struct mail *mail);
c06f4017027263cf3a08becc551f5126409e2a83Timo Sirainen const char *const *(*get_keywords)(struct mail *mail);
904f9d5654b9c39edcdf32883e5e88771faf4d69Timo Sirainen int (*get_date)(struct mail *mail, time_t *date_r, int *timezone_r);
904f9d5654b9c39edcdf32883e5e88771faf4d69Timo Sirainen int (*get_received_date)(struct mail *mail, time_t *date_r);
904f9d5654b9c39edcdf32883e5e88771faf4d69Timo Sirainen int (*get_save_date)(struct mail *mail, time_t *date_r);
904f9d5654b9c39edcdf32883e5e88771faf4d69Timo Sirainen int (*get_virtual_size)(struct mail *mail, uoff_t *size_r);
904f9d5654b9c39edcdf32883e5e88771faf4d69Timo Sirainen int (*get_physical_size)(struct mail *mail, uoff_t *size_r);
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen int (*get_first_header)(struct mail *mail, const char *field,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen int (*get_headers)(struct mail *mail, const char *field,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen bool decode_to_utf8, const char *const **value_r);
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen int (*get_stream)(struct mail *mail, struct message_size *hdr_size,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen int (*get_special)(struct mail *mail, enum mail_fetch_field field,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen const char **value_r);
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen struct mail *(*get_real_mail)(struct mail *mail);
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen void (*update_flags)(struct mail *mail, enum modify_type modify_type,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen void (*update_keywords)(struct mail *mail, enum modify_type modify_type,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen void (*update_modseq)(struct mail *mail, uint64_t min_modseq);
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen void (*update_pop3_uidl)(struct mail *mail, const char *uidl);
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen void (*set_cache_corrupted)(struct mail *mail,
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen int (*istream_opened)(struct mail *mail, struct istream **input);
c0435c854a0e7246373b9752d163095cc4fbe985Timo Sirainen struct mailbox_header_lookup_ctx *wanted_headers;
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen ARRAY_DEFINE(module_contexts, union mail_module_context *);
ecc81625167ed96c04c02aa190a1ea5baa65b474Timo Sirainen /* these statistics are never reset by mail-storage API: */
7ef5ca6fb59a318c821a852ae48a2edbb671d7ddTimo Sirainen /* number of files we've opened and read */
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen /* number of bytes we've had to read from files */
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen unsigned long long stats_files_read_bytes;
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen /* number of cache lookup hits */
07e4875d250e7a7157cd99132aafc773cf3cdf83Timo Sirainen /* Set to TRUE to update stats_* fields */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen union mail_index_transaction_module_context module_ctx;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen /* view contains all changes done within this transaction */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen struct mail_cache_transaction_ctx *cache_trans;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen struct mail_transaction_commit_changes *changes;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen struct mailbox_transaction_context *transaction;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen struct mail_search_sort_program *sort_program;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen /* if non-NULL, specifies that a search resulting is being updated.
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen this can be used as a search optimization: if searched message
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen already exists in search result, it's not necessary to check if
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen static data matches. */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen /* add matches to these search results */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen ARRAY_DEFINE(results, struct mail_search_result *);
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen ARRAY_DEFINE(module_contexts, union mail_search_module_context *);
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen struct mailbox_transaction_context *transaction;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen /* returns TRUE if message part is an attachment. */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen bool (*part_is_attachment)(struct mail_save_context *ctx,
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen /* we came here from mailbox_copy() */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen unsigned int count;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen const char *const *name;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen unsigned int *idx;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen/* Modules should use do "my_id = mail_storage_module_id++" and
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen use objects' module_contexts[id] for their own purposes. */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainenextern struct mail_storage_module_register mail_storage_module_register;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen/* Storage's module_id for mail_index. */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainenextern struct mail_module_register mail_module_register;
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen MODULE_CONTEXT(obj, mail_storage_mail_index_module)
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainenextern MODULE_CONTEXT_DEFINE(mail_storage_mail_index_module,
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainenvoid mail_storage_obj_ref(struct mail_storage *storage);
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainenvoid mail_storage_obj_unref(struct mail_storage *storage);
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen/* Set error message in storage. Critical errors are logged with i_error(),
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainen but user sees only "internal error" message. */
dd62b77c932d1b518f2a3e4bf80e36542becc256Timo Sirainenvoid mail_storage_clear_error(struct mail_storage *storage);
int *fd_r);
unsigned int secs);