view src/doveadm/dsync/dsync-deserializer.h @ 22715:20415dd0b85a

dsync: Add per-mailbox sync lock that is always used. Both importing and exporting gets the lock before they even sync the mailbox. The lock is kept until the import/export finishes. This guarantees that no matter how dsync is run, two dsyncs can't be working on the same mailbox at the same time. This lock is in addition to the optional per-user lock enabled by the -l parameter. If the -l parameter is used, the same lock timeout is used for the per-mailbox lock. Otherwise 30s timeout is used. This should help to avoid email duplication when replication is enabled for public namespaces, and maybe in some other rare situations as well.
author Timo Sirainen <timo.sirainen@dovecot.fi>
date Thu, 28 Dec 2017 14:10:23 +0200
parents b2076acc3715
children
line wrap: on
line source

#ifndef DSYNC_DESERIALIZER_H
#define DSYNC_DESERIALIZER_H

struct dsync_deserializer;
struct dsync_deserializer_decoder;

int dsync_deserializer_init(const char *name, const char *const *required_fields,
			    const char *header_line,
			    struct dsync_deserializer **deserializer_r,
			    const char **error_r);
void dsync_deserializer_deinit(struct dsync_deserializer **deserializer);

int dsync_deserializer_decode_begin(struct dsync_deserializer *deserializer,
				    const char *input,
				    struct dsync_deserializer_decoder **decoder_r,
				    const char **error_r);
bool dsync_deserializer_decode_try(struct dsync_deserializer_decoder *decoder,
				   const char *key, const char **value_r);
/* key must be in required fields. The return value is never NULL. */
const char *
dsync_deserializer_decode_get(struct dsync_deserializer_decoder *decoder,
			      const char *key);
const char *
dsync_deserializer_decoder_get_name(struct dsync_deserializer_decoder *decoder);
void dsync_deserializer_decode_finish(struct dsync_deserializer_decoder **decoder);

#endif