src/director/director.h

	director.h revision 1df39b899804fd1dbc560f75382364822935c857
#ifndef DIRECTOR_H
#define DIRECTOR_H

#include "network.h"
#include "director-settings.h"

#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;
};

extern bool director_debug;

/* 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);

void dir_debug(const char *fmt, ...) ATTR_FORMAT(1, 2);

#endif