src/lib-sql/driver-pgsql.c

	driver-pgsql.c revision c44f402f17f9a58ead24ac0083945cae86fb172b
/* Copyright (c) 2004-2010 Dovecot authors, see the included COPYING file */

#include "lib.h"
#include "array.h"
#include "ioloop.h"
#include "ioloop-internal.h" /* kind of dirty, but it should be fine.. */
#include "sql-api-private.h"

#ifdef BUILD_PGSQL
#include <stdlib.h>
#include <time.h>
#include <libpq-fe.h>

#define QUERY_TIMEOUT_SECS 6

struct pgsql_db {
    struct sql_db api;

    pool_t pool;
    char *connect_string;
    PGconn *pg;

    struct io *io;
    enum io_condition io_dir;

    struct pgsql_queue *queue, **queue_tail;
    struct timeout *queue_to;

    struct ioloop *ioloop;
    struct sql_result *sync_result;

    char *error;
    time_t last_connect;
    unsigned int connecting:1;
    unsigned int connected:1;
    unsigned int querying:1;
    unsigned int query_finished:1;
};

struct pgsql_binary_value {
    unsigned char *value;
    size_t size;
};

struct pgsql_result {
    struct sql_result api;
    PGresult *pgres;

    char *query;
    unsigned int rownum, rows;
    unsigned int fields_count;
    const char **fields;
    const char **values;

    ARRAY_DEFINE(binary_values, struct pgsql_binary_value);

    sql_query_callback_t *callback;
    void *context;

    unsigned int retry_query:1;
};

struct pgsql_queue {
    struct pgsql_queue *next;

    time_t created;
    char *query;
    struct pgsql_result *result;
};

struct pgsql_transaction_context {
    struct sql_transaction_context ctx;
    int refcount;

    sql_commit_callback_t *callback;
    void *context;

    pool_t query_pool;
    struct pgsql_query_list *head, *tail;
    const char *error;

    unsigned int begin_succeeded:1;
    unsigned int begin_failed:1;
    unsigned int failed:1;
};

struct pgsql_query_list {
    struct pgsql_query_list *next;
    struct pgsql_transaction_context *ctx;

    const char *query;
    unsigned int *affected_rows;
};
extern struct sql_db driver_pgsql_db;
extern struct sql_result driver_pgsql_result;

static void
driver_pgsql_query_full(struct sql_db *db, const char *query,
            sql_query_callback_t *callback, void *context,
            bool retry_query);
static void queue_send_next(struct pgsql_db *db);
static void result_finish(struct pgsql_result *result);

static void driver_pgsql_close(struct pgsql_db *db)
{
    db->io_dir = 0;

    PQfinish(db->pg);
    db->pg = NULL;

    if (db->io != NULL) {
        /* The fd may be closed before call to PQfinish() already,
           so use io_remove_closed(). */
        io_remove_closed(&db->io);
    }

    db->connecting = FALSE;
    db->connected = FALSE;
        db->querying = FALSE;
}

static const char *last_error(struct pgsql_db *db)
{
    const char *msg;
    size_t len;

    msg = PQerrorMessage(db->pg);
    if (msg == NULL)
        return "(no error set)";

    /* Error message should contain trailing \n, we don't want it */
    len = strlen(msg);
    return len == 0 || msg[len-1] != '\n' ? msg :
        t_strndup(msg, len-1);
}

static void connect_callback(struct pgsql_db *db)
{
    enum io_condition io_dir = 0;
    int ret;

    while ((ret = PQconnectPoll(db->pg)) == PGRES_POLLING_ACTIVE)
        ;

    switch (ret) {
    case PGRES_POLLING_READING:
        io_dir = IO_READ;
        break;
    case PGRES_POLLING_WRITING:
        io_dir = IO_WRITE;
        break;
    case PGRES_POLLING_OK:
        i_info("pgsql: Connected to %s", PQdb(db->pg));
        db->connecting = FALSE;
        db->connected = TRUE;
        break;
    case PGRES_POLLING_FAILED:
        i_error("pgsql: Connect failed to %s: %s",
            PQdb(db->pg), last_error(db));
        driver_pgsql_close(db);
        return;
    }

    if (db->io_dir != io_dir) {
        if (db->io != NULL)
            io_remove(&db->io);
        db->io = io_dir == 0 ? NULL :
            io_add(PQsocket(db->pg), io_dir, connect_callback, db);
        db->io_dir = io_dir;
    }

    if (db->connected && db->queue != NULL)
        queue_send_next(db);
}

static int driver_pgsql_connect(struct sql_db *_db)
{
    struct pgsql_db *db = (struct pgsql_db *)_db;
    time_t now;

    /* don't try reconnecting more than once a second */
    now = time(NULL);
    if (db->connecting || db->last_connect == now)
        return db->connected ? 1 : (db->connecting ? 0 : -1);
    db->last_connect = now;

    db->pg = PQconnectStart(db->connect_string);
    if (db->pg == NULL)
        i_fatal("pgsql: PQconnectStart() failed (out of memory)");

    if (PQstatus(db->pg) == CONNECTION_BAD) {
        i_error("pgsql: Connect failed to %s: %s",
            PQdb(db->pg), last_error(db));
        driver_pgsql_close(db);
        return -1;
    } else {
        /* nonblocking connecting begins. */
        if (PQsetnonblocking(db->pg, 1) < 0)
            i_error("pgsql: PQsetnonblocking() failed");
        db->io = io_add(PQsocket(db->pg), IO_WRITE,
                connect_callback, db);
        db->io_dir = IO_WRITE;
        db->connecting = TRUE;
        return 0;
    }
}

static struct sql_db *driver_pgsql_init_v(const char *connect_string)
{
    struct pgsql_db *db;

    i_assert(connect_string != NULL);

    db = i_new(struct pgsql_db, 1);
    db->connect_string = i_strdup(connect_string);
    db->api = driver_pgsql_db;
    db->queue_tail = &db->queue;
    return &db->api;
}

static void driver_pgsql_deinit_v(struct sql_db *_db)
{
    struct pgsql_db *db = (struct pgsql_db *)_db;

    while (db->queue != NULL) {
        struct pgsql_queue *next = db->queue->next;

                result_finish(db->queue->result);
        i_free(db->queue->query);
        i_free(db->queue);

        db->queue = next;
    }

    if (db->queue_to != NULL)
        timeout_remove(&db->queue_to);
        driver_pgsql_close(db);
    i_free(db->error);
    i_free(db->connect_string);
    array_free(&_db->module_contexts);
    i_free(db);
}

static enum sql_db_flags
driver_pgsql_get_flags(struct sql_db *db ATTR_UNUSED)
{
    return 0;
}

static void consume_results(struct pgsql_db *db)
{
    PGresult *pgres;

    while (PQconsumeInput(db->pg)) {
        if (PQisBusy(db->pg))
            return;

        pgres = PQgetResult(db->pg);
        if (pgres == NULL)
            break;
        PQclear(pgres);
    }

    if (PQstatus(db->pg) == CONNECTION_BAD)
        io_remove_closed(&db->io);
    else
        io_remove(&db->io);

    db->querying = FALSE;
    if (db->queue != NULL && db->connected)
        queue_send_next(db);
}

static void driver_pgsql_result_free(struct sql_result *_result)
{
    struct pgsql_db *db = (struct pgsql_db *)_result->db;
        struct pgsql_result *result = (struct pgsql_result *)_result;

    if (result->api.callback)
        return;

    if (_result == db->sync_result)
        db->sync_result = NULL;

    if (result->pgres != NULL) {
        PQclear(result->pgres);
        result->pgres = NULL;

        /* we'll have to read the rest of the results as well */
        i_assert(db->io == NULL);
        db->io = io_add(PQsocket(db->pg), IO_READ,
                consume_results, db);
        db->io_dir = IO_READ;
        consume_results(db);
    } else {
        db->querying = FALSE;
    }

    if (array_is_created(&result->binary_values)) {
        struct pgsql_binary_value *value;

        array_foreach_modifiable(&result->binary_values, value)
            PQfreemem(value->value);
        array_free(&result->binary_values);
    }

    i_free(result->fields);
    i_free(result->values);
    i_free(result->query);
    i_free(result);

    if (db->queue != NULL && !db->querying && db->connected)
        queue_send_next(db);
}

static void result_finish(struct pgsql_result *result)
{
    struct pgsql_db *db = (struct pgsql_db *)result->api.db;
    bool free_result = TRUE, retry = FALSE;
    bool disconnected;

    /* if connection to server was lost, we don't yet see that the
       connection is bad. we only see the fatal error, so assume it also
       means disconnection. */
    disconnected = PQstatus(db->pg) == CONNECTION_BAD ||
        PQresultStatus(result->pgres) == PGRES_FATAL_ERROR;
    if (disconnected && result->retry_query) {
        /* retry the query */
        i_error("pgsql: Query failed, retrying: %s", last_error(db));
        retry = TRUE;
    } else if (result->callback != NULL) {
        result->api.callback = TRUE;
        T_BEGIN {
            result->callback(&result->api, result->context);
        } T_END;
        result->api.callback = FALSE;
        free_result = db->sync_result != &result->api;
        if (db->queue == NULL && db->ioloop != NULL)
            io_loop_stop(db->ioloop);
    }

    if (disconnected) {
        /* disconnected */
        if (result->pgres != NULL) {
            PQclear(result->pgres);
            result->pgres = NULL;
        }
        driver_pgsql_close(db);

        if (retry) {
            /* retry the query */
            driver_pgsql_query_full(&db->api, result->query,
                        result->callback,
                        result->context, FALSE);
        }
    }
    if (free_result)
        sql_result_unref(&result->api);
}

static void get_result(struct pgsql_result *result)
{
        struct pgsql_db *db = (struct pgsql_db *)result->api.db;

    if (!PQconsumeInput(db->pg)) {
        db->connected = FALSE;
        result_finish(result);
        return;
    }

    if (PQisBusy(db->pg)) {
        if (db->io == NULL) {
            db->io = io_add(PQsocket(db->pg), IO_READ,
                    get_result, result);
            db->io_dir = IO_READ;
        }
        return;
    }

    if (db->io != NULL)
        io_remove(&db->io);

    result->pgres = PQgetResult(db->pg);
    result_finish(result);
}

static void flush_callback(struct pgsql_result *result)
{
        struct pgsql_db *db = (struct pgsql_db *)result->api.db;
    int ret;

    ret = PQflush(db->pg);
    if (ret > 0)
        return;

    io_remove(&db->io);

    if (ret < 0) {
        db->connected = FALSE;
        result_finish(result);
    } else {
        /* all flushed */
        get_result(result);
    }
}

static void send_query(struct pgsql_result *result, const char *query)
{
        struct pgsql_db *db = (struct pgsql_db *)result->api.db;
    int ret;

    i_assert(db->io == NULL);
    i_assert(!db->querying);
    i_assert(db->connected);

    if (!PQsendQuery(db->pg, query)) {
        db->connected = FALSE;
        result_finish(result);
        return;
    }

    ret = PQflush(db->pg);
    if (ret < 0) {
        db->connected = FALSE;
        result_finish(result);
        return;
    }

    db->querying = TRUE;
    if (ret > 0) {
        /* write blocks */
        db->io = io_add(PQsocket(db->pg), IO_WRITE,
                flush_callback, result);
        db->io_dir = IO_WRITE;
    } else {
        get_result(result);
    }
}

static struct pgsql_queue *queue_unlink_first(struct pgsql_db *db)
{
    struct pgsql_queue *queue;

    queue = db->queue;
    db->queue = queue->next;

    if (db->queue == NULL)
        db->queue_tail = &db->queue;
    return queue;
}

static void queue_send_next(struct pgsql_db *db)
{
    struct pgsql_queue *queue;

    queue = queue_unlink_first(db);
    send_query(queue->result, queue->query);

    i_free(queue->query);
    i_free(queue);
}

static void queue_abort_next(struct pgsql_db *db)
{
    struct pgsql_queue *queue;

    queue = queue_unlink_first(db);

    queue->result->callback(&sql_not_connected_result,
                queue->result->context);
    i_free(queue->result);
    i_free(queue->query);
    i_free(queue);

    if (db->queue == NULL && db->ioloop != NULL)
        io_loop_stop(db->ioloop);
}

static void queue_drop_timed_out_queries(struct pgsql_db *db)
{
    while (db->queue != NULL &&
           db->queue->created + QUERY_TIMEOUT_SECS < ioloop_time)
        queue_abort_next(db);

}

static void queue_timeout(struct pgsql_db *db)
{
    if (db->querying)
        return;

    if (!db->connected) {
        queue_drop_timed_out_queries(db);
        driver_pgsql_connect(&db->api);
        return;
    }

    if (db->queue != NULL)
        queue_send_next(db);

    if (db->queue == NULL)
        timeout_remove(&db->queue_to);
}

static void
driver_pgsql_queue_query(struct pgsql_result *result, const char *query)
{
        struct pgsql_db *db = (struct pgsql_db *)result->api.db;
    struct pgsql_queue *queue;

    queue = i_new(struct pgsql_queue, 1);
    queue->created = time(NULL);
    queue->query = i_strdup(query);
    queue->result = result;

    *db->queue_tail = queue;
    db->queue_tail = &queue->next;

    if (db->queue_to == NULL)
        db->queue_to = timeout_add(5000, queue_timeout, db);
}

static void do_query(struct pgsql_result *result, const char *query)
{
        struct pgsql_db *db = (struct pgsql_db *)result->api.db;

    i_assert(db->sync_result == NULL);

    if (db->querying) {
        /* only one query at a time */
        driver_pgsql_queue_query(result, query);
        return;
    }

    if (!db->connected) {
        /* try connecting again */
        driver_pgsql_connect(&db->api);
        driver_pgsql_queue_query(result, query);
        return;
    }

    if (db->queue == NULL)
        send_query(result, query);
    else {
        /* there's already queries queued, send them first */
        driver_pgsql_queue_query(result, query);
        queue_send_next(db);
    }
}

static void exec_callback(struct sql_result *_result,
              void *context ATTR_UNUSED)
{
    struct pgsql_db *db = (struct pgsql_db *)_result->db;

    i_error("pgsql: sql_exec() failed: %s", last_error(db));
}

static const char *
driver_pgsql_escape_string(struct sql_db *_db, const char *string)
{
    struct pgsql_db *db = (struct pgsql_db *)_db;
    size_t len = strlen(string);
    char *to;

#ifdef HAVE_PQESCAPE_STRING_CONN
    if (!db->connected) {
        /* try connecting again */
        (void)driver_pgsql_connect(&db->api);
    }
    to = t_buffer_get(len * 2 + 1);
    len = PQescapeStringConn(db->pg, to, string, len, NULL);
#else
    to = t_buffer_get(len * 2 + 1);
    len = PQescapeString(to, string, len);
#endif
    t_buffer_alloc(len + 1);
    return to;
}

static void driver_pgsql_exec_full(struct sql_db *db, const char *query,
                   bool retry_query)
{
    struct pgsql_result *result;

    result = i_new(struct pgsql_result, 1);
    result->api = driver_pgsql_result;
    result->api.db = db;
    result->api.refcount = 1;
    result->callback = exec_callback;
    if (retry_query) {
        result->query = i_strdup(query);
        result->retry_query = TRUE;
    }
    do_query(result, query);
}

static void driver_pgsql_exec(struct sql_db *db, const char *query)
{
    driver_pgsql_exec_full(db, query, TRUE);
}

static void
driver_pgsql_query_full(struct sql_db *db, const char *query,
            sql_query_callback_t *callback, void *context,
            bool retry_query)
{
    struct pgsql_result *result;

    result = i_new(struct pgsql_result, 1);
    result->api = driver_pgsql_result;
    result->api.db = db;
    result->api.refcount = 1;
    result->callback = callback;
    result->context = context;
    if (retry_query) {
        result->query = i_strdup(query);
        result->retry_query = TRUE;
    }
    do_query(result, query);
}

static void driver_pgsql_query(struct sql_db *db, const char *query,
                   sql_query_callback_t *callback, void *context)
{
    driver_pgsql_query_full(db, query, callback, context, TRUE);
}

static void pgsql_query_s_callback(struct sql_result *result, void *context)
{
        struct pgsql_db *db = context;

    db->query_finished = TRUE;
    db->sync_result = result;
}

static struct sql_result *
driver_pgsql_query_s(struct sql_db *_db, const char *query)
{
        struct pgsql_db *db = (struct pgsql_db *)_db;
    struct sql_result *result;
    struct io old_io;

    if (db->queue_to != NULL) {
        /* we're creating a new ioloop, make sure the timeout gets
           added there. */
        timeout_remove(&db->queue_to);
    }

    if (db->io == NULL)
        db->ioloop = io_loop_create();
    else {
        /* have to move our existing I/O handler to new I/O loop */
        old_io = *db->io;
        io_remove(&db->io);

        db->ioloop = io_loop_create();

        db->io = io_add(PQsocket(db->pg), old_io.condition,
                old_io.callback, old_io.context);
    }

    db->query_finished = FALSE;
    if (query != NULL)
        driver_pgsql_query(_db, query, pgsql_query_s_callback, db);

    if (!db->query_finished) {
        if ((db->connected || db->connecting) && db->io != NULL)
            io_loop_run(db->ioloop);
        else
            queue_abort_next(db);

        if (db->io != NULL) {
            i_assert(db->sync_result == &sql_not_connected_result);
            io_remove(&db->io);
        }
        if (db->queue_to != NULL)
            timeout_remove(&db->queue_to);
    } else {
        i_assert(db->io == NULL);
        i_assert(db->queue_to == NULL);
    }
    io_loop_destroy(&db->ioloop);

    result = db->sync_result;
    if (result == &sql_not_connected_result) {
        /* we don't end up in pgsql's free function, so sync_result
           won't be set to NULL if we don't do it here. */
        db->sync_result = NULL;
    }

    i_assert(db->io == NULL);
    return result;
}

static int driver_pgsql_result_next_row(struct sql_result *_result)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;
    struct pgsql_db *db = (struct pgsql_db *)_result->db;

    if (result->rows != 0) {
        /* second time we're here */
        if (++result->rownum < result->rows)
            return 1;

        /* end of this packet. see if there's more. FIXME: this may
           block, but the current API doesn't provide a non-blocking
           way to do this.. */
        PQclear(result->pgres);
        result->pgres = PQgetResult(db->pg);
        if (result->pgres == NULL)
            return 0;
    }

    if (result->pgres == NULL)
        return -1;

    switch (PQresultStatus(result->pgres)) {
    case PGRES_COMMAND_OK:
        /* no rows returned */
        return 0;
    case PGRES_TUPLES_OK:
        result->rows = PQntuples(result->pgres);
        return result->rows > 0;
    case PGRES_EMPTY_QUERY:
    case PGRES_NONFATAL_ERROR:
        /* nonfatal error */
        return -1;
    default:
        /* treat as fatal error */
        db->connected = FALSE;
        return -1;
    }
}

static void driver_pgsql_result_fetch_fields(struct pgsql_result *result)
{
    unsigned int i;

    if (result->fields != NULL)
        return;

    /* @UNSAFE */
    result->fields_count = PQnfields(result->pgres);
    result->fields = i_new(const char *, result->fields_count);
    for (i = 0; i < result->fields_count; i++)
        result->fields[i] = PQfname(result->pgres, i);
}

static unsigned int
driver_pgsql_result_get_fields_count(struct sql_result *_result)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;

        driver_pgsql_result_fetch_fields(result);
    return result->fields_count;
}

static const char *
driver_pgsql_result_get_field_name(struct sql_result *_result, unsigned int idx)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;

    driver_pgsql_result_fetch_fields(result);
    i_assert(idx < result->fields_count);
    return result->fields[idx];
}

static int driver_pgsql_result_find_field(struct sql_result *_result,
                      const char *field_name)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;
    unsigned int i;

    driver_pgsql_result_fetch_fields(result);
    for (i = 0; i < result->fields_count; i++) {
        if (strcmp(result->fields[i], field_name) == 0)
            return i;
    }
    return -1;
}

static const char *
driver_pgsql_result_get_field_value(struct sql_result *_result,
                    unsigned int idx)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;

    if (PQgetisnull(result->pgres, result->rownum, idx))
        return NULL;

    return PQgetvalue(result->pgres, result->rownum, idx);
}

static const unsigned char *
driver_pgsql_result_get_field_value_binary(struct sql_result *_result,
                       unsigned int idx, size_t *size_r)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;
    const char *value;
    struct pgsql_binary_value *binary_value;

    if (PQgetisnull(result->pgres, result->rownum, idx)) {
        *size_r = 0;
        return NULL;
    }

    value = PQgetvalue(result->pgres, result->rownum, idx);

    if (!array_is_created(&result->binary_values))
        i_array_init(&result->binary_values, idx + 1);

    binary_value = array_idx_modifiable(&result->binary_values, idx);
    if (binary_value->value == NULL) {
        binary_value->value =
            PQunescapeBytea((const unsigned char *)value,
                    &binary_value->size);
    }

    *size_r = binary_value->size;
    return binary_value->value;
}

static const char *
driver_pgsql_result_find_field_value(struct sql_result *result,
                     const char *field_name)
{
    int idx;

    idx = driver_pgsql_result_find_field(result, field_name);
    if (idx < 0)
        return NULL;
    return driver_pgsql_result_get_field_value(result, idx);
}

static const char *const *
driver_pgsql_result_get_values(struct sql_result *_result)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;
    unsigned int i;

    if (result->values == NULL) {
        driver_pgsql_result_fetch_fields(result);
        result->values = i_new(const char *, result->fields_count);
    }

    /* @UNSAFE */
    for (i = 0; i < result->fields_count; i++) {
        result->values[i] =
                        driver_pgsql_result_get_field_value(_result, i);
    }

    return result->values;
}

static const char *driver_pgsql_result_get_error(struct sql_result *_result)
{
    struct pgsql_result *result = (struct pgsql_result *)_result;
    struct pgsql_db *db = (struct pgsql_db *)_result->db;
    const char *msg;
    size_t len;

    i_free_and_null(db->error);

    if (result->pgres == NULL) {
        /* connection error */
        db->error = i_strdup(last_error(db));
    } else {
        msg = PQresultErrorMessage(result->pgres);
        if (msg == NULL)
            return "(no error set)";

        /* Error message should contain trailing \n, we don't want it */
        len = strlen(msg);
        db->error = len == 0 || msg[len-1] != '\n' ?
            i_strdup(msg) : i_strndup(msg, len-1);
    }
    return db->error;
}

static struct sql_transaction_context *
driver_pgsql_transaction_begin(struct sql_db *db)
{
    struct pgsql_transaction_context *ctx;

    ctx = i_new(struct pgsql_transaction_context, 1);
    ctx->ctx.db = db;
    ctx->refcount = 1;
    /* we need to be able to handle multiple open transactions, so at least
       for now just keep them in memory until commit time. */
    ctx->query_pool = pool_alloconly_create("pgsql transaction", 1024);
    return &ctx->ctx;
}

static void
driver_pgsql_transaction_unref(struct pgsql_transaction_context *ctx)
{
    i_assert(ctx->refcount > 0);
    if (--ctx->refcount > 0)
        return;

    pool_unref(&ctx->query_pool);
    i_free(ctx);
}

static void
transaction_begin_callback(struct sql_result *result,
                struct pgsql_transaction_context *ctx)
{
    if (sql_result_next_row(result) < 0) {
        ctx->begin_failed = TRUE;
        ctx->failed = TRUE;
        ctx->error = sql_result_get_error(result);
    } else {
        ctx->begin_succeeded = TRUE;
    }
    driver_pgsql_transaction_unref(ctx);
}

static void
transaction_commit_callback(struct sql_result *result,
                struct pgsql_transaction_context *ctx)
{
    if (sql_result_next_row(result) < 0)
        ctx->callback(sql_result_get_error(result), ctx->context);
    else
        ctx->callback(NULL, ctx->context);
    driver_pgsql_transaction_unref(ctx);
}

static void
transaction_update_callback(struct sql_result *result,
                struct pgsql_query_list *list)
{
    struct pgsql_transaction_context *ctx = list->ctx;

    if (sql_result_next_row(result) < 0) {
        ctx->failed = TRUE;
        ctx->error = sql_result_get_error(result);
    } else if (list->affected_rows != NULL) {
        struct pgsql_result *pg_result = (struct pgsql_result *)result;

        *list->affected_rows = atoi(PQcmdTuples(pg_result->pgres));
    }
    driver_pgsql_transaction_unref(ctx);
}

static void
driver_pgsql_transaction_commit(struct sql_transaction_context *_ctx,
                sql_commit_callback_t *callback, void *context)
{
    struct pgsql_transaction_context *ctx =
        (struct pgsql_transaction_context *)_ctx;

    ctx->callback = callback;
    ctx->context = context;

    if (ctx->failed || ctx->head == NULL) {
        callback(ctx->failed ? ctx->error : NULL, context);
        driver_pgsql_transaction_unref(ctx);
    } else if (ctx->head->next == NULL) {
        /* just a single query, send it */
        sql_query(_ctx->db, ctx->head->query,
              transaction_commit_callback, ctx);
    } else {
        /* multiple queries, use a transaction */
        ctx->refcount++;
        sql_query(_ctx->db, "BEGIN", transaction_begin_callback, ctx);
        while (ctx->head != NULL) {
            ctx->refcount++;
            sql_query(_ctx->db, ctx->head->query,
                  transaction_update_callback, ctx->head);
            ctx->head = ctx->head->next;
        }
        sql_query(_ctx->db, "COMMIT", transaction_commit_callback, ctx);
    }
}

static int
driver_pgsql_transaction_commit_s(struct sql_transaction_context *_ctx,
                  const char **error_r)
{
    struct pgsql_transaction_context *ctx =
        (struct pgsql_transaction_context *)_ctx;
    struct sql_result *result;

    *error_r = NULL;

    if (ctx->failed || ctx->head == NULL) {
        /* nothing to be done */
        result = NULL;
    } else if (ctx->head->next == NULL) {
        /* just a single query, send it */
        result = sql_query_s(_ctx->db, ctx->head->query);
    } else {
        /* multiple queries, use a transaction */
        ctx->refcount++;
        sql_query(_ctx->db, "BEGIN", transaction_begin_callback, ctx);
        while (ctx->head != NULL) {
            ctx->refcount++;
            sql_query(_ctx->db, ctx->head->query,
                  transaction_update_callback, ctx->head);
            ctx->head = ctx->head->next;
        }
        if (ctx->refcount > 1) {
            /* flush the previous queries */
            (void)driver_pgsql_query_s(_ctx->db, NULL);
        }

        if (ctx->begin_failed) {
            result = NULL;
        } else if (ctx->failed) {
            result = sql_query_s(_ctx->db, "ROLLBACK");
        } else {
            result = sql_query_s(_ctx->db, "COMMIT");
        }
    }

    if (ctx->failed)
        *error_r = ctx->error;
    else if (result != NULL) {
        if (sql_result_next_row(result) < 0)
            *error_r = sql_result_get_error(result);
        else if (ctx->head != NULL &&
             ctx->head->affected_rows != NULL) {
            struct pgsql_result *pg_result =
                (struct pgsql_result *)result;

            *ctx->head->affected_rows =
                atoi(PQcmdTuples(pg_result->pgres));
        }
    }
    if (result != NULL)
        sql_result_unref(result);

    i_assert(ctx->refcount == 1);
    driver_pgsql_transaction_unref(ctx);
    return *error_r == NULL ? 0 : -1;
}

static void
driver_pgsql_transaction_rollback(struct sql_transaction_context *_ctx)
{
    struct pgsql_transaction_context *ctx =
        (struct pgsql_transaction_context *)_ctx;

    i_assert(ctx->refcount == 1);
    driver_pgsql_transaction_unref(ctx);
}

static void
driver_pgsql_update(struct sql_transaction_context *_ctx, const char *query,
            unsigned int *affected_rows)
{
    struct pgsql_transaction_context *ctx =
        (struct pgsql_transaction_context *)_ctx;
    struct pgsql_query_list *list;

    list = p_new(ctx->query_pool, struct pgsql_query_list, 1);
    list->ctx = ctx;
    list->query = p_strdup(ctx->query_pool, query);
    list->affected_rows = affected_rows;

    if (ctx->head == NULL)
        ctx->head = list;
    else
        ctx->tail->next = list;
    ctx->tail = list;
}

struct sql_db driver_pgsql_db = {
    "pgsql",

    .v = {
        driver_pgsql_init_v,
        driver_pgsql_deinit_v,
        driver_pgsql_get_flags,
        driver_pgsql_connect,
        driver_pgsql_escape_string,
        driver_pgsql_exec,
        driver_pgsql_query,
        driver_pgsql_query_s,

        driver_pgsql_transaction_begin,
        driver_pgsql_transaction_commit,
        driver_pgsql_transaction_commit_s,
        driver_pgsql_transaction_rollback,

        driver_pgsql_update
    }
};

struct sql_result driver_pgsql_result = {
    .v = {
        driver_pgsql_result_free,
        driver_pgsql_result_next_row,
        driver_pgsql_result_get_fields_count,
        driver_pgsql_result_get_field_name,
        driver_pgsql_result_find_field,
        driver_pgsql_result_get_field_value,
        driver_pgsql_result_get_field_value_binary,
        driver_pgsql_result_find_field_value,
        driver_pgsql_result_get_values,
        driver_pgsql_result_get_error
    }
};

void driver_pgsql_init(void);
void driver_pgsql_deinit(void);

void driver_pgsql_init(void)
{
    sql_driver_register(&driver_pgsql_db);
}

void driver_pgsql_deinit(void)
{
    sql_driver_unregister(&driver_pgsql_db);
}

#endif