src/lib/connection.c

	connection.c revision cb3ab2fd5668700a89b274a43595cfbfa1616e4b
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi/* Copyright (c) 2013-2015 Dovecot authors, see the included COPYING file */
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "lib.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "ioloop.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "istream.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "ostream.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "net.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "strescape.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "llist.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include "connection.h"
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi#include <unistd.h>
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomistatic void connection_idle_timeout(struct connection *conn)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi{
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    conn->disconnect_reason = CONNECTION_DISCONNECT_IDLE_TIMEOUT;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    conn->list->v.destroy(conn);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi}
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomistatic void connection_connect_timeout(struct connection *conn)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi{
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    conn->disconnect_reason = CONNECTION_DISCONNECT_CONNECT_TIMEOUT;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    conn->list->v.destroy(conn);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi}
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomivoid connection_input_default(struct connection *conn)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi{
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    const char *line;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    struct istream *input;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    int ret = 0;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    switch (connection_input_read(conn)) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    case -1:
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        return;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    case 0: /* allow calling this function for buffered input */
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    case 1:
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        break;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    default:
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        i_unreached();
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    input = conn->input;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    i_stream_ref(input);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    while (!input->closed && (line = i_stream_next_line(input)) != NULL) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        T_BEGIN {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            ret = conn->list->v.input_line(conn, line);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        } T_END;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        if (ret <= 0)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            break;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (ret < 0 && !input->closed) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->disconnect_reason = CONNECTION_DISCONNECT_DEINIT;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->list->v.destroy(conn);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    i_stream_unref(&input);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi}
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomiint connection_verify_version(struct connection *conn,
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi                  const char *const *args)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi{
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    unsigned int recv_major_version;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    /* VERSION <tab> service_name <tab> major version <tab> minor version */
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (str_array_length(args) != 4 ||
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        strcmp(args[0], "VERSION") != 0 ||
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        str_to_uint(args[2], &recv_major_version) < 0 ||
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        str_to_uint(args[3], &conn->minor_version) < 0) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        i_error("%s didn't reply with a valid VERSION line",
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            conn->name);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        return -1;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (strcmp(args[1], conn->list->set.service_name_in) != 0) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        i_error("%s: Connected to wrong socket type. "
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            "We want '%s', but received '%s'", conn->name,
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            conn->list->set.service_name_in, args[1]);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        return -1;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (recv_major_version != conn->list->set.major_version) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        i_error("%s: Socket supports major version %u, "
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            "but we support only %u (mixed old and new binaries?)",
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            conn->name, recv_major_version,
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            conn->list->set.major_version);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        return -1;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    return 0;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi}
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomiint connection_input_line_default(struct connection *conn, const char *line)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi{
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    const char *const *args;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    args = t_strsplit_tabescaped(line);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (!conn->version_received) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        if (connection_verify_version(conn, args) < 0)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi            return -1;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->version_received = TRUE;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        return 1;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    return conn->list->v.input_args(conn, args);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi}
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomistatic void connection_init_streams(struct connection *conn)
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi{
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    const struct connection_settings *set = &conn->list->set;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    i_assert(conn->io == NULL);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    i_assert(conn->input == NULL);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    i_assert(conn->output == NULL);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    i_assert(conn->to == NULL);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
2437015089814f398b717725915009878b3f45aaAki Tuomi    conn->version_received = set->major_version == 0;
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (set->input_max_size != 0) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->input = i_stream_create_fd(conn->fd_in,
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi                         set->input_max_size, FALSE);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        i_stream_set_name(conn->input, conn->name);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->io = io_add_istream(conn->input, *conn->list->v.input, conn);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    } else {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->io = io_add(conn->fd_in, IO_READ, *conn->list->v.input, conn);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    }
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi    if (set->output_max_size != 0) {
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        conn->output = o_stream_create_fd(conn->fd_out,
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi                          set->output_max_size, FALSE);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        o_stream_set_no_error_handling(conn->output, TRUE);
32c2612514a404ebc226f32bb88f28d76ceb1db1Aki Tuomi        o_stream_set_name(conn->output, conn->name);
    }
    if (set->input_idle_timeout_secs != 0) {
        conn->to = timeout_add(set->input_idle_timeout_secs*1000,
                       connection_idle_timeout, conn);
    }
    if (set->major_version != 0 && !set->dont_send_version) {
        o_stream_nsend_str(conn->output, t_strdup_printf(
            "VERSION\t%s\t%u\t%u\n", set->service_name_out,
            set->major_version, set->minor_version));
    }
}

static void connection_client_connected(struct connection *conn, bool success)
{
    i_assert(conn->list->set.client);

    if (success)
        connection_init_streams(conn);
    if (conn->list->v.client_connected != NULL)
        conn->list->v.client_connected(conn, success);
    if (!success) {
        conn->disconnect_reason =
            CONNECTION_DISCONNECT_CONN_CLOSED;
        conn->list->v.destroy(conn);
    }
}

void connection_init_server(struct connection_list *list,
                struct connection *conn, const char *name,
                int fd_in, int fd_out)
{
    i_assert(name != NULL);
    i_assert(!list->set.client);

    conn->list = list;
    conn->name = i_strdup(name);
    conn->fd_in = fd_in;
    conn->fd_out = fd_out;
    connection_init_streams(conn);

    DLLIST_PREPEND(&list->connections, conn);
    list->connections_count++;
}

void connection_init_client_ip(struct connection_list *list,
                   struct connection *conn,
                   const struct ip_addr *ip, unsigned int port)
{
    i_assert(list->set.client);

    conn->fd_in = conn->fd_out = -1;
    conn->list = list;
    conn->name = i_strdup_printf("%s:%u", net_ip2addr(ip), port);

    conn->ip = *ip;
    conn->port = port;

    DLLIST_PREPEND(&list->connections, conn);
    list->connections_count++;
}

void connection_init_client_unix(struct connection_list *list,
                 struct connection *conn, const char *path)
{
    i_assert(list->set.client);

    conn->fd_in = conn->fd_out = -1;
    conn->list = list;
    conn->name = i_strdup(path);

    DLLIST_PREPEND(&list->connections, conn);
    list->connections_count++;
}

void connection_init_from_streams(struct connection_list *list,
                struct connection *conn, const char *name,
                struct istream *input, struct ostream *output)
{
    i_assert(name != NULL);

    conn->list = list;
    conn->name = i_strdup(name);
    conn->fd_in = i_stream_get_fd(input);
    conn->fd_out = o_stream_get_fd(output);

    i_assert(conn->fd_in >= 0);
    i_assert(conn->fd_out >= 0);
    i_assert(conn->io == NULL);
    i_assert(conn->input == NULL);
    i_assert(conn->output == NULL);
    i_assert(conn->to == NULL);

    conn->input = input;
    i_stream_ref(conn->input);
    i_stream_set_name(conn->input, conn->name);

    conn->output = output;
    o_stream_ref(conn->output);
    o_stream_set_no_error_handling(conn->output, TRUE);
    o_stream_set_name(conn->output, conn->name);

    conn->io = io_add_istream(conn->input, *list->v.input, conn);

    DLLIST_PREPEND(&list->connections, conn);
    list->connections_count++;

    if (list->v.client_connected != NULL)
        list->v.client_connected(conn, TRUE);
}

static void connection_socket_connected(struct connection *conn)
{
    io_remove(&conn->io);
    if (conn->to != NULL)
        timeout_remove(&conn->to);

    errno = net_geterror(conn->fd_in);
    connection_client_connected(conn, errno == 0);
}

int connection_client_connect(struct connection *conn)
{
    const struct connection_settings *set = &conn->list->set;
    int fd;

    i_assert(conn->list->set.client);
    i_assert(conn->fd_in == -1);

    if (conn->port != 0)
        fd = net_connect_ip(&conn->ip, conn->port, NULL);
    else
        fd = net_connect_unix(conn->name);
    if (fd == -1)
        return -1;
    conn->fd_in = conn->fd_out = fd;

    if (conn->port != 0 ||
        conn->list->set.delayed_unix_client_connected_callback) {
        conn->io = io_add(conn->fd_out, IO_WRITE,
                  connection_socket_connected, conn);
        if (set->client_connect_timeout_msecs != 0) {
            conn->to = timeout_add(set->client_connect_timeout_msecs,
                           connection_connect_timeout, conn);
        }
    } else {
        connection_client_connected(conn, TRUE);
    }
    return 0;
}

void connection_disconnect(struct connection *conn)
{
    if (conn->to != NULL)
        timeout_remove(&conn->to);
    if (conn->io != NULL)
        io_remove(&conn->io);
    if (conn->input != NULL) {
        i_stream_close(conn->input);
        i_stream_destroy(&conn->input);
    }
    if (conn->output != NULL) {
        o_stream_close(conn->output);
        o_stream_destroy(&conn->output);
    }
    if (conn->fd_in != -1) {
        if (close(conn->fd_in) < 0)
            i_error("close(%s) failed: %m", conn->name);
        if (conn->fd_in != conn->fd_out && close(conn->fd_out) < 0)
            i_error("close(%s/out) failed: %m", conn->name);
        conn->fd_in = conn->fd_out = -1;
    }
}

void connection_deinit(struct connection *conn)
{
    i_assert(conn->list->connections_count > 0);

    conn->list->connections_count--;
    DLLIST_REMOVE(&conn->list->connections, conn);

    connection_disconnect(conn);
    i_free(conn->name);
}

int connection_input_read(struct connection *conn)
{
    conn->last_input = ioloop_time;
    if (conn->to != NULL)
        timeout_reset(conn->to);

    switch (i_stream_read(conn->input)) {
    case -2:
        /* buffer full */
        switch (conn->list->set.input_full_behavior) {
        case CONNECTION_BEHAVIOR_DESTROY:
            conn->disconnect_reason =
                CONNECTION_DISCONNECT_BUFFER_FULL;
            conn->list->v.destroy(conn);
            return -1;
        case CONNECTION_BEHAVIOR_ALLOW:
            return -2;
        }
        i_unreached();
    case -1:
        /* disconnected */
        conn->disconnect_reason =
            CONNECTION_DISCONNECT_CONN_CLOSED;
        conn->list->v.destroy(conn);
        return -1;
    case 0:
        /* nothing new read */
        return 0;
    default:
        /* something was read */
        return 1;
    }
}

const char *connection_disconnect_reason(struct connection *conn)
{
    if (conn->input != NULL && conn->input->stream_errno != 0)
        errno = conn->input->stream_errno;
    else if (conn->output != NULL && conn->output->stream_errno != 0)
        errno = conn->output->stream_errno;
    else
        errno = 0;

    return errno == 0 || errno == EPIPE ? "Connection closed" :
        t_strdup_printf("Connection closed: %m");
}

void connection_switch_ioloop(struct connection *conn)
{
    if (conn->io != NULL)
        conn->io = io_loop_move_io(&conn->io);
    if (conn->to != NULL)
        conn->to = io_loop_move_timeout(&conn->to);
    if (conn->input != NULL)
        i_stream_switch_ioloop(conn->input);
    if (conn->output != NULL)
        o_stream_switch_ioloop(conn->output);
}

struct connection_list *
connection_list_init(const struct connection_settings *set,
             const struct connection_vfuncs *vfuncs)
{
    struct connection_list *list;

    i_assert(vfuncs->input != NULL ||
         set->input_full_behavior != CONNECTION_BEHAVIOR_ALLOW);
    i_assert(set->major_version == 0 ||
         (set->service_name_in != NULL &&
          set->service_name_out != NULL));

    list = i_new(struct connection_list, 1);
    list->set = *set;
    list->v = *vfuncs;

    if (list->v.input == NULL)
        list->v.input = connection_input_default;
    if (list->v.input_line == NULL)
        list->v.input_line = connection_input_line_default;

    return list;
}

void connection_list_deinit(struct connection_list **_list)
{
    struct connection_list *list = *_list;
    struct connection *conn;

    *_list = NULL;

    while (list->connections != NULL) {
        conn = list->connections;
        conn->disconnect_reason = CONNECTION_DISCONNECT_DEINIT;
        list->v.destroy(conn);
        i_assert(conn != list->connections);
    }
    i_free(list);
}