director.h revision 3ee8a7ee6912c7caa4e83d3ce5a5db1590a7ffcd
df0f31230faf76eaf3a4eac5eaac78389167caa6Lubos Kosco#ifndef DIRECTOR_H
df0f31230faf76eaf3a4eac5eaac78389167caa6Lubos Kosco#define DIRECTOR_H
df0f31230faf76eaf3a4eac5eaac78389167caa6Lubos Kosco
df0f31230faf76eaf3a4eac5eaac78389167caa6Lubos Kosco#include "network.h"
df0f31230faf76eaf3a4eac5eaac78389167caa6Lubos Kosco#include "director-settings.h"
df0f31230faf76eaf3a4eac5eaac78389167caa6Lubos Kosco
#define DIRECTOR_VERSION_NAME "director"
#define DIRECTOR_VERSION_MAJOR 1
#define DIRECTOR_VERSION_MINOR 3
/* weak users supported in protocol v1.1+ */
#define DIRECTOR_VERSION_WEAK_USERS 1
/* director removes supported in v1.2+ */
#define DIRECTOR_VERSION_RING_REMOVE 2
/* quit reason supported in v1.3+ */
#define DIRECTOR_VERSION_QUIT 3
/* Minimum time between even attempting to communicate with a director that
failed due to a protocol error. */
#define DIRECTOR_PROTOCOL_FAILURE_RETRY_SECS 60
struct director;
struct mail_host;
struct user;
typedef void director_state_change_callback_t(struct director *dir);
struct director {
const struct director_settings *set;
/* IP and port of this director. self_host->ip/port must equal these. */
struct ip_addr self_ip;
unsigned int self_port;
unsigned int test_port;
struct director_host *self_host;
/* left and right connections are set only after they have finished
handshaking. until then they're in the connections list, although
updates are still sent to them during handshaking if the USER list
is long. */
struct director_connection *left, *right;
/* all director connections */
ARRAY_DEFINE(connections, struct director_connection *);
struct timeout *to_reconnect;
struct timeout *to_sync;
struct timeout *to_callback;
/* current mail hosts */
struct mail_host_list *mail_hosts;
/* original mail hosts configured in config file.
this is used only for doveadm lookups */
struct mail_host_list *orig_config_hosts;
/* temporary user -> host associations */
struct user_directory *users;
/* these requests are waiting for directors to be in synced */
ARRAY_DEFINE(pending_requests, struct director_request *);
struct timeout *to_request;
struct timeout *to_handshake_warning;
director_state_change_callback_t *state_change_callback;
/* director hosts are sorted by IP (and port) */
ARRAY_DEFINE(dir_hosts, struct director_host *);
struct timeout *to_remove_dirs;
struct ipc_client *ipc_proxy;
unsigned int sync_seq;
/* the lowest minor version supported by the ring */
unsigned int ring_min_version;
time_t ring_last_sync_time;
time_t ring_first_alone;
/* director ring handshaking is complete.
director can start serving clients. */
unsigned int ring_handshaked:1;
unsigned int ring_handshake_warning_sent:1;
unsigned int ring_synced:1;
unsigned int sync_frozen:1;
unsigned int sync_pending:1;
unsigned int debug:1;
};
/* Create a new director. If listen_ip specifies an actual IP, it's used with
listen_port for finding ourself from the director_servers setting.
listen_port is used regardless by director_host_add_from_string() for hosts
without specified port. */
struct director *
director_init(const struct director_settings *set,
const struct ip_addr *listen_ip, unsigned int listen_port,
director_state_change_callback_t *callback);
void director_deinit(struct director **dir);
void director_find_self(struct director *dir);
/* Start connecting to other directors */
void director_connect(struct director *dir);
void director_set_ring_handshaked(struct director *dir);
void director_set_ring_synced(struct director *dir);
void director_set_ring_unsynced(struct director *dir);
void director_set_state_changed(struct director *dir);
void director_sync_send(struct director *dir, struct director_host *host,
uint32_t seq, unsigned int minor_version);
bool director_resend_sync(struct director *dir);
void director_notify_ring_added(struct director_host *added_host,
struct director_host *src);
void director_ring_remove(struct director_host *removed_host,
struct director_host *src);
void director_update_host(struct director *dir, struct director_host *src,
struct director_host *orig_src,
struct mail_host *host);
void director_remove_host(struct director *dir, struct director_host *src,
struct director_host *orig_src,
struct mail_host *host);
void director_flush_host(struct director *dir, struct director_host *src,
struct director_host *orig_src,
struct mail_host *host);
void director_update_user(struct director *dir, struct director_host *src,
struct user *user);
void director_update_user_weak(struct director *dir, struct director_host *src,
struct director_host *orig_src,
struct user *user);
void director_move_user(struct director *dir, struct director_host *src,
struct director_host *orig_src,
unsigned int username_hash, struct mail_host *host);
void director_user_killed(struct director *dir, unsigned int username_hash);
void director_user_killed_everywhere(struct director *dir,
struct director_host *src,
struct director_host *orig_src,
unsigned int username_hash);
void director_user_weak(struct director *dir, struct user *user);
void director_sync_freeze(struct director *dir);
void director_sync_thaw(struct director *dir);
/* Send data to all directors using both left and right connections
(unless they're the same). */
void director_update_send(struct director *dir, struct director_host *src,
const char *cmd);
void director_update_send_version(struct director *dir,
struct director_host *src,
unsigned int min_version, const char *cmd);
int director_connect_host(struct director *dir, struct director_host *host);
#endif