backupkey: replace heimdal rsa key generation with GnuTLS

[Samba.git] / ctdb / client / ctdb_client.c

/* 
   ctdb daemon code

   Copyright (C) Andrew Tridgell  2007
   Copyright (C) Ronnie Sahlberg  2007

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.
   
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
   
   You should have received a copy of the GNU General Public License
   along with this program; if not, see <http://www.gnu.org/licenses/>.
*/

#include "includes.h"
#include "lib/tdb_wrap/tdb_wrap.h"
#include "tdb.h"
#include "lib/util/dlinklist.h"
#include "system/network.h"
#include "system/filesys.h"
#include "system/locale.h"
#include <stdlib.h>
#include "../include/ctdb_private.h"
#include "lib/util/dlinklist.h"

/*
  allocate a packet for use in client<->daemon communication
 */
struct ctdb_req_header *_ctdbd_allocate_pkt(struct ctdb_context *ctdb,
                                            TALLOC_CTX *mem_ctx, 
                                            enum ctdb_operation operation, 
                                            size_t length, size_t slength,
                                            const char *type)
{
        int size;
        struct ctdb_req_header *hdr;

        length = MAX(length, slength);
        size = (length+(CTDB_DS_ALIGNMENT-1)) & ~(CTDB_DS_ALIGNMENT-1);

        hdr = (struct ctdb_req_header *)talloc_zero_size(mem_ctx, size);
        if (hdr == NULL) {
                DEBUG(DEBUG_ERR,("Unable to allocate packet for operation %u of length %u\n",
                         operation, (unsigned)length));
                return NULL;
        }
        talloc_set_name_const(hdr, type);
        hdr->length       = length;
        hdr->operation    = operation;
        hdr->ctdb_magic   = CTDB_MAGIC;
        hdr->ctdb_version = CTDB_PROTOCOL;
        hdr->srcnode      = ctdb->pnn;
        if (ctdb->vnn_map) {
                hdr->generation = ctdb->vnn_map->generation;
        }

        return hdr;
}

/*
  local version of ctdb_call
*/
int ctdb_call_local(struct ctdb_db_context *ctdb_db, struct ctdb_call *call,
                    struct ctdb_ltdb_header *header, TALLOC_CTX *mem_ctx,
                    TDB_DATA *data, bool updatetdb)
{
        struct ctdb_call_info *c;
        struct ctdb_registered_call *fn;
        struct ctdb_context *ctdb = ctdb_db->ctdb;
        
        c = talloc(ctdb, struct ctdb_call_info);
        CTDB_NO_MEMORY(ctdb, c);

        c->key = call->key;
        c->call_data = &call->call_data;
        c->record_data.dptr = talloc_memdup(c, data->dptr, data->dsize);
        c->record_data.dsize = data->dsize;
        CTDB_NO_MEMORY(ctdb, c->record_data.dptr);
        c->new_data = NULL;
        c->reply_data = NULL;
        c->status = 0;
        c->header = header;

        for (fn=ctdb_db->calls;fn;fn=fn->next) {
                if (fn->id == call->call_id) break;
        }
        if (fn == NULL) {
                ctdb_set_error(ctdb, "Unknown call id %u\n", call->call_id);
                talloc_free(c);
                return -1;
        }

        if (fn->fn(c) != 0) {
                ctdb_set_error(ctdb, "ctdb_call %u failed\n", call->call_id);
                talloc_free(c);
                return -1;
        }

        /* we need to force the record to be written out if this was a remote access */
        if (c->new_data == NULL) {
                c->new_data = &c->record_data;
        }

        if (c->new_data && updatetdb) {
                /* XXX check that we always have the lock here? */
                if (ctdb_ltdb_store(ctdb_db, call->key, header, *c->new_data) != 0) {
                        ctdb_set_error(ctdb, "ctdb_call tdb_store failed\n");
                        talloc_free(c);
                        return -1;
                }
        }

        if (c->reply_data) {
                call->reply_data = *c->reply_data;

                talloc_steal(call, call->reply_data.dptr);
                talloc_set_name_const(call->reply_data.dptr, __location__);
        } else {
                call->reply_data.dptr = NULL;
                call->reply_data.dsize = 0;
        }
        call->status = c->status;

        talloc_free(c);

        return 0;
}


/*
  queue a packet for sending from client to daemon
*/
static int ctdb_client_queue_pkt(struct ctdb_context *ctdb, struct ctdb_req_header *hdr)
{
        return ctdb_queue_send(ctdb->daemon.queue, (uint8_t *)hdr, hdr->length);
}


/*
  called when a CTDB_REPLY_CALL packet comes in in the client

  This packet comes in response to a CTDB_REQ_CALL request packet. It
  contains any reply data from the call
*/
static void ctdb_client_reply_call(struct ctdb_context *ctdb, struct ctdb_req_header *hdr)
{
        struct ctdb_reply_call *c = (struct ctdb_reply_call *)hdr;
        struct ctdb_client_call_state *state;

        state = ctdb_reqid_find(ctdb, hdr->reqid, struct ctdb_client_call_state);
        if (state == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " reqid %u not found\n", hdr->reqid));
                return;
        }

        if (hdr->reqid != state->reqid) {
                /* we found a record  but it was the wrong one */
                DEBUG(DEBUG_ERR, ("Dropped client call reply with reqid:%u\n",hdr->reqid));
                return;
        }

        state->call->reply_data.dptr = c->data;
        state->call->reply_data.dsize = c->datalen;
        state->call->status = c->status;

        talloc_steal(state, c);

        state->state = CTDB_CALL_DONE;

        if (state->async.fn) {
                state->async.fn(state);
        }
}

static void ctdb_client_reply_control(struct ctdb_context *ctdb, struct ctdb_req_header *hdr);

/*
  this is called in the client, when data comes in from the daemon
 */
void ctdb_client_read_cb(uint8_t *data, size_t cnt, void *args)
{
        struct ctdb_context *ctdb = talloc_get_type(args, struct ctdb_context);
        struct ctdb_req_header *hdr = (struct ctdb_req_header *)data;
        TALLOC_CTX *tmp_ctx;

        /* place the packet as a child of a tmp_ctx. We then use
           talloc_free() below to free it. If any of the calls want
           to keep it, then they will steal it somewhere else, and the
           talloc_free() will be a no-op */
        tmp_ctx = talloc_new(ctdb);
        talloc_steal(tmp_ctx, hdr);

        if (cnt == 0) {
                DEBUG(DEBUG_CRIT,("Daemon has exited - shutting down client\n"));
                exit(1);
        }

        if (cnt < sizeof(*hdr)) {
                DEBUG(DEBUG_CRIT,("Bad packet length %u in client\n", (unsigned)cnt));
                goto done;
        }
        if (cnt != hdr->length) {
                ctdb_set_error(ctdb, "Bad header length %u expected %u in client\n", 
                               (unsigned)hdr->length, (unsigned)cnt);
                goto done;
        }

        if (hdr->ctdb_magic != CTDB_MAGIC) {
                ctdb_set_error(ctdb, "Non CTDB packet rejected in client\n");
                goto done;
        }

        if (hdr->ctdb_version != CTDB_PROTOCOL) {
                ctdb_set_error(ctdb, "Bad CTDB version 0x%x rejected in client\n", hdr->ctdb_version);
                goto done;
        }

        switch (hdr->operation) {
        case CTDB_REPLY_CALL:
                ctdb_client_reply_call(ctdb, hdr);
                break;

        case CTDB_REQ_MESSAGE:
                ctdb_request_message(ctdb, hdr);
                break;

        case CTDB_REPLY_CONTROL:
                ctdb_client_reply_control(ctdb, hdr);
                break;

        default:
                DEBUG(DEBUG_CRIT,("bogus operation code:%u\n",hdr->operation));
        }

done:
        talloc_free(tmp_ctx);
}

/*
  connect to a unix domain socket
*/
int ctdb_socket_connect(struct ctdb_context *ctdb)
{
        struct sockaddr_un addr;

        memset(&addr, 0, sizeof(addr));
        addr.sun_family = AF_UNIX;
        strncpy(addr.sun_path, ctdb->daemon.name, sizeof(addr.sun_path)-1);

        ctdb->daemon.sd = socket(AF_UNIX, SOCK_STREAM, 0);
        if (ctdb->daemon.sd == -1) {
                DEBUG(DEBUG_ERR,(__location__ " Failed to open client socket. Errno:%s(%d)\n", strerror(errno), errno));
                return -1;
        }

        if (connect(ctdb->daemon.sd, (struct sockaddr *)&addr, sizeof(addr)) == -1) {
                close(ctdb->daemon.sd);
                ctdb->daemon.sd = -1;
                DEBUG(DEBUG_ERR,(__location__ " Failed to connect client socket to daemon. Errno:%s(%d)\n", strerror(errno), errno));
                return -1;
        }

        set_nonblocking(ctdb->daemon.sd);
        set_close_on_exec(ctdb->daemon.sd);
        
        ctdb->daemon.queue = ctdb_queue_setup(ctdb, ctdb, ctdb->daemon.sd, 
                                              CTDB_DS_ALIGNMENT, 
                                              ctdb_client_read_cb, ctdb, "to-ctdbd");
        return 0;
}


struct ctdb_record_handle {
        struct ctdb_db_context *ctdb_db;
        TDB_DATA key;
        TDB_DATA *data;
        struct ctdb_ltdb_header header;
};


/*
  make a recv call to the local ctdb daemon - called from client context

  This is called when the program wants to wait for a ctdb_call to complete and get the 
  results. This call will block unless the call has already completed.
*/
int ctdb_call_recv(struct ctdb_client_call_state *state, struct ctdb_call *call)
{
        if (state == NULL) {
                return -1;
        }

        while (state->state < CTDB_CALL_DONE) {
                event_loop_once(state->ctdb_db->ctdb->ev);
        }
        if (state->state != CTDB_CALL_DONE) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_call_recv failed\n"));
                talloc_free(state);
                return -1;
        }

        if (state->call->reply_data.dsize) {
                call->reply_data.dptr = talloc_memdup(state->ctdb_db,
                                                      state->call->reply_data.dptr,
                                                      state->call->reply_data.dsize);
                call->reply_data.dsize = state->call->reply_data.dsize;
        } else {
                call->reply_data.dptr = NULL;
                call->reply_data.dsize = 0;
        }
        call->status = state->call->status;
        talloc_free(state);

        return call->status;
}




/*
  destroy a ctdb_call in client
*/
static int ctdb_client_call_destructor(struct ctdb_client_call_state *state)    
{
        ctdb_reqid_remove(state->ctdb_db->ctdb, state->reqid);
        return 0;
}

/*
  construct an event driven local ctdb_call

  this is used so that locally processed ctdb_call requests are processed
  in an event driven manner
*/
static struct ctdb_client_call_state *ctdb_client_call_local_send(struct ctdb_db_context *ctdb_db, 
                                                                  struct ctdb_call *call,
                                                                  struct ctdb_ltdb_header *header,
                                                                  TDB_DATA *data)
{
        struct ctdb_client_call_state *state;
        struct ctdb_context *ctdb = ctdb_db->ctdb;
        int ret;

        state = talloc_zero(ctdb_db, struct ctdb_client_call_state);
        CTDB_NO_MEMORY_NULL(ctdb, state);
        state->call = talloc_zero(state, struct ctdb_call);
        CTDB_NO_MEMORY_NULL(ctdb, state->call);

        talloc_steal(state, data->dptr);

        state->state   = CTDB_CALL_DONE;
        *(state->call) = *call;
        state->ctdb_db = ctdb_db;

        ret = ctdb_call_local(ctdb_db, state->call, header, state, data, true);
        if (ret != 0) {
                DEBUG(DEBUG_DEBUG,("ctdb_call_local() failed, ignoring return code %d\n", ret));
        }

        return state;
}

/*
  make a ctdb call to the local daemon - async send. Called from client context.

  This constructs a ctdb_call request and queues it for processing. 
  This call never blocks.
*/
struct ctdb_client_call_state *ctdb_call_send(struct ctdb_db_context *ctdb_db, 
                                              struct ctdb_call *call)
{
        struct ctdb_client_call_state *state;
        struct ctdb_context *ctdb = ctdb_db->ctdb;
        struct ctdb_ltdb_header header;
        TDB_DATA data;
        int ret;
        size_t len;
        struct ctdb_req_call *c;

        /* if the domain socket is not yet open, open it */
        if (ctdb->daemon.sd==-1) {
                ctdb_socket_connect(ctdb);
        }

        ret = ctdb_ltdb_lock(ctdb_db, call->key);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " Failed to get chainlock\n"));
                return NULL;
        }

        ret = ctdb_ltdb_fetch(ctdb_db, call->key, &header, ctdb_db, &data);

        if ((call->flags & CTDB_IMMEDIATE_MIGRATION) && (header.flags & CTDB_REC_RO_HAVE_DELEGATIONS)) {
                ret = -1;
        }

        if (ret == 0 && header.dmaster == ctdb->pnn) {
                state = ctdb_client_call_local_send(ctdb_db, call, &header, &data);
                talloc_free(data.dptr);
                ctdb_ltdb_unlock(ctdb_db, call->key);
                return state;
        }

        ctdb_ltdb_unlock(ctdb_db, call->key);
        talloc_free(data.dptr);

        state = talloc_zero(ctdb_db, struct ctdb_client_call_state);
        if (state == NULL) {
                DEBUG(DEBUG_ERR, (__location__ " failed to allocate state\n"));
                return NULL;
        }
        state->call = talloc_zero(state, struct ctdb_call);
        if (state->call == NULL) {
                DEBUG(DEBUG_ERR, (__location__ " failed to allocate state->call\n"));
                return NULL;
        }

        len = offsetof(struct ctdb_req_call, data) + call->key.dsize + call->call_data.dsize;
        c = ctdbd_allocate_pkt(ctdb, state, CTDB_REQ_CALL, len, struct ctdb_req_call);
        if (c == NULL) {
                DEBUG(DEBUG_ERR, (__location__ " failed to allocate packet\n"));
                return NULL;
        }

        state->reqid     = ctdb_reqid_new(ctdb, state);
        state->ctdb_db = ctdb_db;
        talloc_set_destructor(state, ctdb_client_call_destructor);

        c->hdr.reqid     = state->reqid;
        c->flags         = call->flags;
        c->db_id         = ctdb_db->db_id;
        c->callid        = call->call_id;
        c->hopcount      = 0;
        c->keylen        = call->key.dsize;
        c->calldatalen   = call->call_data.dsize;
        memcpy(&c->data[0], call->key.dptr, call->key.dsize);
        memcpy(&c->data[call->key.dsize], 
               call->call_data.dptr, call->call_data.dsize);
        *(state->call)              = *call;
        state->call->call_data.dptr = &c->data[call->key.dsize];
        state->call->key.dptr       = &c->data[0];

        state->state  = CTDB_CALL_WAIT;


        ctdb_client_queue_pkt(ctdb, &c->hdr);

        return state;
}


/*
  full ctdb_call. Equivalent to a ctdb_call_send() followed by a ctdb_call_recv()
*/
int ctdb_call(struct ctdb_db_context *ctdb_db, struct ctdb_call *call)
{
        struct ctdb_client_call_state *state;

        state = ctdb_call_send(ctdb_db, call);
        return ctdb_call_recv(state, call);
}


/*
  tell the daemon what messaging srvid we will use, and register the message
  handler function in the client
*/
int ctdb_client_set_message_handler(struct ctdb_context *ctdb, uint64_t srvid, 
                             ctdb_msg_fn_t handler,
                             void *private_data)
{
        int res;
        int32_t status;

        res = ctdb_control(ctdb, CTDB_CURRENT_NODE, srvid, CTDB_CONTROL_REGISTER_SRVID, 0, 
                           tdb_null, NULL, NULL, &status, NULL, NULL);
        if (res != 0 || status != 0) {
                DEBUG(DEBUG_ERR,("Failed to register srvid %llu\n", (unsigned long long)srvid));
                return -1;
        }

        /* also need to register the handler with our own ctdb structure */
        return ctdb_register_message_handler(ctdb, ctdb, srvid, handler, private_data);
}

/*
  tell the daemon we no longer want a srvid
*/
int ctdb_client_remove_message_handler(struct ctdb_context *ctdb, uint64_t srvid, void *private_data)
{
        int res;
        int32_t status;

        res = ctdb_control(ctdb, CTDB_CURRENT_NODE, srvid, CTDB_CONTROL_DEREGISTER_SRVID, 0, 
                           tdb_null, NULL, NULL, &status, NULL, NULL);
        if (res != 0 || status != 0) {
                DEBUG(DEBUG_ERR,("Failed to deregister srvid %llu\n", (unsigned long long)srvid));
                return -1;
        }

        /* also need to register the handler with our own ctdb structure */
        ctdb_deregister_message_handler(ctdb, srvid, private_data);
        return 0;
}

/*
 * check server ids
 */
int ctdb_client_check_message_handlers(struct ctdb_context *ctdb, uint64_t *ids, uint32_t num,
                                       uint8_t *result)
{
        TDB_DATA indata, outdata;
        int res;
        int32_t status;
        int i;

        indata.dptr = (uint8_t *)ids;
        indata.dsize = num * sizeof(*ids);

        res = ctdb_control(ctdb, CTDB_CURRENT_NODE, 0, CTDB_CONTROL_CHECK_SRVIDS, 0,
                           indata, ctdb, &outdata, &status, NULL, NULL);
        if (res != 0 || status != 0) {
                DEBUG(DEBUG_ERR, (__location__ " failed to check srvids\n"));
                return -1;
        }

        if (outdata.dsize != num*sizeof(uint8_t)) {
                DEBUG(DEBUG_ERR, (__location__ " expected %lu bytes, received %zi bytes\n",
                                  (long unsigned int)num*sizeof(uint8_t),
                                  outdata.dsize));
                talloc_free(outdata.dptr);
                return -1;
        }

        for (i=0; i<num; i++) {
                result[i] = outdata.dptr[i];
        }

        talloc_free(outdata.dptr);
        return 0;
}

/*
  send a message - from client context
 */
int ctdb_client_send_message(struct ctdb_context *ctdb, uint32_t pnn,
                      uint64_t srvid, TDB_DATA data)
{
        struct ctdb_req_message *r;
        int len, res;

        len = offsetof(struct ctdb_req_message, data) + data.dsize;
        r = ctdbd_allocate_pkt(ctdb, ctdb, CTDB_REQ_MESSAGE, 
                               len, struct ctdb_req_message);
        CTDB_NO_MEMORY(ctdb, r);

        r->hdr.destnode  = pnn;
        r->srvid         = srvid;
        r->datalen       = data.dsize;
        memcpy(&r->data[0], data.dptr, data.dsize);
        
        res = ctdb_client_queue_pkt(ctdb, &r->hdr);
        talloc_free(r);
        return res;
}


/*
  cancel a ctdb_fetch_lock operation, releasing the lock
 */
static int fetch_lock_destructor(struct ctdb_record_handle *h)
{
        ctdb_ltdb_unlock(h->ctdb_db, h->key);
        return 0;
}

/*
  force the migration of a record to this node
 */
static int ctdb_client_force_migration(struct ctdb_db_context *ctdb_db, TDB_DATA key)
{
        struct ctdb_call call;
        ZERO_STRUCT(call);
        call.call_id = CTDB_NULL_FUNC;
        call.key = key;
        call.flags = CTDB_IMMEDIATE_MIGRATION;
        return ctdb_call(ctdb_db, &call);
}

/*
  try to fetch a readonly copy of a record
 */
static int
ctdb_client_fetch_readonly(struct ctdb_db_context *ctdb_db, TDB_DATA key, TALLOC_CTX *mem_ctx, struct ctdb_ltdb_header **hdr, TDB_DATA *data)
{
        int ret;

        struct ctdb_call call;
        ZERO_STRUCT(call);

        call.call_id = CTDB_FETCH_WITH_HEADER_FUNC;
        call.call_data.dptr = NULL;
        call.call_data.dsize = 0;
        call.key = key;
        call.flags = CTDB_WANT_READONLY;
        ret = ctdb_call(ctdb_db, &call);

        if (ret != 0) {
                return -1;
        }
        if (call.reply_data.dsize < sizeof(struct ctdb_ltdb_header)) {
                return -1;
        }

        *hdr = talloc_memdup(mem_ctx, &call.reply_data.dptr[0], sizeof(struct ctdb_ltdb_header));
        if (*hdr == NULL) {
                talloc_free(call.reply_data.dptr);
                return -1;
        }

        data->dsize = call.reply_data.dsize - sizeof(struct ctdb_ltdb_header);
        data->dptr  = talloc_memdup(mem_ctx, &call.reply_data.dptr[sizeof(struct ctdb_ltdb_header)], data->dsize);
        if (data->dptr == NULL) {
                talloc_free(call.reply_data.dptr);
                talloc_free(hdr);
                return -1;
        }

        return 0;
}

/*
  get a lock on a record, and return the records data. Blocks until it gets the lock
 */
struct ctdb_record_handle *ctdb_fetch_lock(struct ctdb_db_context *ctdb_db, TALLOC_CTX *mem_ctx, 
                                           TDB_DATA key, TDB_DATA *data)
{
        int ret;
        struct ctdb_record_handle *h;

        /*
          procedure is as follows:

          1) get the chain lock. 
          2) check if we are dmaster
          3) if we are the dmaster then return handle 
          4) if not dmaster then ask ctdb daemon to make us dmaster, and wait for
             reply from ctdbd
          5) when we get the reply, goto (1)
         */

        h = talloc_zero(mem_ctx, struct ctdb_record_handle);
        if (h == NULL) {
                return NULL;
        }

        h->ctdb_db = ctdb_db;
        h->key     = key;
        h->key.dptr = talloc_memdup(h, key.dptr, key.dsize);
        if (h->key.dptr == NULL) {
                talloc_free(h);
                return NULL;
        }
        h->data    = data;

        DEBUG(DEBUG_DEBUG,("ctdb_fetch_lock: key=%*.*s\n", (int)key.dsize, (int)key.dsize, 
                 (const char *)key.dptr));

again:
        /* step 1 - get the chain lock */
        ret = ctdb_ltdb_lock(ctdb_db, key);
        if (ret != 0) {
                DEBUG(DEBUG_ERR, (__location__ " failed to lock ltdb record\n"));
                talloc_free(h);
                return NULL;
        }

        DEBUG(DEBUG_DEBUG,("ctdb_fetch_lock: got chain lock\n"));

        talloc_set_destructor(h, fetch_lock_destructor);

        ret = ctdb_ltdb_fetch(ctdb_db, key, &h->header, h, data);

        /* when torturing, ensure we test the remote path */
        if ((ctdb_db->ctdb->flags & CTDB_FLAG_TORTURE) &&
            random() % 5 == 0) {
                h->header.dmaster = (uint32_t)-1;
        }


        DEBUG(DEBUG_DEBUG,("ctdb_fetch_lock: done local fetch\n"));

        if (ret != 0 || h->header.dmaster != ctdb_db->ctdb->pnn) {
                ctdb_ltdb_unlock(ctdb_db, key);
                ret = ctdb_client_force_migration(ctdb_db, key);
                if (ret != 0) {
                        DEBUG(DEBUG_DEBUG,("ctdb_fetch_lock: force_migration failed\n"));
                        talloc_free(h);
                        return NULL;
                }
                goto again;
        }

        /* if this is a request for read/write and we have delegations
           we have to revoke all delegations first
        */
        if ((h->header.dmaster == ctdb_db->ctdb->pnn) &&
            (h->header.flags & CTDB_REC_RO_HAVE_DELEGATIONS)) {
                ctdb_ltdb_unlock(ctdb_db, key);
                ret = ctdb_client_force_migration(ctdb_db, key);
                if (ret != 0) {
                        DEBUG(DEBUG_DEBUG,("ctdb_fetch_readonly_lock: force_migration failed\n"));
                        talloc_free(h);
                        return NULL;
                }
                goto again;
        }

        DEBUG(DEBUG_DEBUG,("ctdb_fetch_lock: we are dmaster - done\n"));
        return h;
}

/*
  get a readonly lock on a record, and return the records data. Blocks until it gets the lock
 */
struct ctdb_record_handle *
ctdb_fetch_readonly_lock(
        struct ctdb_db_context *ctdb_db, TALLOC_CTX *mem_ctx, 
        TDB_DATA key, TDB_DATA *data,
        int read_only)
{
        int ret;
        struct ctdb_record_handle *h;
        struct ctdb_ltdb_header *roheader = NULL;

        h = talloc_zero(mem_ctx, struct ctdb_record_handle);
        if (h == NULL) {
                return NULL;
        }

        h->ctdb_db = ctdb_db;
        h->key     = key;
        h->key.dptr = talloc_memdup(h, key.dptr, key.dsize);
        if (h->key.dptr == NULL) {
                talloc_free(h);
                return NULL;
        }
        h->data    = data;

        data->dptr = NULL;
        data->dsize = 0;


again:
        talloc_free(roheader);
        roheader = NULL;

        talloc_free(data->dptr);
        data->dptr = NULL;
        data->dsize = 0;

        /* Lock the record/chain */
        ret = ctdb_ltdb_lock(ctdb_db, key);
        if (ret != 0) {
                DEBUG(DEBUG_ERR, (__location__ " failed to lock ltdb record\n"));
                talloc_free(h);
                return NULL;
        }

        talloc_set_destructor(h, fetch_lock_destructor);

        /* Check if record exists yet in the TDB */
        ret = ctdb_ltdb_fetch_with_header(ctdb_db, key, &h->header, h, data);
        if (ret != 0) {
                ctdb_ltdb_unlock(ctdb_db, key);
                ret = ctdb_client_force_migration(ctdb_db, key);
                if (ret != 0) {
                        DEBUG(DEBUG_DEBUG,("ctdb_fetch_readonly_lock: force_migration failed\n"));
                        talloc_free(h);
                        return NULL;
                }
                goto again;
        }

        /* if this is a request for read/write and we have delegations
           we have to revoke all delegations first
        */
        if ((read_only == 0) 
        &&  (h->header.dmaster == ctdb_db->ctdb->pnn)
        &&  (h->header.flags & CTDB_REC_RO_HAVE_DELEGATIONS)) {
                ctdb_ltdb_unlock(ctdb_db, key);
                ret = ctdb_client_force_migration(ctdb_db, key);
                if (ret != 0) {
                        DEBUG(DEBUG_DEBUG,("ctdb_fetch_readonly_lock: force_migration failed\n"));
                        talloc_free(h);
                        return NULL;
                }
                goto again;
        }

        /* if we are dmaster, just return the handle */
        if (h->header.dmaster == ctdb_db->ctdb->pnn) {
                return h;
        }

        if (read_only != 0) {
                TDB_DATA rodata = {NULL, 0};

                if ((h->header.flags & CTDB_REC_RO_HAVE_READONLY)
                ||  (h->header.flags & CTDB_REC_RO_HAVE_DELEGATIONS)) {
                        return h;
                }

                ctdb_ltdb_unlock(ctdb_db, key);
                ret = ctdb_client_fetch_readonly(ctdb_db, key, h, &roheader, &rodata);
                if (ret != 0) {
                        DEBUG(DEBUG_ERR,("ctdb_fetch_readonly_lock:  failed. force migration and try again\n"));
                        ret = ctdb_client_force_migration(ctdb_db, key);
                        if (ret != 0) {
                                DEBUG(DEBUG_DEBUG,("ctdb_fetch_readonly_lock: force_migration failed\n"));
                                talloc_free(h);
                                return NULL;
                        }

                        goto again;
                }

                if (!(roheader->flags&CTDB_REC_RO_HAVE_READONLY)) {
                        ret = ctdb_client_force_migration(ctdb_db, key);
                        if (ret != 0) {
                                DEBUG(DEBUG_DEBUG,("ctdb_fetch_readonly_lock: force_migration failed\n"));
                                talloc_free(h);
                                return NULL;
                        }

                        goto again;
                }

                ret = ctdb_ltdb_lock(ctdb_db, key);
                if (ret != 0) {
                        DEBUG(DEBUG_ERR, (__location__ " failed to lock ltdb record\n"));
                        talloc_free(h);
                        return NULL;
                }

                ret = ctdb_ltdb_fetch_with_header(ctdb_db, key, &h->header, h, data);
                if (ret != 0) {
                        ctdb_ltdb_unlock(ctdb_db, key);

                        ret = ctdb_client_force_migration(ctdb_db, key);
                        if (ret != 0) {
                                DEBUG(DEBUG_DEBUG,("ctdb_fetch_readonly_lock: force_migration failed\n"));
                                talloc_free(h);
                                return NULL;
                        }

                        goto again;
                }

                return h;
        }

        /* we are not dmaster and this was not a request for a readonly lock
         * so unlock the record, migrate it and try again
         */
        ctdb_ltdb_unlock(ctdb_db, key);
        ret = ctdb_client_force_migration(ctdb_db, key);
        if (ret != 0) {
                DEBUG(DEBUG_DEBUG,("ctdb_fetch_lock: force_migration failed\n"));
                talloc_free(h);
                return NULL;
        }
        goto again;
}

/*
  store some data to the record that was locked with ctdb_fetch_lock()
*/
int ctdb_record_store(struct ctdb_record_handle *h, TDB_DATA data)
{
        if (h->ctdb_db->persistent) {
                DEBUG(DEBUG_ERR, (__location__ " ctdb_record_store prohibited for persistent dbs\n"));
                return -1;
        }

        return ctdb_ltdb_store(h->ctdb_db, h->key, &h->header, data);
}

/*
  non-locking fetch of a record
 */
int ctdb_fetch(struct ctdb_db_context *ctdb_db, TALLOC_CTX *mem_ctx, 
               TDB_DATA key, TDB_DATA *data)
{
        struct ctdb_call call;
        int ret;

        call.call_id = CTDB_FETCH_FUNC;
        call.call_data.dptr = NULL;
        call.call_data.dsize = 0;
        call.key = key;

        ret = ctdb_call(ctdb_db, &call);

        if (ret == 0) {
                *data = call.reply_data;
                talloc_steal(mem_ctx, data->dptr);
        }

        return ret;
}



/*
   called when a control completes or timesout to invoke the callback
   function the user provided
*/
static void invoke_control_callback(struct event_context *ev, struct timed_event *te, 
        struct timeval t, void *private_data)
{
        struct ctdb_client_control_state *state;
        TALLOC_CTX *tmp_ctx = talloc_new(NULL);
        int ret;

        state = talloc_get_type(private_data, struct ctdb_client_control_state);
        talloc_steal(tmp_ctx, state);

        ret = ctdb_control_recv(state->ctdb, state, state,
                        NULL, 
                        NULL, 
                        NULL);
        if (ret != 0) {
                DEBUG(DEBUG_DEBUG,("ctdb_control_recv() failed, ignoring return code %d\n", ret));
        }

        talloc_free(tmp_ctx);
}

/*
  called when a CTDB_REPLY_CONTROL packet comes in in the client

  This packet comes in response to a CTDB_REQ_CONTROL request packet. It
  contains any reply data from the control
*/
static void ctdb_client_reply_control(struct ctdb_context *ctdb, 
                                      struct ctdb_req_header *hdr)
{
        struct ctdb_reply_control *c = (struct ctdb_reply_control *)hdr;
        struct ctdb_client_control_state *state;

        state = ctdb_reqid_find(ctdb, hdr->reqid, struct ctdb_client_control_state);
        if (state == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " reqid %u not found\n", hdr->reqid));
                return;
        }

        if (hdr->reqid != state->reqid) {
                /* we found a record  but it was the wrong one */
                DEBUG(DEBUG_ERR, ("Dropped orphaned reply control with reqid:%u\n",hdr->reqid));
                return;
        }

        state->outdata.dptr = c->data;
        state->outdata.dsize = c->datalen;
        state->status = c->status;
        if (c->errorlen) {
                state->errormsg = talloc_strndup(state, 
                                                 (char *)&c->data[c->datalen], 
                                                 c->errorlen);
        }

        /* state->outdata now uses resources from c so we dont want c
           to just dissappear from under us while state is still alive
        */
        talloc_steal(state, c);

        state->state = CTDB_CONTROL_DONE;

        /* if we had a callback registered for this control, pull the response
           and call the callback.
        */
        if (state->async.fn) {
                event_add_timed(ctdb->ev, state, timeval_zero(), invoke_control_callback, state);
        }
}


/*
  destroy a ctdb_control in client
*/
static int ctdb_client_control_destructor(struct ctdb_client_control_state *state)
{
        ctdb_reqid_remove(state->ctdb, state->reqid);
        return 0;
}


/* time out handler for ctdb_control */
static void control_timeout_func(struct event_context *ev, struct timed_event *te, 
        struct timeval t, void *private_data)
{
        struct ctdb_client_control_state *state = talloc_get_type(private_data, struct ctdb_client_control_state);

        DEBUG(DEBUG_ERR,(__location__ " control timed out. reqid:%u opcode:%u "
                         "dstnode:%u\n", state->reqid, state->c->opcode,
                         state->c->hdr.destnode));

        state->state = CTDB_CONTROL_TIMEOUT;

        /* if we had a callback registered for this control, pull the response
           and call the callback.
        */
        if (state->async.fn) {
                event_add_timed(state->ctdb->ev, state, timeval_zero(), invoke_control_callback, state);
        }
}

/* async version of send control request */
struct ctdb_client_control_state *ctdb_control_send(struct ctdb_context *ctdb, 
                uint32_t destnode, uint64_t srvid, 
                uint32_t opcode, uint32_t flags, TDB_DATA data, 
                TALLOC_CTX *mem_ctx,
                struct timeval *timeout,
                char **errormsg)
{
        struct ctdb_client_control_state *state;
        size_t len;
        struct ctdb_req_control *c;
        int ret;

        if (errormsg) {
                *errormsg = NULL;
        }

        /* if the domain socket is not yet open, open it */
        if (ctdb->daemon.sd==-1) {
                ctdb_socket_connect(ctdb);
        }

        state = talloc_zero(mem_ctx, struct ctdb_client_control_state);
        CTDB_NO_MEMORY_NULL(ctdb, state);

        state->ctdb       = ctdb;
        state->reqid      = ctdb_reqid_new(ctdb, state);
        state->state      = CTDB_CONTROL_WAIT;
        state->errormsg   = NULL;

        talloc_set_destructor(state, ctdb_client_control_destructor);

        len = offsetof(struct ctdb_req_control, data) + data.dsize;
        c = ctdbd_allocate_pkt(ctdb, state, CTDB_REQ_CONTROL, 
                               len, struct ctdb_req_control);
        state->c            = c;        
        CTDB_NO_MEMORY_NULL(ctdb, c);
        c->hdr.reqid        = state->reqid;
        c->hdr.destnode     = destnode;
        c->opcode           = opcode;
        c->client_id        = 0;
        c->flags            = flags;
        c->srvid            = srvid;
        c->datalen          = data.dsize;
        if (data.dsize) {
                memcpy(&c->data[0], data.dptr, data.dsize);
        }

        /* timeout */
        if (timeout && !timeval_is_zero(timeout)) {
                event_add_timed(ctdb->ev, state, *timeout, control_timeout_func, state);
        }

        ret = ctdb_client_queue_pkt(ctdb, &(c->hdr));
        if (ret != 0) {
                talloc_free(state);
                return NULL;
        }

        if (flags & CTDB_CTRL_FLAG_NOREPLY) {
                talloc_free(state);
                return NULL;
        }

        return state;
}


/* async version of receive control reply */
int ctdb_control_recv(struct ctdb_context *ctdb, 
                struct ctdb_client_control_state *state, 
                TALLOC_CTX *mem_ctx,
                TDB_DATA *outdata, int32_t *status, char **errormsg)
{
        TALLOC_CTX *tmp_ctx;

        if (status != NULL) {
                *status = -1;
        }
        if (errormsg != NULL) {
                *errormsg = NULL;
        }

        if (state == NULL) {
                return -1;
        }

        /* prevent double free of state */
        tmp_ctx = talloc_new(ctdb);
        talloc_steal(tmp_ctx, state);

        /* loop one event at a time until we either timeout or the control
           completes.
        */
        while (state->state == CTDB_CONTROL_WAIT) {
                event_loop_once(ctdb->ev);
        }

        if (state->state != CTDB_CONTROL_DONE) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control_recv failed\n"));
                if (state->async.fn) {
                        state->async.fn(state);
                }
                talloc_free(tmp_ctx);
                return -1;
        }

        if (state->errormsg) {
                DEBUG(DEBUG_ERR,("ctdb_control error: '%s'\n", state->errormsg));
                if (errormsg) {
                        (*errormsg) = talloc_move(mem_ctx, &state->errormsg);
                }
                if (state->async.fn) {
                        state->async.fn(state);
                }
                talloc_free(tmp_ctx);
                return -1;
        }

        if (outdata) {
                *outdata = state->outdata;
                outdata->dptr = talloc_memdup(mem_ctx, outdata->dptr, outdata->dsize);
        }

        if (status) {
                *status = state->status;
        }

        if (state->async.fn) {
                state->async.fn(state);
        }

        talloc_free(tmp_ctx);
        return 0;
}



/*
  send a ctdb control message
  timeout specifies how long we should wait for a reply.
  if timeout is NULL we wait indefinitely
 */
int ctdb_control(struct ctdb_context *ctdb, uint32_t destnode, uint64_t srvid, 
                 uint32_t opcode, uint32_t flags, TDB_DATA data, 
                 TALLOC_CTX *mem_ctx, TDB_DATA *outdata, int32_t *status,
                 struct timeval *timeout,
                 char **errormsg)
{
        struct ctdb_client_control_state *state;

        state = ctdb_control_send(ctdb, destnode, srvid, opcode, 
                        flags, data, mem_ctx,
                        timeout, errormsg);

        /* FIXME: Error conditions in ctdb_control_send return NULL without
         * setting errormsg.  So, there is no way to distinguish between sucess
         * and failure when CTDB_CTRL_FLAG_NOREPLY is set */
        if (flags & CTDB_CTRL_FLAG_NOREPLY) {
                if (status != NULL) {
                        *status = 0;
                }
                return 0;
        }

        return ctdb_control_recv(ctdb, state, mem_ctx, outdata, status, 
                        errormsg);
}




/*
  a process exists call. Returns 0 if process exists, -1 otherwise
 */
int ctdb_ctrl_process_exists(struct ctdb_context *ctdb, uint32_t destnode, pid_t pid)
{
        int ret;
        TDB_DATA data;
        int32_t status;

        data.dptr = (uint8_t*)&pid;
        data.dsize = sizeof(pid);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_PROCESS_EXISTS, 0, data, 
                           NULL, NULL, &status, NULL, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for process_exists failed\n"));
                return -1;
        }

        return status;
}

/*
  get remote statistics
 */
int ctdb_ctrl_statistics(struct ctdb_context *ctdb, uint32_t destnode, struct ctdb_statistics *status)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_STATISTICS, 0, tdb_null, 
                           ctdb, &data, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for statistics failed\n"));
                return -1;
        }

        if (data.dsize != sizeof(struct ctdb_statistics)) {
                DEBUG(DEBUG_ERR,(__location__ " Wrong statistics size %u - expected %u\n",
                         (unsigned)data.dsize, (unsigned)sizeof(struct ctdb_statistics)));
                      return -1;
        }

        *status = *(struct ctdb_statistics *)data.dptr;
        talloc_free(data.dptr);
                        
        return 0;
}

/*
 * get db statistics
 */
int ctdb_ctrl_dbstatistics(struct ctdb_context *ctdb, uint32_t destnode, uint32_t dbid,
                           TALLOC_CTX *mem_ctx, struct ctdb_db_statistics **dbstat)
{
        int ret;
        TDB_DATA indata, outdata;
        int32_t res;
        struct ctdb_db_statistics *wire, *s;
        char *ptr;
        int i;

        indata.dptr = (uint8_t *)&dbid;
        indata.dsize = sizeof(dbid);

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_GET_DB_STATISTICS,
                           0, indata, ctdb, &outdata, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for dbstatistics failed\n"));
                return -1;
        }

        if (outdata.dsize < offsetof(struct ctdb_db_statistics, hot_keys_wire)) {
                DEBUG(DEBUG_ERR,(__location__ " Wrong dbstatistics size %zi - expected >= %lu\n",
                                 outdata.dsize,
                                 (long unsigned int)sizeof(struct ctdb_statistics)));
                return -1;
        }

        s = talloc_zero(mem_ctx, struct ctdb_db_statistics);
        if (s == NULL) {
                talloc_free(outdata.dptr);
                CTDB_NO_MEMORY(ctdb, s);
        }

        wire = (struct ctdb_db_statistics *)outdata.dptr;
        *s = *wire;
        ptr = &wire->hot_keys_wire[0];
        for (i=0; i<wire->num_hot_keys; i++) {
                s->hot_keys[i].key.dptr = talloc_size(mem_ctx, s->hot_keys[i].key.dsize);
                if (s->hot_keys[i].key.dptr == NULL) {
                        talloc_free(outdata.dptr);
                        CTDB_NO_MEMORY(ctdb, s->hot_keys[i].key.dptr);
                }

                memcpy(s->hot_keys[i].key.dptr, ptr, s->hot_keys[i].key.dsize);
                ptr += wire->hot_keys[i].key.dsize;
        }

        talloc_free(outdata.dptr);
        *dbstat = s;
        return 0;
}

/*
  shutdown a remote ctdb node
 */
int ctdb_ctrl_shutdown(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        struct ctdb_client_control_state *state;

        state = ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_SHUTDOWN, 0, tdb_null, 
                           NULL, &timeout, NULL);
        if (state == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for shutdown failed\n"));
                return -1;
        }

        return 0;
}

/*
  get vnn map from a remote node
 */
int ctdb_ctrl_getvnnmap(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, TALLOC_CTX *mem_ctx, struct ctdb_vnn_map **vnnmap)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;
        struct ctdb_vnn_map_wire *map;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GETVNNMAP, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getvnnmap failed\n"));
                return -1;
        }
        
        map = (struct ctdb_vnn_map_wire *)outdata.dptr;
        if (outdata.dsize < offsetof(struct ctdb_vnn_map_wire, map) ||
            outdata.dsize != map->size*sizeof(uint32_t) + offsetof(struct ctdb_vnn_map_wire, map)) {
                DEBUG(DEBUG_ERR,("Bad vnn map size received in ctdb_ctrl_getvnnmap\n"));
                return -1;
        }

        (*vnnmap) = talloc(mem_ctx, struct ctdb_vnn_map);
        CTDB_NO_MEMORY(ctdb, *vnnmap);
        (*vnnmap)->generation = map->generation;
        (*vnnmap)->size       = map->size;
        (*vnnmap)->map        = talloc_array(*vnnmap, uint32_t, map->size);

        CTDB_NO_MEMORY(ctdb, (*vnnmap)->map);
        memcpy((*vnnmap)->map, map->map, sizeof(uint32_t)*map->size);
        talloc_free(outdata.dptr);
                    
        return 0;
}


/*
  get the recovery mode of a remote node
 */
struct ctdb_client_control_state *
ctdb_ctrl_getrecmode_send(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode)
{
        return ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_RECMODE, 0, tdb_null, 
                           mem_ctx, &timeout, NULL);
}

int ctdb_ctrl_getrecmode_recv(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct ctdb_client_control_state *state, uint32_t *recmode)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, mem_ctx, NULL, &res, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_getrecmode_recv failed\n"));
                return -1;
        }

        if (recmode) {
                *recmode = (uint32_t)res;
        }

        return 0;
}

int ctdb_ctrl_getrecmode(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode, uint32_t *recmode)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_getrecmode_send(ctdb, mem_ctx, timeout, destnode);
        return ctdb_ctrl_getrecmode_recv(ctdb, mem_ctx, state, recmode);
}




/*
  set the recovery mode of a remote node
 */
int ctdb_ctrl_setrecmode(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t recmode)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = sizeof(uint32_t);
        data.dptr = (unsigned char *)&recmode;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_RECMODE, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setrecmode failed\n"));
                return -1;
        }

        return 0;
}



/*
  get the recovery master of a remote node
 */
struct ctdb_client_control_state *
ctdb_ctrl_getrecmaster_send(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, 
                        struct timeval timeout, uint32_t destnode)
{
        return ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_RECMASTER, 0, tdb_null, 
                           mem_ctx, &timeout, NULL);
}

int ctdb_ctrl_getrecmaster_recv(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct ctdb_client_control_state *state, uint32_t *recmaster)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, mem_ctx, NULL, &res, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_getrecmaster_recv failed\n"));
                return -1;
        }

        if (recmaster) {
                *recmaster = (uint32_t)res;
        }

        return 0;
}

int ctdb_ctrl_getrecmaster(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode, uint32_t *recmaster)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_getrecmaster_send(ctdb, mem_ctx, timeout, destnode);
        return ctdb_ctrl_getrecmaster_recv(ctdb, mem_ctx, state, recmaster);
}


/*
  set the recovery master of a remote node
 */
int ctdb_ctrl_setrecmaster(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t recmaster)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        ZERO_STRUCT(data);
        data.dsize = sizeof(uint32_t);
        data.dptr = (unsigned char *)&recmaster;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_RECMASTER, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setrecmaster failed\n"));
                return -1;
        }

        return 0;
}


/*
  get a list of databases off a remote node
 */
int ctdb_ctrl_getdbmap(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, 
                       TALLOC_CTX *mem_ctx, struct ctdb_dbid_map **dbmap)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_DBMAP, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getdbmap failed ret:%d res:%d\n", ret, res));
                return -1;
        }

        *dbmap = (struct ctdb_dbid_map *)talloc_memdup(mem_ctx, outdata.dptr, outdata.dsize);
        talloc_free(outdata.dptr);
                    
        return 0;
}

/*
  get a list of nodes (vnn and flags ) from a remote node
 */
int ctdb_ctrl_getnodemap(struct ctdb_context *ctdb, 
                struct timeval timeout, uint32_t destnode, 
                TALLOC_CTX *mem_ctx, struct ctdb_node_map **nodemap)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_NODEMAP, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret == 0 && res == -1 && outdata.dsize == 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getnodes failed, falling back to ipv4-only control\n"));
                return ctdb_ctrl_getnodemapv4(ctdb, timeout, destnode, mem_ctx, nodemap);
        }
        if (ret != 0 || res != 0 || outdata.dsize == 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getnodes failed ret:%d res:%d\n", ret, res));
                return -1;
        }

        *nodemap = (struct ctdb_node_map *)talloc_memdup(mem_ctx, outdata.dptr, outdata.dsize);
        talloc_free(outdata.dptr);
                    
        return 0;
}

/*
  old style ipv4-only get a list of nodes (vnn and flags ) from a remote node
 */
int ctdb_ctrl_getnodemapv4(struct ctdb_context *ctdb, 
                struct timeval timeout, uint32_t destnode, 
                TALLOC_CTX *mem_ctx, struct ctdb_node_map **nodemap)
{
        int ret, i, len;
        TDB_DATA outdata;
        struct ctdb_node_mapv4 *nodemapv4;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_NODEMAPv4, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0 || outdata.dsize == 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getnodesv4 failed ret:%d res:%d\n", ret, res));
                return -1;
        }

        nodemapv4 = (struct ctdb_node_mapv4 *)outdata.dptr;

        len = offsetof(struct ctdb_node_map, nodes) + nodemapv4->num*sizeof(struct ctdb_node_and_flags);
        (*nodemap) = talloc_zero_size(mem_ctx, len);
        CTDB_NO_MEMORY(ctdb, (*nodemap));

        (*nodemap)->num = nodemapv4->num;
        for (i=0; i<nodemapv4->num; i++) {
                (*nodemap)->nodes[i].pnn     = nodemapv4->nodes[i].pnn;
                (*nodemap)->nodes[i].flags   = nodemapv4->nodes[i].flags;
                (*nodemap)->nodes[i].addr.ip = nodemapv4->nodes[i].sin;
                (*nodemap)->nodes[i].addr.sa.sa_family = AF_INET;
        }
                
        talloc_free(outdata.dptr);
                    
        return 0;
}

/*
  drop the transport, reload the nodes file and restart the transport
 */
int ctdb_ctrl_reload_nodes_file(struct ctdb_context *ctdb, 
                    struct timeval timeout, uint32_t destnode)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_RELOAD_NODES_FILE, 0, tdb_null, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for reloadnodesfile failed\n"));
                return -1;
        }

        return 0;
}


/*
  set vnn map on a node
 */
int ctdb_ctrl_setvnnmap(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, 
                        TALLOC_CTX *mem_ctx, struct ctdb_vnn_map *vnnmap)
{
        int ret;
        TDB_DATA data;
        int32_t res;
        struct ctdb_vnn_map_wire *map;
        size_t len;

        len = offsetof(struct ctdb_vnn_map_wire, map) + sizeof(uint32_t)*vnnmap->size;
        map = talloc_size(mem_ctx, len);
        CTDB_NO_MEMORY(ctdb, map);

        map->generation = vnnmap->generation;
        map->size = vnnmap->size;
        memcpy(map->map, vnnmap->map, sizeof(uint32_t)*map->size);
        
        data.dsize = len;
        data.dptr  = (uint8_t *)map;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SETVNNMAP, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setvnnmap failed\n"));
                return -1;
        }

        talloc_free(map);

        return 0;
}


/*
  async send for pull database
 */
struct ctdb_client_control_state *ctdb_ctrl_pulldb_send(
        struct ctdb_context *ctdb, uint32_t destnode, uint32_t dbid,
        uint32_t lmaster, TALLOC_CTX *mem_ctx, struct timeval timeout)
{
        TDB_DATA indata;
        struct ctdb_control_pulldb *pull;
        struct ctdb_client_control_state *state;

        pull = talloc(mem_ctx, struct ctdb_control_pulldb);
        CTDB_NO_MEMORY_NULL(ctdb, pull);

        pull->db_id   = dbid;
        pull->lmaster = lmaster;

        indata.dsize = sizeof(struct ctdb_control_pulldb);
        indata.dptr  = (unsigned char *)pull;

        state = ctdb_control_send(ctdb, destnode, 0, 
                                  CTDB_CONTROL_PULL_DB, 0, indata, 
                                  mem_ctx, &timeout, NULL);
        talloc_free(pull);

        return state;
}

/*
  async recv for pull database
 */
int ctdb_ctrl_pulldb_recv(
        struct ctdb_context *ctdb, 
        TALLOC_CTX *mem_ctx, struct ctdb_client_control_state *state, 
        TDB_DATA *outdata)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, mem_ctx, outdata, &res, NULL);
        if ( (ret != 0) || (res != 0) ){
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_pulldb_recv failed\n"));
                return -1;
        }

        return 0;
}

/*
  pull all keys and records for a specific database on a node
 */
int ctdb_ctrl_pulldb(struct ctdb_context *ctdb, uint32_t destnode, 
                uint32_t dbid, uint32_t lmaster, 
                TALLOC_CTX *mem_ctx, struct timeval timeout,
                TDB_DATA *outdata)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_pulldb_send(ctdb, destnode, dbid, lmaster, mem_ctx,
                                      timeout);
        
        return ctdb_ctrl_pulldb_recv(ctdb, mem_ctx, state, outdata);
}


/*
  change dmaster for all keys in the database to the new value
 */
int ctdb_ctrl_setdmaster(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, 
                         TALLOC_CTX *mem_ctx, uint32_t dbid, uint32_t dmaster)
{
        int ret;
        TDB_DATA indata;
        int32_t res;

        indata.dsize = 2*sizeof(uint32_t);
        indata.dptr = (unsigned char *)talloc_array(mem_ctx, uint32_t, 2);

        ((uint32_t *)(&indata.dptr[0]))[0] = dbid;
        ((uint32_t *)(&indata.dptr[0]))[1] = dmaster;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_DMASTER, 0, indata, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setdmaster failed\n"));
                return -1;
        }

        return 0;
}

/*
  ping a node, return number of clients connected
 */
int ctdb_ctrl_ping(struct ctdb_context *ctdb, uint32_t destnode)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_PING, 0, 
                           tdb_null, NULL, NULL, &res, NULL, NULL);
        if (ret != 0) {
                return -1;
        }
        return res;
}

int ctdb_ctrl_get_runstate(struct ctdb_context *ctdb, 
                           struct timeval timeout, 
                           uint32_t destnode,
                           uint32_t *runstate)
{
        TDB_DATA outdata;
        int32_t res;
        int ret;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_GET_RUNSTATE, 0,
                           tdb_null, ctdb, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,("ctdb_control for get_runstate failed\n"));
                return ret != 0 ? ret : res;
        }

        if (outdata.dsize != sizeof(uint32_t)) {
                DEBUG(DEBUG_ERR,("Invalid return data in get_runstate\n"));
                talloc_free(outdata.dptr);
                return -1;
        }

        if (runstate != NULL) {
                *runstate = *(uint32_t *)outdata.dptr;
        }
        talloc_free(outdata.dptr);

        return 0;
}

/*
  find the real path to a ltdb 
 */
int ctdb_ctrl_getdbpath(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t dbid, TALLOC_CTX *mem_ctx, 
                   const char **path)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        data.dptr = (uint8_t *)&dbid;
        data.dsize = sizeof(dbid);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GETDBPATH, 0, data, 
                           mem_ctx, &data, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                return -1;
        }

        (*path) = talloc_strndup(mem_ctx, (const char *)data.dptr, data.dsize);
        if ((*path) == NULL) {
                return -1;
        }

        talloc_free(data.dptr);

        return 0;
}

/*
  find the name of a db 
 */
int ctdb_ctrl_getdbname(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t dbid, TALLOC_CTX *mem_ctx, 
                   const char **name)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        data.dptr = (uint8_t *)&dbid;
        data.dsize = sizeof(dbid);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_DBNAME, 0, data, 
                           mem_ctx, &data, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                return -1;
        }

        (*name) = talloc_strndup(mem_ctx, (const char *)data.dptr, data.dsize);
        if ((*name) == NULL) {
                return -1;
        }

        talloc_free(data.dptr);

        return 0;
}

/*
  get the health status of a db
 */
int ctdb_ctrl_getdbhealth(struct ctdb_context *ctdb,
                          struct timeval timeout,
                          uint32_t destnode,
                          uint32_t dbid, TALLOC_CTX *mem_ctx,
                          const char **reason)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        data.dptr = (uint8_t *)&dbid;
        data.dsize = sizeof(dbid);

        ret = ctdb_control(ctdb, destnode, 0,
                           CTDB_CONTROL_DB_GET_HEALTH, 0, data,
                           mem_ctx, &data, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                return -1;
        }

        if (data.dsize == 0) {
                (*reason) = NULL;
                return 0;
        }

        (*reason) = talloc_strndup(mem_ctx, (const char *)data.dptr, data.dsize);
        if ((*reason) == NULL) {
                return -1;
        }

        talloc_free(data.dptr);

        return 0;
}

/*
 * get db sequence number
 */
int ctdb_ctrl_getdbseqnum(struct ctdb_context *ctdb, struct timeval timeout,
                          uint32_t destnode, uint32_t dbid, uint64_t *seqnum)
{
        int ret;
        int32_t res;
        TDB_DATA data, outdata;

        data.dptr = (uint8_t *)&dbid;
        data.dsize = sizeof(uint64_t);  /* This is just wrong */

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_GET_DB_SEQNUM,
                           0, data, ctdb, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,("ctdb_control for getdbesqnum failed\n"));
                return -1;
        }

        if (outdata.dsize != sizeof(uint64_t)) {
                DEBUG(DEBUG_ERR,("Invalid return data in get_dbseqnum\n"));
                talloc_free(outdata.dptr);
                return -1;
        }

        if (seqnum != NULL) {
                *seqnum = *(uint64_t *)outdata.dptr;
        }
        talloc_free(outdata.dptr);

        return 0;
}

/*
  create a database
 */
int ctdb_ctrl_createdb(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, 
                       TALLOC_CTX *mem_ctx, const char *name, bool persistent)
{
        int ret;
        int32_t res;
        TDB_DATA data;
        uint64_t tdb_flags = 0;

        data.dptr = discard_const(name);
        data.dsize = strlen(name)+1;

        /* Make sure that volatile databases use jenkins hash */
        if (!persistent) {
                tdb_flags = TDB_INCOMPATIBLE_HASH;
        }

#ifdef TDB_MUTEX_LOCKING
        if (!persistent && ctdb->tunable.mutex_enabled == 1) {
                tdb_flags |= (TDB_MUTEX_LOCKING | TDB_CLEAR_IF_FIRST);
        }
#endif

        ret = ctdb_control(ctdb, destnode, tdb_flags,
                           persistent?CTDB_CONTROL_DB_ATTACH_PERSISTENT:CTDB_CONTROL_DB_ATTACH, 
                           0, data, 
                           mem_ctx, &data, &res, &timeout, NULL);

        if (ret != 0 || res != 0) {
                return -1;
        }

        return 0;
}

/*
  get debug level on a node
 */
int ctdb_ctrl_get_debuglevel(struct ctdb_context *ctdb, uint32_t destnode, int32_t *level)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_GET_DEBUG, 0, tdb_null, 
                           ctdb, &data, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                return -1;
        }
        if (data.dsize != sizeof(int32_t)) {
                DEBUG(DEBUG_ERR,("Bad control reply size in ctdb_get_debuglevel (got %u)\n",
                         (unsigned)data.dsize));
                return -1;
        }
        *level = *(int32_t *)data.dptr;
        talloc_free(data.dptr);
        return 0;
}

/*
  set debug level on a node
 */
int ctdb_ctrl_set_debuglevel(struct ctdb_context *ctdb, uint32_t destnode, int32_t level)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        data.dptr = (uint8_t *)&level;
        data.dsize = sizeof(level);

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_SET_DEBUG, 0, data, 
                           NULL, NULL, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                return -1;
        }
        return 0;
}


/*
  get a list of connected nodes
 */
uint32_t *ctdb_get_connected_nodes(struct ctdb_context *ctdb, 
                                struct timeval timeout,
                                TALLOC_CTX *mem_ctx,
                                uint32_t *num_nodes)
{
        struct ctdb_node_map *map=NULL;
        int ret, i;
        uint32_t *nodes;

        *num_nodes = 0;

        ret = ctdb_ctrl_getnodemap(ctdb, timeout, CTDB_CURRENT_NODE, mem_ctx, &map);
        if (ret != 0) {
                return NULL;
        }

        nodes = talloc_array(mem_ctx, uint32_t, map->num);
        if (nodes == NULL) {
                return NULL;
        }

        for (i=0;i<map->num;i++) {
                if (!(map->nodes[i].flags & NODE_FLAGS_DISCONNECTED)) {
                        nodes[*num_nodes] = map->nodes[i].pnn;
                        (*num_nodes)++;
                }
        }

        return nodes;
}


/*
  reset remote status
 */
int ctdb_statistics_reset(struct ctdb_context *ctdb, uint32_t destnode)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_STATISTICS_RESET, 0, tdb_null, 
                           NULL, NULL, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for reset statistics failed\n"));
                return -1;
        }
        return 0;
}

/*
  attach to a specific database - client call
*/
struct ctdb_db_context *ctdb_attach(struct ctdb_context *ctdb,
                                    struct timeval timeout,
                                    const char *name,
                                    bool persistent,
                                    uint32_t tdb_flags)
{
        struct ctdb_db_context *ctdb_db;
        TDB_DATA data;
        int ret;
        int32_t res;
#ifdef TDB_MUTEX_LOCKING
        uint32_t mutex_enabled = 0;
#endif

        ctdb_db = ctdb_db_handle(ctdb, name);
        if (ctdb_db) {
                return ctdb_db;
        }

        ctdb_db = talloc_zero(ctdb, struct ctdb_db_context);
        CTDB_NO_MEMORY_NULL(ctdb, ctdb_db);

        ctdb_db->ctdb = ctdb;
        ctdb_db->db_name = talloc_strdup(ctdb_db, name);
        CTDB_NO_MEMORY_NULL(ctdb, ctdb_db->db_name);

        data.dptr = discard_const(name);
        data.dsize = strlen(name)+1;

        /* CTDB has switched to using jenkins hash for volatile databases.
         * Even if tdb_flags do not explicitly mention TDB_INCOMPATIBLE_HASH,
         * always set it.
         */
        if (!persistent) {
                tdb_flags |= TDB_INCOMPATIBLE_HASH;
        }

#ifdef TDB_MUTEX_LOCKING
        if (!persistent) {
                ret = ctdb_ctrl_get_tunable(ctdb, timeval_current_ofs(3,0),
                                            CTDB_CURRENT_NODE,
                                            "TDBMutexEnabled",
                                            &mutex_enabled);
                if (ret != 0) {
                        DEBUG(DEBUG_WARNING, ("Assuming no mutex support.\n"));
                }

                if (mutex_enabled == 1) {
                        tdb_flags |= (TDB_MUTEX_LOCKING | TDB_CLEAR_IF_FIRST);
                }
        }
#endif

        /* tell ctdb daemon to attach */
        ret = ctdb_control(ctdb, CTDB_CURRENT_NODE, tdb_flags, 
                           persistent?CTDB_CONTROL_DB_ATTACH_PERSISTENT:CTDB_CONTROL_DB_ATTACH,
                           0, data, ctdb_db, &data, &res, NULL, NULL);
        if (ret != 0 || res != 0 || data.dsize != sizeof(uint32_t)) {
                DEBUG(DEBUG_ERR,("Failed to attach to database '%s'\n", name));
                talloc_free(ctdb_db);
                return NULL;
        }
        
        ctdb_db->db_id = *(uint32_t *)data.dptr;
        talloc_free(data.dptr);

        ret = ctdb_ctrl_getdbpath(ctdb, timeout, CTDB_CURRENT_NODE, ctdb_db->db_id, ctdb_db, &ctdb_db->db_path);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,("Failed to get dbpath for database '%s'\n", name));
                talloc_free(ctdb_db);
                return NULL;
        }

        if (persistent) {
                tdb_flags = TDB_DEFAULT;
        } else {
                tdb_flags = TDB_NOSYNC;
#ifdef TDB_MUTEX_LOCKING
                if (mutex_enabled) {
                        tdb_flags |= (TDB_MUTEX_LOCKING | TDB_CLEAR_IF_FIRST);
                }
#endif
        }
        if (ctdb->valgrinding) {
                tdb_flags |= TDB_NOMMAP;
        }
        tdb_flags |= TDB_DISALLOW_NESTING;

        ctdb_db->ltdb = tdb_wrap_open(ctdb_db, ctdb_db->db_path, 0, tdb_flags,
                                      O_RDWR, 0);
        if (ctdb_db->ltdb == NULL) {
                ctdb_set_error(ctdb, "Failed to open tdb '%s'\n", ctdb_db->db_path);
                talloc_free(ctdb_db);
                return NULL;
        }

        ctdb_db->persistent = persistent;

        DLIST_ADD(ctdb->db_list, ctdb_db);

        /* add well known functions */
        ctdb_set_call(ctdb_db, ctdb_null_func, CTDB_NULL_FUNC);
        ctdb_set_call(ctdb_db, ctdb_fetch_func, CTDB_FETCH_FUNC);
        ctdb_set_call(ctdb_db, ctdb_fetch_with_header_func, CTDB_FETCH_WITH_HEADER_FUNC);

        return ctdb_db;
}

/*
 * detach from a specific database - client call
 */
int ctdb_detach(struct ctdb_context *ctdb, uint32_t db_id)
{
        int ret;
        int32_t status;
        TDB_DATA data;

        data.dsize = sizeof(db_id);
        data.dptr = (uint8_t *)&db_id;

        ret = ctdb_control(ctdb, CTDB_CURRENT_NODE, 0, CTDB_CONTROL_DB_DETACH,
                           0, data, NULL, NULL, &status, NULL, NULL);
        if (ret != 0 || status != 0) {
                return -1;
        }
        return 0;
}

/*
  setup a call for a database
 */
int ctdb_set_call(struct ctdb_db_context *ctdb_db, ctdb_fn_t fn, uint32_t id)
{
        struct ctdb_registered_call *call;

#if 0
        TDB_DATA data;
        int32_t status;
        struct ctdb_control_set_call c;
        int ret;

        /* this is no longer valid with the separate daemon architecture */
        c.db_id = ctdb_db->db_id;
        c.fn    = fn;
        c.id    = id;

        data.dptr = (uint8_t *)&c;
        data.dsize = sizeof(c);

        ret = ctdb_control(ctdb_db->ctdb, CTDB_CURRENT_NODE, 0, CTDB_CONTROL_SET_CALL, 0,
                           data, NULL, NULL, &status, NULL, NULL);
        if (ret != 0 || status != 0) {
                DEBUG(DEBUG_ERR,("ctdb_set_call failed for call %u\n", id));
                return -1;
        }
#endif

        /* also register locally */
        call = talloc(ctdb_db, struct ctdb_registered_call);
        call->fn = fn;
        call->id = id;

        DLIST_ADD(ctdb_db->calls, call);        
        return 0;
}


struct traverse_state {
        bool done;
        uint32_t count;
        ctdb_traverse_func fn;
        void *private_data;
        bool listemptyrecords;
};

/*
  called on each key during a ctdb_traverse
 */
static void traverse_handler(struct ctdb_context *ctdb, uint64_t srvid, TDB_DATA data, void *p)
{
        struct traverse_state *state = (struct traverse_state *)p;
        struct ctdb_rec_data *d = (struct ctdb_rec_data *)data.dptr;
        TDB_DATA key;

        if (data.dsize < sizeof(uint32_t) ||
            d->length != data.dsize) {
                DEBUG(DEBUG_ERR,("Bad data size %u in traverse_handler\n", (unsigned)data.dsize));
                state->done = true;
                return;
        }

        key.dsize = d->keylen;
        key.dptr  = &d->data[0];
        data.dsize = d->datalen;
        data.dptr = &d->data[d->keylen];

        if (key.dsize == 0 && data.dsize == 0) {
                /* end of traverse */
                state->done = true;
                return;
        }

        if (!state->listemptyrecords &&
            data.dsize == sizeof(struct ctdb_ltdb_header))
        {
                /* empty records are deleted records in ctdb */
                return;
        }

        if (state->fn(ctdb, key, data, state->private_data) != 0) {
                state->done = true;
        }

        state->count++;
}

/**
 * start a cluster wide traverse, calling the supplied fn on each record
 * return the number of records traversed, or -1 on error
 *
 * Extendet variant with a flag to signal whether empty records should
 * be listed.
 */
static int ctdb_traverse_ext(struct ctdb_db_context *ctdb_db,
                             ctdb_traverse_func fn,
                             bool withemptyrecords,
                             void *private_data)
{
        TDB_DATA data;
        struct ctdb_traverse_start_ext t;
        int32_t status;
        int ret;
        uint64_t srvid = (getpid() | 0xFLL<<60);
        struct traverse_state state;

        state.done = false;
        state.count = 0;
        state.private_data = private_data;
        state.fn = fn;
        state.listemptyrecords = withemptyrecords;

        ret = ctdb_client_set_message_handler(ctdb_db->ctdb, srvid, traverse_handler, &state);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,("Failed to setup traverse handler\n"));
                return -1;
        }

        t.db_id = ctdb_db->db_id;
        t.srvid = srvid;
        t.reqid = 0;
        t.withemptyrecords = withemptyrecords;

        data.dptr = (uint8_t *)&t;
        data.dsize = sizeof(t);

        ret = ctdb_control(ctdb_db->ctdb, CTDB_CURRENT_NODE, 0, CTDB_CONTROL_TRAVERSE_START_EXT, 0,
                           data, NULL, NULL, &status, NULL, NULL);
        if (ret != 0 || status != 0) {
                DEBUG(DEBUG_ERR,("ctdb_traverse_all failed\n"));
                ctdb_client_remove_message_handler(ctdb_db->ctdb, srvid, &state);
                return -1;
        }

        while (!state.done) {
                event_loop_once(ctdb_db->ctdb->ev);
        }

        ret = ctdb_client_remove_message_handler(ctdb_db->ctdb, srvid, &state);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,("Failed to remove ctdb_traverse handler\n"));
                return -1;
        }

        return state.count;
}

/**
 * start a cluster wide traverse, calling the supplied fn on each record
 * return the number of records traversed, or -1 on error
 *
 * Standard version which does not list the empty records:
 * These are considered deleted.
 */
int ctdb_traverse(struct ctdb_db_context *ctdb_db, ctdb_traverse_func fn, void *private_data)
{
        return ctdb_traverse_ext(ctdb_db, fn, false, private_data);
}

#define ISASCII(x) (isprint(x) && !strchr("\"\\", (x)))
/*
  called on each key during a catdb
 */
int ctdb_dumpdb_record(struct ctdb_context *ctdb, TDB_DATA key, TDB_DATA data, void *p)
{
        int i;
        struct ctdb_dump_db_context *c = (struct ctdb_dump_db_context *)p;
        FILE *f = c->f;
        struct ctdb_ltdb_header *h = (struct ctdb_ltdb_header *)data.dptr;

        fprintf(f, "key(%u) = \"", (unsigned)key.dsize);
        for (i=0;i<key.dsize;i++) {
                if (ISASCII(key.dptr[i])) {
                        fprintf(f, "%c", key.dptr[i]);
                } else {
                        fprintf(f, "\\%02X", key.dptr[i]);
                }
        }
        fprintf(f, "\"\n");

        fprintf(f, "dmaster: %u\n", h->dmaster);
        fprintf(f, "rsn: %llu\n", (unsigned long long)h->rsn);

        if (c->printlmaster && ctdb->vnn_map != NULL) {
                fprintf(f, "lmaster: %u\n", ctdb_lmaster(ctdb, &key));
        }

        if (c->printhash) {
                fprintf(f, "hash: 0x%08x\n", ctdb_hash(&key));
        }

        if (c->printrecordflags) {
                fprintf(f, "flags: 0x%08x", h->flags);
                if (h->flags & CTDB_REC_FLAG_MIGRATED_WITH_DATA) printf(" MIGRATED_WITH_DATA");
                if (h->flags & CTDB_REC_FLAG_VACUUM_MIGRATED) printf(" VACUUM_MIGRATED");
                if (h->flags & CTDB_REC_FLAG_AUTOMATIC) printf(" AUTOMATIC");
                if (h->flags & CTDB_REC_RO_HAVE_DELEGATIONS) printf(" RO_HAVE_DELEGATIONS");
                if (h->flags & CTDB_REC_RO_HAVE_READONLY) printf(" RO_HAVE_READONLY");
                if (h->flags & CTDB_REC_RO_REVOKING_READONLY) printf(" RO_REVOKING_READONLY");
                if (h->flags & CTDB_REC_RO_REVOKE_COMPLETE) printf(" RO_REVOKE_COMPLETE");
                fprintf(f, "\n");
        }

        if (c->printdatasize) {
                fprintf(f, "data size: %u\n", (unsigned)data.dsize);
        } else {
                fprintf(f, "data(%u) = \"", (unsigned)(data.dsize - sizeof(*h)));
                for (i=sizeof(*h);i<data.dsize;i++) {
                        if (ISASCII(data.dptr[i])) {
                                fprintf(f, "%c", data.dptr[i]);
                        } else {
                                fprintf(f, "\\%02X", data.dptr[i]);
                        }
                }
                fprintf(f, "\"\n");
        }

        fprintf(f, "\n");

        return 0;
}

/*
  convenience function to list all keys to stdout
 */
int ctdb_dump_db(struct ctdb_db_context *ctdb_db,
                 struct ctdb_dump_db_context *ctx)
{
        return ctdb_traverse_ext(ctdb_db, ctdb_dumpdb_record,
                                 ctx->printemptyrecords, ctx);
}

/*
  get the pid of a ctdb daemon
 */
int ctdb_ctrl_getpid(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t *pid)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_PID, 0, tdb_null, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getpid failed\n"));
                return -1;
        }

        *pid = res;

        return 0;
}


/*
  async freeze send control
 */
struct ctdb_client_control_state *
ctdb_ctrl_freeze_send(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode, uint32_t priority)
{
        return ctdb_control_send(ctdb, destnode, priority, 
                           CTDB_CONTROL_FREEZE, 0, tdb_null, 
                           mem_ctx, &timeout, NULL);
}

/* 
   async freeze recv control
*/
int ctdb_ctrl_freeze_recv(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct ctdb_client_control_state *state)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, mem_ctx, NULL, &res, NULL);
        if ( (ret != 0) || (res != 0) ){
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_freeze_recv failed\n"));
                return -1;
        }

        return 0;
}

/*
  freeze databases of a certain priority
 */
int ctdb_ctrl_freeze_priority(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t priority)
{
        TALLOC_CTX *tmp_ctx = talloc_new(ctdb);
        struct ctdb_client_control_state *state;
        int ret;

        state = ctdb_ctrl_freeze_send(ctdb, tmp_ctx, timeout, destnode, priority);
        ret = ctdb_ctrl_freeze_recv(ctdb, tmp_ctx, state);
        talloc_free(tmp_ctx);

        return ret;
}

/* Freeze all databases */
int ctdb_ctrl_freeze(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int i;

        for (i=1; i<=NUM_DB_PRIORITIES; i++) {
                if (ctdb_ctrl_freeze_priority(ctdb, timeout, destnode, i) != 0) {
                        return -1;
                }
        }
        return 0;
}

/*
  thaw databases of a certain priority
 */
int ctdb_ctrl_thaw_priority(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t priority)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, priority, 
                           CTDB_CONTROL_THAW, 0, tdb_null, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control thaw failed\n"));
                return -1;
        }

        return 0;
}

/* thaw all databases */
int ctdb_ctrl_thaw(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        return ctdb_ctrl_thaw_priority(ctdb, timeout, destnode, 0);
}

/*
  get pnn of a node, or -1
 */
int ctdb_ctrl_getpnn(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_PNN, 0, tdb_null, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getpnn failed\n"));
                return -1;
        }

        return res;
}

/*
  get the monitoring mode of a remote node
 */
int ctdb_ctrl_getmonmode(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t *monmode)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_MONMODE, 0, tdb_null, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getmonmode failed\n"));
                return -1;
        }

        *monmode = res;

        return 0;
}


/*
 set the monitoring mode of a remote node to active
 */
int ctdb_ctrl_enable_monmode(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int ret;
        

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_ENABLE_MONITOR, 0, tdb_null, 
                           NULL, NULL,NULL, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for enable_monitor failed\n"));
                return -1;
        }

        

        return 0;
}

/*
  set the monitoring mode of a remote node to disable
 */
int ctdb_ctrl_disable_monmode(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int ret;
        

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_DISABLE_MONITOR, 0, tdb_null, 
                           NULL, NULL, NULL, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for disable_monitor failed\n"));
                return -1;
        }

        

        return 0;
}



/* 
  sent to a node to make it take over an ip address
*/
int ctdb_ctrl_takeover_ip(struct ctdb_context *ctdb, struct timeval timeout, 
                          uint32_t destnode, struct ctdb_public_ip *ip)
{
        TDB_DATA data;
        struct ctdb_public_ipv4 ipv4;
        int ret;
        int32_t res;

        if (ip->addr.sa.sa_family == AF_INET) {
                ipv4.pnn = ip->pnn;
                ipv4.sin = ip->addr.ip;

                data.dsize = sizeof(ipv4);
                data.dptr  = (uint8_t *)&ipv4;

                ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_TAKEOVER_IPv4, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        } else {
                data.dsize = sizeof(*ip);
                data.dptr  = (uint8_t *)ip;

                ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_TAKEOVER_IP, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        }

        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for takeover_ip failed\n"));
                return -1;
        }

        return 0;       
}


/* 
  sent to a node to make it release an ip address
*/
int ctdb_ctrl_release_ip(struct ctdb_context *ctdb, struct timeval timeout, 
                         uint32_t destnode, struct ctdb_public_ip *ip)
{
        TDB_DATA data;
        struct ctdb_public_ipv4 ipv4;
        int ret;
        int32_t res;

        if (ip->addr.sa.sa_family == AF_INET) {
                ipv4.pnn = ip->pnn;
                ipv4.sin = ip->addr.ip;

                data.dsize = sizeof(ipv4);
                data.dptr  = (uint8_t *)&ipv4;

                ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_RELEASE_IPv4, 0, data, NULL,
                                   NULL, &res, &timeout, NULL);
        } else {
                data.dsize = sizeof(*ip);
                data.dptr  = (uint8_t *)ip;

                ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_RELEASE_IP, 0, data, NULL,
                                   NULL, &res, &timeout, NULL);
        }

        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for release_ip failed\n"));
                return -1;
        }

        return 0;       
}


/*
  get a tunable
 */
int ctdb_ctrl_get_tunable(struct ctdb_context *ctdb, 
                          struct timeval timeout, 
                          uint32_t destnode,
                          const char *name, uint32_t *value)
{
        struct ctdb_control_get_tunable *t;
        TDB_DATA data, outdata;
        int32_t res;
        int ret;

        data.dsize = offsetof(struct ctdb_control_get_tunable, name) + strlen(name) + 1;
        data.dptr  = talloc_size(ctdb, data.dsize);
        CTDB_NO_MEMORY(ctdb, data.dptr);

        t = (struct ctdb_control_get_tunable *)data.dptr;
        t->length = strlen(name)+1;
        memcpy(t->name, name, t->length);

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_GET_TUNABLE, 0, data, ctdb,
                           &outdata, &res, &timeout, NULL);
        talloc_free(data.dptr);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get_tunable failed\n"));
                return ret != 0 ? ret : res;
        }

        if (outdata.dsize != sizeof(uint32_t)) {
                DEBUG(DEBUG_ERR,("Invalid return data in get_tunable\n"));
                talloc_free(outdata.dptr);
                return -1;
        }
        
        *value = *(uint32_t *)outdata.dptr;
        talloc_free(outdata.dptr);

        return 0;
}

/*
  set a tunable
 */
int ctdb_ctrl_set_tunable(struct ctdb_context *ctdb, 
                          struct timeval timeout, 
                          uint32_t destnode,
                          const char *name, uint32_t value)
{
        struct ctdb_control_set_tunable *t;
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = offsetof(struct ctdb_control_set_tunable, name) + strlen(name) + 1;
        data.dptr  = talloc_size(ctdb, data.dsize);
        CTDB_NO_MEMORY(ctdb, data.dptr);

        t = (struct ctdb_control_set_tunable *)data.dptr;
        t->length = strlen(name)+1;
        memcpy(t->name, name, t->length);
        t->value = value;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_SET_TUNABLE, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        talloc_free(data.dptr);
        if ((ret != 0) || (res == -1)) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for set_tunable failed\n"));
                return -1;
        }

        return res;
}

/*
  list tunables
 */
int ctdb_ctrl_list_tunables(struct ctdb_context *ctdb, 
                            struct timeval timeout, 
                            uint32_t destnode,
                            TALLOC_CTX *mem_ctx,
                            const char ***list, uint32_t *count)
{
        TDB_DATA outdata;
        int32_t res;
        int ret;
        struct ctdb_control_list_tunable *t;
        char *p, *s, *ptr;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_LIST_TUNABLES, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for list_tunables failed\n"));
                return -1;
        }

        t = (struct ctdb_control_list_tunable *)outdata.dptr;
        if (outdata.dsize < offsetof(struct ctdb_control_list_tunable, data) ||
            t->length > outdata.dsize-offsetof(struct ctdb_control_list_tunable, data)) {
                DEBUG(DEBUG_ERR,("Invalid data in list_tunables reply\n"));
                talloc_free(outdata.dptr);
                return -1;              
        }
        
        p = talloc_strndup(mem_ctx, (char *)t->data, t->length);
        CTDB_NO_MEMORY(ctdb, p);

        talloc_free(outdata.dptr);
        
        (*list) = NULL;
        (*count) = 0;

        for (s=strtok_r(p, ":", &ptr); s; s=strtok_r(NULL, ":", &ptr)) {
                (*list) = talloc_realloc(mem_ctx, *list, const char *, 1+(*count));
                CTDB_NO_MEMORY(ctdb, *list);
                (*list)[*count] = talloc_strdup(*list, s);
                CTDB_NO_MEMORY(ctdb, (*list)[*count]);
                (*count)++;
        }

        talloc_free(p);

        return 0;
}


int ctdb_ctrl_get_public_ips_flags(struct ctdb_context *ctdb,
                                   struct timeval timeout, uint32_t destnode,
                                   TALLOC_CTX *mem_ctx,
                                   uint32_t flags,
                                   struct ctdb_all_public_ips **ips)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_PUBLIC_IPS, flags, tdb_null,
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret == 0 && res == -1) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control to get public ips failed, falling back to ipv4-only version\n"));
                return ctdb_ctrl_get_public_ipsv4(ctdb, timeout, destnode, mem_ctx, ips);
        }
        if (ret != 0 || res != 0) {
          DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getpublicips failed ret:%d res:%d\n", ret, res));
                return -1;
        }

        *ips = (struct ctdb_all_public_ips *)talloc_memdup(mem_ctx, outdata.dptr, outdata.dsize);
        talloc_free(outdata.dptr);
                    
        return 0;
}

int ctdb_ctrl_get_public_ips(struct ctdb_context *ctdb,
                             struct timeval timeout, uint32_t destnode,
                             TALLOC_CTX *mem_ctx,
                             struct ctdb_all_public_ips **ips)
{
        return ctdb_ctrl_get_public_ips_flags(ctdb, timeout,
                                              destnode, mem_ctx,
                                              0, ips);
}

int ctdb_ctrl_get_public_ipsv4(struct ctdb_context *ctdb, 
                        struct timeval timeout, uint32_t destnode, 
                        TALLOC_CTX *mem_ctx, struct ctdb_all_public_ips **ips)
{
        int ret, i, len;
        TDB_DATA outdata;
        int32_t res;
        struct ctdb_all_public_ipsv4 *ipsv4;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_PUBLIC_IPSv4, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getpublicips failed\n"));
                return -1;
        }

        ipsv4 = (struct ctdb_all_public_ipsv4 *)outdata.dptr;
        len = offsetof(struct ctdb_all_public_ips, ips) +
                ipsv4->num*sizeof(struct ctdb_public_ip);
        *ips = talloc_zero_size(mem_ctx, len);
        CTDB_NO_MEMORY(ctdb, *ips);
        (*ips)->num = ipsv4->num;
        for (i=0; i<ipsv4->num; i++) {
                (*ips)->ips[i].pnn     = ipsv4->ips[i].pnn;
                (*ips)->ips[i].addr.ip = ipsv4->ips[i].sin;
        }

        talloc_free(outdata.dptr);
                    
        return 0;
}

int ctdb_ctrl_get_public_ip_info(struct ctdb_context *ctdb,
                                 struct timeval timeout, uint32_t destnode,
                                 TALLOC_CTX *mem_ctx,
                                 const ctdb_sock_addr *addr,
                                 struct ctdb_control_public_ip_info **_info)
{
        int ret;
        TDB_DATA indata;
        TDB_DATA outdata;
        int32_t res;
        struct ctdb_control_public_ip_info *info;
        uint32_t len;
        uint32_t i;

        indata.dptr = discard_const_p(uint8_t, addr);
        indata.dsize = sizeof(*addr);

        ret = ctdb_control(ctdb, destnode, 0,
                           CTDB_CONTROL_GET_PUBLIC_IP_INFO, 0, indata,
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get public ip info "
                                "failed ret:%d res:%d\n",
                                ret, res));
                return -1;
        }

        len = offsetof(struct ctdb_control_public_ip_info, ifaces);
        if (len > outdata.dsize) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get public ip info "
                                "returned invalid data with size %u > %u\n",
                                (unsigned int)outdata.dsize,
                                (unsigned int)len));
                dump_data(DEBUG_DEBUG, outdata.dptr, outdata.dsize);
                return -1;
        }

        info = (struct ctdb_control_public_ip_info *)outdata.dptr;
        len += info->num*sizeof(struct ctdb_control_iface_info);

        if (len > outdata.dsize) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get public ip info "
                                "returned invalid data with size %u > %u\n",
                                (unsigned int)outdata.dsize,
                                (unsigned int)len));
                dump_data(DEBUG_DEBUG, outdata.dptr, outdata.dsize);
                return -1;
        }

        /* make sure we null terminate the returned strings */
        for (i=0; i < info->num; i++) {
                info->ifaces[i].name[CTDB_IFACE_SIZE] = '\0';
        }

        *_info = (struct ctdb_control_public_ip_info *)talloc_memdup(mem_ctx,
                                                                outdata.dptr,
                                                                outdata.dsize);
        talloc_free(outdata.dptr);
        if (*_info == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get public ip info "
                                "talloc_memdup size %u failed\n",
                                (unsigned int)outdata.dsize));
                return -1;
        }

        return 0;
}

int ctdb_ctrl_get_ifaces(struct ctdb_context *ctdb,
                         struct timeval timeout, uint32_t destnode,
                         TALLOC_CTX *mem_ctx,
                         struct ctdb_control_get_ifaces **_ifaces)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;
        struct ctdb_control_get_ifaces *ifaces;
        uint32_t len;
        uint32_t i;

        ret = ctdb_control(ctdb, destnode, 0,
                           CTDB_CONTROL_GET_IFACES, 0, tdb_null,
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get ifaces "
                                "failed ret:%d res:%d\n",
                                ret, res));
                return -1;
        }

        len = offsetof(struct ctdb_control_get_ifaces, ifaces);
        if (len > outdata.dsize) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get ifaces "
                                "returned invalid data with size %u > %u\n",
                                (unsigned int)outdata.dsize,
                                (unsigned int)len));
                dump_data(DEBUG_DEBUG, outdata.dptr, outdata.dsize);
                return -1;
        }

        ifaces = (struct ctdb_control_get_ifaces *)outdata.dptr;
        len += ifaces->num*sizeof(struct ctdb_control_iface_info);

        if (len > outdata.dsize) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get ifaces "
                                "returned invalid data with size %u > %u\n",
                                (unsigned int)outdata.dsize,
                                (unsigned int)len));
                dump_data(DEBUG_DEBUG, outdata.dptr, outdata.dsize);
                return -1;
        }

        /* make sure we null terminate the returned strings */
        for (i=0; i < ifaces->num; i++) {
                ifaces->ifaces[i].name[CTDB_IFACE_SIZE] = '\0';
        }

        *_ifaces = (struct ctdb_control_get_ifaces *)talloc_memdup(mem_ctx,
                                                                  outdata.dptr,
                                                                  outdata.dsize);
        talloc_free(outdata.dptr);
        if (*_ifaces == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get ifaces "
                                "talloc_memdup size %u failed\n",
                                (unsigned int)outdata.dsize));
                return -1;
        }

        return 0;
}

int ctdb_ctrl_set_iface_link(struct ctdb_context *ctdb,
                             struct timeval timeout, uint32_t destnode,
                             TALLOC_CTX *mem_ctx,
                             const struct ctdb_control_iface_info *info)
{
        int ret;
        TDB_DATA indata;
        int32_t res;

        indata.dptr = discard_const_p(uint8_t, info);
        indata.dsize = sizeof(*info);

        ret = ctdb_control(ctdb, destnode, 0,
                           CTDB_CONTROL_SET_IFACE_LINK_STATE, 0, indata,
                           mem_ctx, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for set iface link "
                                "failed ret:%d res:%d\n",
                                ret, res));
                return -1;
        }

        return 0;
}

/*
  set/clear the permanent disabled bit on a remote node
 */
int ctdb_ctrl_modflags(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, 
                       uint32_t set, uint32_t clear)
{
        int ret;
        TDB_DATA data;
        struct ctdb_node_map *nodemap=NULL;
        struct ctdb_node_flag_change c;
        TALLOC_CTX *tmp_ctx = talloc_new(ctdb);
        uint32_t recmaster;
        uint32_t *nodes;


        /* find the recovery master */
        ret = ctdb_ctrl_getrecmaster(ctdb, tmp_ctx, timeout, CTDB_CURRENT_NODE, &recmaster);
        if (ret != 0) {
                DEBUG(DEBUG_ERR, (__location__ " Unable to get recmaster from local node\n"));
                talloc_free(tmp_ctx);
                return ret;
        }


        /* read the node flags from the recmaster */
        ret = ctdb_ctrl_getnodemap(ctdb, timeout, recmaster, tmp_ctx, &nodemap);
        if (ret != 0) {
                DEBUG(DEBUG_ERR, (__location__ " Unable to get nodemap from node %u\n", destnode));
                talloc_free(tmp_ctx);
                return -1;
        }
        if (destnode >= nodemap->num) {
                DEBUG(DEBUG_ERR,(__location__ " Nodemap from recmaster does not contain node %d\n", destnode));
                talloc_free(tmp_ctx);
                return -1;
        }

        c.pnn       = destnode;
        c.old_flags = nodemap->nodes[destnode].flags;
        c.new_flags = c.old_flags;
        c.new_flags |= set;
        c.new_flags &= ~clear;

        data.dsize = sizeof(c);
        data.dptr = (unsigned char *)&c;

        /* send the flags update to all connected nodes */
        nodes = list_of_connected_nodes(ctdb, nodemap, tmp_ctx, true);

        if (ctdb_client_async_control(ctdb, CTDB_CONTROL_MODIFY_FLAGS,
                                        nodes, 0,
                                        timeout, false, data,
                                        NULL, NULL,
                                        NULL) != 0) {
                DEBUG(DEBUG_ERR, (__location__ " Unable to update nodeflags on remote nodes\n"));

                talloc_free(tmp_ctx);
                return -1;
        }

        talloc_free(tmp_ctx);
        return 0;
}


/*
  get all tunables
 */
int ctdb_ctrl_get_all_tunables(struct ctdb_context *ctdb, 
                               struct timeval timeout, 
                               uint32_t destnode,
                               struct ctdb_tunable *tunables)
{
        TDB_DATA outdata;
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_GET_ALL_TUNABLES, 0, tdb_null, ctdb,
                           &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get all tunables failed\n"));
                return -1;
        }

        if (outdata.dsize != sizeof(*tunables)) {
                DEBUG(DEBUG_ERR,(__location__ " bad data size %u in ctdb_ctrl_get_all_tunables should be %u\n",
                         (unsigned)outdata.dsize, (unsigned)sizeof(*tunables)));
                return -1;              
        }

        *tunables = *(struct ctdb_tunable *)outdata.dptr;
        talloc_free(outdata.dptr);
        return 0;
}

/*
  add a public address to a node
 */
int ctdb_ctrl_add_public_ip(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      uint32_t destnode,
                      struct ctdb_control_ip_iface *pub)
{
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = offsetof(struct ctdb_control_ip_iface, iface) + pub->len;
        data.dptr  = (unsigned char *)pub;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_ADD_PUBLIC_IP, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for add_public_ip failed\n"));
                return -1;
        }

        return 0;
}

/*
  delete a public address from a node
 */
int ctdb_ctrl_del_public_ip(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      uint32_t destnode,
                      struct ctdb_control_ip_iface *pub)
{
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = offsetof(struct ctdb_control_ip_iface, iface) + pub->len;
        data.dptr  = (unsigned char *)pub;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_DEL_PUBLIC_IP, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for del_public_ip failed\n"));
                return -1;
        }

        return 0;
}

/*
  kill a tcp connection
 */
int ctdb_ctrl_killtcp(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      uint32_t destnode,
                      struct ctdb_control_killtcp *killtcp)
{
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = sizeof(struct ctdb_control_killtcp);
        data.dptr  = (unsigned char *)killtcp;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_KILL_TCP, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for killtcp failed\n"));
                return -1;
        }

        return 0;
}

/*
  send a gratious arp
 */
int ctdb_ctrl_gratious_arp(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      uint32_t destnode,
                      ctdb_sock_addr *addr,
                      const char *ifname)
{
        TDB_DATA data;
        int32_t res;
        int ret, len;
        struct ctdb_control_gratious_arp *gratious_arp;
        TALLOC_CTX *tmp_ctx = talloc_new(ctdb);


        len = strlen(ifname)+1;
        gratious_arp = talloc_size(tmp_ctx, 
                offsetof(struct ctdb_control_gratious_arp, iface) + len);
        CTDB_NO_MEMORY(ctdb, gratious_arp);

        gratious_arp->addr = *addr;
        gratious_arp->len = len;
        memcpy(&gratious_arp->iface[0], ifname, len);


        data.dsize = offsetof(struct ctdb_control_gratious_arp, iface) + len;
        data.dptr  = (unsigned char *)gratious_arp;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_SEND_GRATIOUS_ARP, 0, data, NULL,
                           NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for gratious_arp failed\n"));
                talloc_free(tmp_ctx);
                return -1;
        }

        talloc_free(tmp_ctx);
        return 0;
}

/*
  get a list of all tcp tickles that a node knows about for a particular vnn
 */
int ctdb_ctrl_get_tcp_tickles(struct ctdb_context *ctdb, 
                              struct timeval timeout, uint32_t destnode, 
                              TALLOC_CTX *mem_ctx, 
                              ctdb_sock_addr *addr,
                              struct ctdb_control_tcp_tickle_list **list)
{
        int ret;
        TDB_DATA data, outdata;
        int32_t status;

        data.dptr = (uint8_t*)addr;
        data.dsize = sizeof(ctdb_sock_addr);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_TCP_TICKLE_LIST, 0, data, 
                           mem_ctx, &outdata, &status, NULL, NULL);
        if (ret != 0 || status != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get tcp tickles failed\n"));
                return -1;
        }

        *list = (struct ctdb_control_tcp_tickle_list *)outdata.dptr;

        return status;
}

/*
  register a server id
 */
int ctdb_ctrl_register_server_id(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      struct ctdb_server_id *id)
{
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = sizeof(struct ctdb_server_id);
        data.dptr  = (unsigned char *)id;

        ret = ctdb_control(ctdb, CTDB_CURRENT_NODE, 0, 
                        CTDB_CONTROL_REGISTER_SERVER_ID, 
                        0, data, NULL,
                        NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for register server id failed\n"));
                return -1;
        }

        return 0;
}

/*
  unregister a server id
 */
int ctdb_ctrl_unregister_server_id(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      struct ctdb_server_id *id)
{
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = sizeof(struct ctdb_server_id);
        data.dptr  = (unsigned char *)id;

        ret = ctdb_control(ctdb, CTDB_CURRENT_NODE, 0, 
                        CTDB_CONTROL_UNREGISTER_SERVER_ID, 
                        0, data, NULL,
                        NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for unregister server id failed\n"));
                return -1;
        }

        return 0;
}


/*
  check if a server id exists

  if a server id does exist, return *status == 1, otherwise *status == 0
 */
int ctdb_ctrl_check_server_id(struct ctdb_context *ctdb, 
                      struct timeval timeout, 
                      uint32_t destnode,
                      struct ctdb_server_id *id,
                      uint32_t *status)
{
        TDB_DATA data;
        int32_t res;
        int ret;

        data.dsize = sizeof(struct ctdb_server_id);
        data.dptr  = (unsigned char *)id;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_CHECK_SERVER_ID, 
                        0, data, NULL,
                        NULL, &res, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for check server id failed\n"));
                return -1;
        }

        if (res) {
                *status = 1;
        } else {
                *status = 0;
        }

        return 0;
}

/*
   get the list of server ids that are registered on a node
*/
int ctdb_ctrl_get_server_id_list(struct ctdb_context *ctdb,
                TALLOC_CTX *mem_ctx,
                struct timeval timeout, uint32_t destnode, 
                struct ctdb_server_id_list **svid_list)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_SERVER_ID_LIST, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get_server_id_list failed\n"));
                return -1;
        }

        *svid_list = (struct ctdb_server_id_list *)talloc_steal(mem_ctx, outdata.dptr);
                    
        return 0;
}

/*
  initialise the ctdb daemon for client applications

  NOTE: In current code the daemon does not fork. This is for testing purposes only
  and to simplify the code.
*/
struct ctdb_context *ctdb_init(struct event_context *ev)
{
        int ret;
        struct ctdb_context *ctdb;

        ctdb = talloc_zero(ev, struct ctdb_context);
        if (ctdb == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " talloc_zero failed.\n"));
                return NULL;
        }
        ctdb->ev  = ev;
        ctdb->idr = idr_init(ctdb);
        /* Wrap early to exercise code. */
        ctdb->lastid = INT_MAX-200;
        CTDB_NO_MEMORY_NULL(ctdb, ctdb->idr);

        ret = ctdb_set_socketname(ctdb, CTDB_SOCKET);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_set_socketname failed.\n"));
                talloc_free(ctdb);
                return NULL;
        }

        ctdb->statistics.statistics_start_time = timeval_current();

        return ctdb;
}


/*
  set some ctdb flags
*/
void ctdb_set_flags(struct ctdb_context *ctdb, unsigned flags)
{
        ctdb->flags |= flags;
}

/*
  setup the local socket name
*/
int ctdb_set_socketname(struct ctdb_context *ctdb, const char *socketname)
{
        ctdb->daemon.name = talloc_strdup(ctdb, socketname);
        CTDB_NO_MEMORY(ctdb, ctdb->daemon.name);

        return 0;
}

const char *ctdb_get_socketname(struct ctdb_context *ctdb)
{
        return ctdb->daemon.name;
}

/*
  return the pnn of this node
*/
uint32_t ctdb_get_pnn(struct ctdb_context *ctdb)
{
        return ctdb->pnn;
}


/*
  get the uptime of a remote node
 */
struct ctdb_client_control_state *
ctdb_ctrl_uptime_send(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode)
{
        return ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_UPTIME, 0, tdb_null, 
                           mem_ctx, &timeout, NULL);
}

int ctdb_ctrl_uptime_recv(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct ctdb_client_control_state *state, struct ctdb_uptime **uptime)
{
        int ret;
        int32_t res;
        TDB_DATA outdata;

        ret = ctdb_control_recv(ctdb, state, mem_ctx, &outdata, &res, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_uptime_recv failed\n"));
                return -1;
        }

        *uptime = (struct ctdb_uptime *)talloc_steal(mem_ctx, outdata.dptr);

        return 0;
}

int ctdb_ctrl_uptime(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode, struct ctdb_uptime **uptime)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_uptime_send(ctdb, mem_ctx, timeout, destnode);
        return ctdb_ctrl_uptime_recv(ctdb, mem_ctx, state, uptime);
}

/*
  send a control to execute the "recovered" event script on a node
 */
int ctdb_ctrl_end_recovery(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int ret;
        int32_t status;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_END_RECOVERY, 0, tdb_null, 
                           NULL, NULL, &status, &timeout, NULL);
        if (ret != 0 || status != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for end_recovery failed\n"));
                return -1;
        }

        return 0;
}

/* 
  callback for the async helpers used when sending the same control
  to multiple nodes in parallell.
*/
static void async_callback(struct ctdb_client_control_state *state)
{
        struct client_async_data *data = talloc_get_type(state->async.private_data, struct client_async_data);
        struct ctdb_context *ctdb = talloc_get_type(state->ctdb, struct ctdb_context);
        int ret;
        TDB_DATA outdata;
        int32_t res = -1;
        uint32_t destnode = state->c->hdr.destnode;

        outdata.dsize = 0;
        outdata.dptr = NULL;

        /* one more node has responded with recmode data */
        data->count--;

        /* if we failed to push the db, then return an error and let
           the main loop try again.
        */
        if (state->state != CTDB_CONTROL_DONE) {
                if ( !data->dont_log_errors) {
                        DEBUG(DEBUG_ERR,("Async operation failed with state %d, opcode:%u\n", state->state, data->opcode));
                }
                data->fail_count++;
                if (state->state == CTDB_CONTROL_TIMEOUT) {
                        res = -ETIME;
                } else {
                        res = -1;
                }
                if (data->fail_callback) {
                        data->fail_callback(ctdb, destnode, res, outdata,
                                        data->callback_data);
                }
                return;
        }
        
        state->async.fn = NULL;

        ret = ctdb_control_recv(ctdb, state, data, &outdata, &res, NULL);
        if ((ret != 0) || (res != 0)) {
                if ( !data->dont_log_errors) {
                        DEBUG(DEBUG_ERR,("Async operation failed with ret=%d res=%d opcode=%u\n", ret, (int)res, data->opcode));
                }
                data->fail_count++;
                if (data->fail_callback) {
                        data->fail_callback(ctdb, destnode, res, outdata,
                                        data->callback_data);
                }
        }
        if ((ret == 0) && (data->callback != NULL)) {
                data->callback(ctdb, destnode, res, outdata,
                                        data->callback_data);
        }
}


void ctdb_client_async_add(struct client_async_data *data, struct ctdb_client_control_state *state)
{
        /* set up the callback functions */
        state->async.fn = async_callback;
        state->async.private_data = data;
        
        /* one more control to wait for to complete */
        data->count++;
}


/* wait for up to the maximum number of seconds allowed
   or until all nodes we expect a response from has replied
*/
int ctdb_client_async_wait(struct ctdb_context *ctdb, struct client_async_data *data)
{
        while (data->count > 0) {
                event_loop_once(ctdb->ev);
        }
        if (data->fail_count != 0) {
                if (!data->dont_log_errors) {
                        DEBUG(DEBUG_ERR,("Async wait failed - fail_count=%u\n", 
                                 data->fail_count));
                }
                return -1;
        }
        return 0;
}


/* 
   perform a simple control on the listed nodes
   The control cannot return data
 */
int ctdb_client_async_control(struct ctdb_context *ctdb,
                                enum ctdb_controls opcode,
                                uint32_t *nodes,
                                uint64_t srvid,
                                struct timeval timeout,
                                bool dont_log_errors,
                                TDB_DATA data,
                                client_async_callback client_callback,
                                client_async_callback fail_callback,
                                void *callback_data)
{
        struct client_async_data *async_data;
        struct ctdb_client_control_state *state;
        int j, num_nodes;

        async_data = talloc_zero(ctdb, struct client_async_data);
        CTDB_NO_MEMORY_FATAL(ctdb, async_data);
        async_data->dont_log_errors = dont_log_errors;
        async_data->callback = client_callback;
        async_data->fail_callback = fail_callback;
        async_data->callback_data = callback_data;
        async_data->opcode        = opcode;

        num_nodes = talloc_get_size(nodes) / sizeof(uint32_t);

        /* loop over all nodes and send an async control to each of them */
        for (j=0; j<num_nodes; j++) {
                uint32_t pnn = nodes[j];

                state = ctdb_control_send(ctdb, pnn, srvid, opcode, 
                                          0, data, async_data, &timeout, NULL);
                if (state == NULL) {
                        DEBUG(DEBUG_ERR,(__location__ " Failed to call async control %u\n", (unsigned)opcode));
                        talloc_free(async_data);
                        return -1;
                }
                
                ctdb_client_async_add(async_data, state);
        }

        if (ctdb_client_async_wait(ctdb, async_data) != 0) {
                talloc_free(async_data);
                return -1;
        }

        talloc_free(async_data);
        return 0;
}

uint32_t *list_of_vnnmap_nodes(struct ctdb_context *ctdb,
                                struct ctdb_vnn_map *vnn_map,
                                TALLOC_CTX *mem_ctx,
                                bool include_self)
{
        int i, j, num_nodes;
        uint32_t *nodes;

        for (i=num_nodes=0;i<vnn_map->size;i++) {
                if (vnn_map->map[i] == ctdb->pnn && !include_self) {
                        continue;
                }
                num_nodes++;
        } 

        nodes = talloc_array(mem_ctx, uint32_t, num_nodes);
        CTDB_NO_MEMORY_FATAL(ctdb, nodes);

        for (i=j=0;i<vnn_map->size;i++) {
                if (vnn_map->map[i] == ctdb->pnn && !include_self) {
                        continue;
                }
                nodes[j++] = vnn_map->map[i];
        } 

        return nodes;
}

/* Get list of nodes not including those with flags specified by mask.
 * If exclude_pnn is not -1 then exclude that pnn from the list.
 */
uint32_t *list_of_nodes(struct ctdb_context *ctdb,
                        struct ctdb_node_map *node_map,
                        TALLOC_CTX *mem_ctx,
                        uint32_t mask,
                        int exclude_pnn)
{
        int i, j, num_nodes;
        uint32_t *nodes;

        for (i=num_nodes=0;i<node_map->num;i++) {
                if (node_map->nodes[i].flags & mask) {
                        continue;
                }
                if (node_map->nodes[i].pnn == exclude_pnn) {
                        continue;
                }
                num_nodes++;
        } 

        nodes = talloc_array(mem_ctx, uint32_t, num_nodes);
        CTDB_NO_MEMORY_FATAL(ctdb, nodes);

        for (i=j=0;i<node_map->num;i++) {
                if (node_map->nodes[i].flags & mask) {
                        continue;
                }
                if (node_map->nodes[i].pnn == exclude_pnn) {
                        continue;
                }
                nodes[j++] = node_map->nodes[i].pnn;
        } 

        return nodes;
}

uint32_t *list_of_active_nodes(struct ctdb_context *ctdb,
                                struct ctdb_node_map *node_map,
                                TALLOC_CTX *mem_ctx,
                                bool include_self)
{
        return list_of_nodes(ctdb, node_map, mem_ctx, NODE_FLAGS_INACTIVE,
                             include_self ? -1 : ctdb->pnn);
}

uint32_t *list_of_connected_nodes(struct ctdb_context *ctdb,
                                struct ctdb_node_map *node_map,
                                TALLOC_CTX *mem_ctx,
                                bool include_self)
{
        return list_of_nodes(ctdb, node_map, mem_ctx, NODE_FLAGS_DISCONNECTED,
                             include_self ? -1 : ctdb->pnn);
}

/* 
  this is used to test if a pnn lock exists and if it exists will return
  the number of connections that pnn has reported or -1 if that recovery
  daemon is not running.
*/
int
ctdb_read_pnn_lock(int fd, int32_t pnn)
{
        struct flock lock;
        char c;

        lock.l_type = F_WRLCK;
        lock.l_whence = SEEK_SET;
        lock.l_start = pnn;
        lock.l_len = 1;
        lock.l_pid = 0;

        if (fcntl(fd, F_GETLK, &lock) != 0) {
                DEBUG(DEBUG_ERR, (__location__ " F_GETLK failed with %s\n", strerror(errno)));
                return -1;
        }

        if (lock.l_type == F_UNLCK) {
                return -1;
        }

        if (pread(fd, &c, 1, pnn) == -1) {
                DEBUG(DEBUG_CRIT,(__location__ " failed read pnn count - %s\n", strerror(errno)));
                return -1;
        }

        return c;
}

/*
  get capabilities of a remote node
 */
struct ctdb_client_control_state *
ctdb_ctrl_getcapabilities_send(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode)
{
        return ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_CAPABILITIES, 0, tdb_null, 
                           mem_ctx, &timeout, NULL);
}

int ctdb_ctrl_getcapabilities_recv(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct ctdb_client_control_state *state, uint32_t *capabilities)
{
        int ret;
        int32_t res;
        TDB_DATA outdata;

        ret = ctdb_control_recv(ctdb, state, mem_ctx, &outdata, &res, NULL);
        if ( (ret != 0) || (res != 0) ) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_getcapabilities_recv failed\n"));
                return -1;
        }

        if (capabilities) {
                *capabilities = *((uint32_t *)outdata.dptr);
        }

        return 0;
}

int ctdb_ctrl_getcapabilities(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t *capabilities)
{
        struct ctdb_client_control_state *state;
        TALLOC_CTX *tmp_ctx = talloc_new(NULL);
        int ret;

        state = ctdb_ctrl_getcapabilities_send(ctdb, tmp_ctx, timeout, destnode);
        ret = ctdb_ctrl_getcapabilities_recv(ctdb, tmp_ctx, state, capabilities);
        talloc_free(tmp_ctx);
        return ret;
}

struct server_id {
        uint64_t pid;
        uint32_t task_id;
        uint32_t vnn;
        uint64_t unique_id;
};

static struct server_id server_id_fetch(struct ctdb_context *ctdb, uint32_t reqid)
{
        struct server_id id;

        id.pid = getpid();
        id.task_id = reqid;
        id.vnn = ctdb_get_pnn(ctdb);
        id.unique_id = id.vnn;
        id.unique_id = (id.unique_id << 32) | reqid;

        return id;
}

/* This is basically a copy from Samba's server_id.*.  However, a
 * dependency chain stops us from using Samba's version, so use a
 * renamed copy until a better solution is found. */
static bool ctdb_server_id_equal(struct server_id *id1, struct server_id *id2)
{
        if (id1->pid != id2->pid) {
                return false;
        }

        if (id1->task_id != id2->task_id) {
                return false;
        }

        if (id1->vnn != id2->vnn) {
                return false;
        }

        if (id1->unique_id != id2->unique_id) {
                return false;
        }

        return true;
}

static bool server_id_exists(struct ctdb_context *ctdb, struct server_id *id)
{
        struct ctdb_server_id sid;
        int ret;
        uint32_t result;

        sid.type = SERVER_TYPE_SAMBA;
        sid.pnn = id->vnn;
        sid.server_id = id->pid;

        ret = ctdb_ctrl_check_server_id(ctdb, timeval_current_ofs(3,0),
                                        id->vnn, &sid, &result);
        if (ret != 0) {
                /* If control times out, assume server_id exists. */
                return true;
        }

        if (result) {
                return true;
        }

        return false;
}


enum g_lock_type {
        G_LOCK_READ = 0,
        G_LOCK_WRITE = 1,
};

struct g_lock_rec {
        enum g_lock_type type;
        struct server_id id;
};

struct g_lock_recs {
        unsigned int num;
        struct g_lock_rec *lock;
};

static bool g_lock_parse(TALLOC_CTX *mem_ctx, TDB_DATA data,
                         struct g_lock_recs **locks)
{
        struct g_lock_recs *recs;

        recs = talloc_zero(mem_ctx, struct g_lock_recs);
        if (recs == NULL) {
                return false;
        }

        if (data.dsize == 0) {
                goto done;
        }

        if (data.dsize % sizeof(struct g_lock_rec) != 0) {
                DEBUG(DEBUG_ERR, (__location__ "invalid data size %lu in g_lock record\n",
                                  (unsigned long)data.dsize));
                talloc_free(recs);
                return false;
        }

        recs->num = data.dsize / sizeof(struct g_lock_rec);
        recs->lock = talloc_memdup(mem_ctx, data.dptr, data.dsize);
        if (recs->lock == NULL) {
                talloc_free(recs);
                return false;
        }

done:
        if (locks != NULL) {
                *locks = recs;
        }

        return true;
}


static bool g_lock_lock(TALLOC_CTX *mem_ctx,
                        struct ctdb_db_context *ctdb_db,
                        const char *keyname, uint32_t reqid)
{
        TDB_DATA key, data;
        struct ctdb_record_handle *h;
        struct g_lock_recs *locks;
        struct server_id id;
        struct timeval t_start;
        int i;

        key.dptr = (uint8_t *)discard_const(keyname);
        key.dsize = strlen(keyname) + 1;

        t_start = timeval_current();

again:
        /* Keep trying for an hour. */
        if (timeval_elapsed(&t_start) > 3600) {
                return false;
        }

        h = ctdb_fetch_lock(ctdb_db, mem_ctx, key, &data);
        if (h == NULL) {
                return false;
        }

        if (!g_lock_parse(h, data, &locks)) {
                DEBUG(DEBUG_ERR, ("g_lock: error parsing locks\n"));
                talloc_free(data.dptr);
                talloc_free(h);
                return false;
        }

        talloc_free(data.dptr);

        id = server_id_fetch(ctdb_db->ctdb, reqid);

        i = 0;
        while (i < locks->num) {
                if (ctdb_server_id_equal(&locks->lock[i].id, &id)) {
                        /* Internal error */
                        talloc_free(h);
                        return false;
                }

                if (!server_id_exists(ctdb_db->ctdb, &locks->lock[i].id)) {
                        if (i < locks->num-1) {
                                locks->lock[i] = locks->lock[locks->num-1];
                        }
                        locks->num--;
                        continue;
                }

                /* This entry is locked. */
                DEBUG(DEBUG_INFO, ("g_lock: lock already granted for "
                                   "pid=0x%llx taskid=%x vnn=%d id=0x%llx\n",
                                   (unsigned long long)id.pid,
                                   id.task_id, id.vnn,
                                   (unsigned long long)id.unique_id));
                talloc_free(h);
                goto again;
        }

        locks->lock = talloc_realloc(locks, locks->lock, struct g_lock_rec,
                                     locks->num+1);
        if (locks->lock == NULL) {
                talloc_free(h);
                return false;
        }

        locks->lock[locks->num].type = G_LOCK_WRITE;
        locks->lock[locks->num].id = id;
        locks->num++;

        data.dptr = (uint8_t *)locks->lock;
        data.dsize = locks->num * sizeof(struct g_lock_rec);

        if (ctdb_record_store(h, data) != 0) {
                DEBUG(DEBUG_ERR, ("g_lock: failed to write transaction lock for "
                                  "pid=0x%llx taskid=%x vnn=%d id=0x%llx\n",
                                  (unsigned long long)id.pid,
                                  id.task_id, id.vnn,
                                  (unsigned long long)id.unique_id));
                talloc_free(h);
                return false;
        }

        DEBUG(DEBUG_INFO, ("g_lock: lock granted for "
                           "pid=0x%llx taskid=%x vnn=%d id=0x%llx\n",
                           (unsigned long long)id.pid,
                           id.task_id, id.vnn,
                           (unsigned long long)id.unique_id));

        talloc_free(h);
        return true;
}

static bool g_lock_unlock(TALLOC_CTX *mem_ctx,
                          struct ctdb_db_context *ctdb_db,
                          const char *keyname, uint32_t reqid)
{
        TDB_DATA key, data;
        struct ctdb_record_handle *h;
        struct g_lock_recs *locks;
        struct server_id id;
        int i;
        bool found = false;

        key.dptr = (uint8_t *)discard_const(keyname);
        key.dsize = strlen(keyname) + 1;
        h = ctdb_fetch_lock(ctdb_db, mem_ctx, key, &data);
        if (h == NULL) {
                return false;
        }

        if (!g_lock_parse(h, data, &locks)) {
                DEBUG(DEBUG_ERR, ("g_lock: error parsing locks\n"));
                talloc_free(data.dptr);
                talloc_free(h);
                return false;
        }

        talloc_free(data.dptr);

        id = server_id_fetch(ctdb_db->ctdb, reqid);

        for (i=0; i<locks->num; i++) {
                if (ctdb_server_id_equal(&locks->lock[i].id, &id)) {
                        if (i < locks->num-1) {
                                locks->lock[i] = locks->lock[locks->num-1];
                        }
                        locks->num--;
                        found = true;
                        break;
                }
        }

        if (!found) {
                DEBUG(DEBUG_ERR, ("g_lock: lock not found\n"));
                talloc_free(h);
                return false;
        }

        data.dptr = (uint8_t *)locks->lock;
        data.dsize = locks->num * sizeof(struct g_lock_rec);

        if (ctdb_record_store(h, data) != 0) {
                talloc_free(h);
                return false;
        }

        talloc_free(h);
        return true;
}


struct ctdb_transaction_handle {
        struct ctdb_db_context *ctdb_db;
        struct ctdb_db_context *g_lock_db;
        char *lock_name;
        uint32_t reqid;
        /*
         * we store reads and writes done under a transaction:
         * - one list stores both reads and writes (m_all)
         * - the other just writes (m_write)
         */
        struct ctdb_marshall_buffer *m_all;
        struct ctdb_marshall_buffer *m_write;
};

static int ctdb_transaction_destructor(struct ctdb_transaction_handle *h)
{
        g_lock_unlock(h, h->g_lock_db, h->lock_name, h->reqid);
        ctdb_reqid_remove(h->ctdb_db->ctdb, h->reqid);
        return 0;
}


/**
 * start a transaction on a database
 */
struct ctdb_transaction_handle *ctdb_transaction_start(struct ctdb_db_context *ctdb_db,
                                                       TALLOC_CTX *mem_ctx)
{
        struct ctdb_transaction_handle *h;
        struct ctdb_server_id id;

        h = talloc_zero(mem_ctx, struct ctdb_transaction_handle);
        if (h == NULL) {
                DEBUG(DEBUG_ERR, (__location__ " memory allocation error\n"));
                return NULL;
        }

        h->ctdb_db = ctdb_db;
        h->lock_name = talloc_asprintf(h, "transaction_db_0x%08x",
                                       (unsigned int)ctdb_db->db_id);
        if (h->lock_name == NULL) {
                DEBUG(DEBUG_ERR, (__location__ " talloc asprintf failed\n"));
                talloc_free(h);
                return NULL;
        }

        h->g_lock_db = ctdb_attach(h->ctdb_db->ctdb, timeval_current_ofs(3,0),
                                   "g_lock.tdb", false, 0);
        if (!h->g_lock_db) {
                DEBUG(DEBUG_ERR, (__location__ " unable to attach to g_lock.tdb\n"));
                talloc_free(h);
                return NULL;
        }

        id.type = SERVER_TYPE_SAMBA;
        id.pnn = ctdb_get_pnn(ctdb_db->ctdb);
        id.server_id = getpid();

        if (ctdb_ctrl_register_server_id(ctdb_db->ctdb, timeval_current_ofs(3,0),
                                         &id) != 0) {
                DEBUG(DEBUG_ERR, (__location__ " unable to register server id\n"));
                talloc_free(h);
                return NULL;
        }

        h->reqid = ctdb_reqid_new(h->ctdb_db->ctdb, h);

        if (!g_lock_lock(h, h->g_lock_db, h->lock_name, h->reqid)) {
                DEBUG(DEBUG_ERR, (__location__ " Error locking g_lock.tdb\n"));
                talloc_free(h);
                return NULL;
        }

        talloc_set_destructor(h, ctdb_transaction_destructor);
        return h;
}

/**
 * fetch a record inside a transaction
 */
int ctdb_transaction_fetch(struct ctdb_transaction_handle *h,
                           TALLOC_CTX *mem_ctx,
                           TDB_DATA key, TDB_DATA *data)
{
        struct ctdb_ltdb_header header;
        int ret;

        ZERO_STRUCT(header);

        ret = ctdb_ltdb_fetch(h->ctdb_db, key, &header, mem_ctx, data);
        if (ret == -1 && header.dmaster == (uint32_t)-1) {
                /* record doesn't exist yet */
                *data = tdb_null;
                ret = 0;
        }

        if (ret != 0) {
                return ret;
        }

        h->m_all = ctdb_marshall_add(h, h->m_all, h->ctdb_db->db_id, 1, key, NULL, *data);
        if (h->m_all == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " Failed to add to marshalling record\n"));
                return -1;
        }

        return 0;
}

/**
 * stores a record inside a transaction
 */
int ctdb_transaction_store(struct ctdb_transaction_handle *h,
                           TDB_DATA key, TDB_DATA data)
{
        TALLOC_CTX *tmp_ctx = talloc_new(h);
        struct ctdb_ltdb_header header;
        TDB_DATA olddata;
        int ret;

        /* we need the header so we can update the RSN */
        ret = ctdb_ltdb_fetch(h->ctdb_db, key, &header, tmp_ctx, &olddata);
        if (ret == -1 && header.dmaster == (uint32_t)-1) {
                /* the record doesn't exist - create one with us as dmaster.
                   This is only safe because we are in a transaction and this
                   is a persistent database */
                ZERO_STRUCT(header);
        } else if (ret != 0) {
                DEBUG(DEBUG_ERR,(__location__ " Failed to fetch record\n"));
                talloc_free(tmp_ctx);
                return ret;
        }

        if (data.dsize == olddata.dsize &&
            memcmp(data.dptr, olddata.dptr, data.dsize) == 0 &&
            header.rsn != 0) {
                /* save writing the same data */
                talloc_free(tmp_ctx);
                return 0;
        }

        header.dmaster = h->ctdb_db->ctdb->pnn;
        header.rsn++;

        h->m_all = ctdb_marshall_add(h, h->m_all, h->ctdb_db->db_id, 0, key, NULL, data);
        if (h->m_all == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " Failed to add to marshalling record\n"));
                talloc_free(tmp_ctx);
                return -1;
        }

        h->m_write = ctdb_marshall_add(h, h->m_write, h->ctdb_db->db_id, 0, key, &header, data);
        if (h->m_write == NULL) {
                DEBUG(DEBUG_ERR,(__location__ " Failed to add to marshalling record\n"));
                talloc_free(tmp_ctx);
                return -1;
        }

        talloc_free(tmp_ctx);
        return 0;
}

static int ctdb_fetch_db_seqnum(struct ctdb_db_context *ctdb_db, uint64_t *seqnum)
{
        const char *keyname = CTDB_DB_SEQNUM_KEY;
        TDB_DATA key, data;
        struct ctdb_ltdb_header header;
        int ret;

        key.dptr = (uint8_t *)discard_const(keyname);
        key.dsize = strlen(keyname) + 1;

        ret = ctdb_ltdb_fetch(ctdb_db, key, &header, ctdb_db, &data);
        if (ret != 0) {
                *seqnum = 0;
                return 0;
        }

        if (data.dsize == 0) {
                *seqnum = 0;
                return 0;
        }

        if (data.dsize != sizeof(*seqnum)) {
                DEBUG(DEBUG_ERR, (__location__ " Invalid data recived len=%zi\n",
                                  data.dsize));
                talloc_free(data.dptr);
                return -1;
        }

        *seqnum = *(uint64_t *)data.dptr;
        talloc_free(data.dptr);

        return 0;
}


static int ctdb_store_db_seqnum(struct ctdb_transaction_handle *h,
                                uint64_t seqnum)
{
        const char *keyname = CTDB_DB_SEQNUM_KEY;
        TDB_DATA key, data;

        key.dptr = (uint8_t *)discard_const(keyname);
        key.dsize = strlen(keyname) + 1;

        data.dptr = (uint8_t *)&seqnum;
        data.dsize = sizeof(seqnum);

        return ctdb_transaction_store(h, key, data);
}


/**
 * commit a transaction
 */
int ctdb_transaction_commit(struct ctdb_transaction_handle *h)
{
        int ret;
        uint64_t old_seqnum, new_seqnum;
        int32_t status;
        struct timeval timeout;

        if (h->m_write == NULL) {
                /* no changes were made */
                talloc_free(h);
                return 0;
        }

        ret = ctdb_fetch_db_seqnum(h->ctdb_db, &old_seqnum);
        if (ret != 0) {
                DEBUG(DEBUG_ERR, (__location__ " failed to fetch db sequence number\n"));
                ret = -1;
                goto done;
        }

        new_seqnum = old_seqnum + 1;
        ret = ctdb_store_db_seqnum(h, new_seqnum);
        if (ret != 0) {
                DEBUG(DEBUG_ERR, (__location__ " failed to store db sequence number\n"));
                ret = -1;
                goto done;
        }

again:
        timeout = timeval_current_ofs(3,0);
        ret = ctdb_control(h->ctdb_db->ctdb, CTDB_CURRENT_NODE,
                           h->ctdb_db->db_id,
                           CTDB_CONTROL_TRANS3_COMMIT, 0,
                           ctdb_marshall_finish(h->m_write), NULL, NULL,
                           &status, &timeout, NULL);
        if (ret != 0 || status != 0) {
                /*
                 * TRANS3_COMMIT control will only fail if recovery has been
                 * triggered.  Check if the database has been updated or not.
                 */
                ret = ctdb_fetch_db_seqnum(h->ctdb_db, &new_seqnum);
                if (ret != 0) {
                        DEBUG(DEBUG_ERR, (__location__ " failed to fetch db sequence number\n"));
                        goto done;
                }

                if (new_seqnum == old_seqnum) {
                        /* Database not yet updated, try again */
                        goto again;
                }

                if (new_seqnum != (old_seqnum + 1)) {
                        DEBUG(DEBUG_ERR, (__location__ " new seqnum [%llu] != old seqnum [%llu] + 1\n",
                                          (long long unsigned)new_seqnum,
                                          (long long unsigned)old_seqnum));
                        ret = -1;
                        goto done;
                }
        }

        ret = 0;

done:
        talloc_free(h);
        return ret;
}

/**
 * cancel a transaction
 */
int ctdb_transaction_cancel(struct ctdb_transaction_handle *h)
{
        talloc_free(h);
        return 0;
}


/*
  recovery daemon ping to main daemon
 */
int ctdb_ctrl_recd_ping(struct ctdb_context *ctdb)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, CTDB_CURRENT_NODE, 0, CTDB_CONTROL_RECD_PING, 0, tdb_null, 
                           ctdb, NULL, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,("Failed to send recd ping\n"));
                return -1;
        }

        return 0;
}

/* When forking the main daemon and the child process needs to connect
 * back to the daemon as a client process, this function can be used
 * to change the ctdb context from daemon into client mode.  The child
 * process must be created using ctdb_fork() and not fork() -
 * ctdb_fork() does some necessary housekeeping.
 */
int switch_from_server_to_client(struct ctdb_context *ctdb, const char *fmt, ...)
{
        int ret;
        va_list ap;

        /* Add extra information so we can identify this in the logs */
        va_start(ap, fmt);
        debug_extra = talloc_strdup_append(talloc_vasprintf(NULL, fmt, ap), ":");
        va_end(ap);

        /* get a new event context */
        ctdb->ev = event_context_init(ctdb);
        tevent_loop_allow_nesting(ctdb->ev);

        /* Connect to main CTDB daemon */
        ret = ctdb_socket_connect(ctdb);
        if (ret != 0) {
                DEBUG(DEBUG_ALERT, (__location__ " Failed to init ctdb client\n"));
                return -1;
        }

        ctdb->can_send_controls = true;

        return 0;
}

/*
  get the status of running the monitor eventscripts: NULL means never run.
 */
int ctdb_ctrl_getscriptstatus(struct ctdb_context *ctdb, 
                struct timeval timeout, uint32_t destnode, 
                TALLOC_CTX *mem_ctx, enum ctdb_eventscript_call type,
                struct ctdb_scripts_wire **scripts)
{
        int ret;
        TDB_DATA outdata, indata;
        int32_t res;
        uint32_t uinttype = type;

        indata.dptr = (uint8_t *)&uinttype;
        indata.dsize = sizeof(uinttype);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_EVENT_SCRIPT_STATUS, 0, indata,
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getscriptstatus failed ret:%d res:%d\n", ret, res));
                return -1;
        }

        if (outdata.dsize == 0) {
                *scripts = NULL;
        } else {
                *scripts = (struct ctdb_scripts_wire *)talloc_memdup(mem_ctx, outdata.dptr, outdata.dsize);
                talloc_free(outdata.dptr);
        }
                    
        return 0;
}

/*
  tell the main daemon how long it took to lock the reclock file
 */
int ctdb_ctrl_report_recd_lock_latency(struct ctdb_context *ctdb, struct timeval timeout, double latency)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        data.dptr = (uint8_t *)&latency;
        data.dsize = sizeof(latency);

        ret = ctdb_control(ctdb, CTDB_CURRENT_NODE, 0, CTDB_CONTROL_RECD_RECLOCK_LATENCY, 0, data, 
                           ctdb, NULL, &res, NULL, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,("Failed to send recd reclock latency\n"));
                return -1;
        }

        return 0;
}

/*
  get the name of the reclock file
 */
int ctdb_ctrl_getreclock(struct ctdb_context *ctdb, struct timeval timeout,
                         uint32_t destnode, TALLOC_CTX *mem_ctx,
                         const char **name)
{
        int ret;
        int32_t res;
        TDB_DATA data;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_RECLOCK_FILE, 0, tdb_null, 
                           mem_ctx, &data, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                return -1;
        }

        if (data.dsize == 0) {
                *name = NULL;
        } else {
                *name = talloc_strdup(mem_ctx, discard_const(data.dptr));
        }
        talloc_free(data.dptr);

        return 0;
}

/*
  set the reclock filename for a node
 */
int ctdb_ctrl_setreclock(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, const char *reclock)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        if (reclock == NULL) {
                data.dsize = 0;
                data.dptr  = NULL;
        } else {
                data.dsize = strlen(reclock) + 1;
                data.dptr  = discard_const(reclock);
        }

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_RECLOCK_FILE, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setreclock failed\n"));
                return -1;
        }

        return 0;
}

/*
  stop a node
 */
int ctdb_ctrl_stop_node(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int ret;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_STOP_NODE, 0, tdb_null, 
                           ctdb, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,("Failed to stop node\n"));
                return -1;
        }

        return 0;
}

/*
  continue a node
 */
int ctdb_ctrl_continue_node(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode)
{
        int ret;

        ret = ctdb_control(ctdb, destnode, 0, CTDB_CONTROL_CONTINUE_NODE, 0, tdb_null, 
                           ctdb, NULL, NULL, &timeout, NULL);
        if (ret != 0) {
                DEBUG(DEBUG_ERR,("Failed to continue node\n"));
                return -1;
        }

        return 0;
}

/*
  set the natgw state for a node
 */
int ctdb_ctrl_setnatgwstate(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t natgwstate)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = sizeof(natgwstate);
        data.dptr  = (uint8_t *)&natgwstate;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_NATGWSTATE, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setnatgwstate failed\n"));
                return -1;
        }

        return 0;
}

/*
  set the lmaster role for a node
 */
int ctdb_ctrl_setlmasterrole(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t lmasterrole)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = sizeof(lmasterrole);
        data.dptr  = (uint8_t *)&lmasterrole;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_LMASTERROLE, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setlmasterrole failed\n"));
                return -1;
        }

        return 0;
}

/*
  set the recmaster role for a node
 */
int ctdb_ctrl_setrecmasterrole(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t recmasterrole)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = sizeof(recmasterrole);
        data.dptr  = (uint8_t *)&recmasterrole;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_RECMASTERROLE, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for setrecmasterrole failed\n"));
                return -1;
        }

        return 0;
}

/* enable an eventscript
 */
int ctdb_ctrl_enablescript(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, const char *script)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = strlen(script) + 1;
        data.dptr  = discard_const(script);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_ENABLE_SCRIPT, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for enablescript failed\n"));
                return -1;
        }

        return 0;
}

/* disable an eventscript
 */
int ctdb_ctrl_disablescript(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, const char *script)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = strlen(script) + 1;
        data.dptr  = discard_const(script);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_DISABLE_SCRIPT, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for disablescript failed\n"));
                return -1;
        }

        return 0;
}


int ctdb_ctrl_set_ban(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, struct ctdb_ban_time *bantime)
{
        int ret;
        TDB_DATA data;
        int32_t res;

        data.dsize = sizeof(*bantime);
        data.dptr  = (uint8_t *)bantime;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_BAN_STATE, 0, data, 
                           NULL, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for set ban state failed\n"));
                return -1;
        }

        return 0;
}


int ctdb_ctrl_get_ban(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, TALLOC_CTX *mem_ctx, struct ctdb_ban_time **bantime)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;
        TALLOC_CTX *tmp_ctx = talloc_new(NULL);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_BAN_STATE, 0, tdb_null,
                           tmp_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for set ban state failed\n"));
                talloc_free(tmp_ctx);
                return -1;
        }

        *bantime = (struct ctdb_ban_time *)talloc_steal(mem_ctx, outdata.dptr);
        talloc_free(tmp_ctx);

        return 0;
}


int ctdb_ctrl_set_db_priority(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, struct ctdb_db_priority *db_prio)
{
        int ret;
        int32_t res;
        TDB_DATA data;
        TALLOC_CTX *tmp_ctx = talloc_new(NULL);

        data.dptr = (uint8_t*)db_prio;
        data.dsize = sizeof(*db_prio);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_DB_PRIORITY, 0, data,
                           tmp_ctx, NULL, &res, &timeout, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for set_db_priority failed\n"));
                talloc_free(tmp_ctx);
                return -1;
        }

        talloc_free(tmp_ctx);

        return 0;
}

int ctdb_ctrl_get_db_priority(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, uint32_t db_id, uint32_t *priority)
{
        int ret;
        int32_t res;
        TDB_DATA data;
        TALLOC_CTX *tmp_ctx = talloc_new(NULL);

        data.dptr = (uint8_t*)&db_id;
        data.dsize = sizeof(db_id);

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_DB_PRIORITY, 0, data,
                           tmp_ctx, NULL, &res, &timeout, NULL);
        if (ret != 0 || res < 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for get_db_priority failed\n"));
                talloc_free(tmp_ctx);
                return -1;
        }

        if (priority) {
                *priority = res;
        }

        talloc_free(tmp_ctx);

        return 0;
}

int ctdb_ctrl_getstathistory(struct ctdb_context *ctdb, struct timeval timeout, uint32_t destnode, TALLOC_CTX *mem_ctx, struct ctdb_statistics_wire **stats)
{
        int ret;
        TDB_DATA outdata;
        int32_t res;

        ret = ctdb_control(ctdb, destnode, 0, 
                           CTDB_CONTROL_GET_STAT_HISTORY, 0, tdb_null, 
                           mem_ctx, &outdata, &res, &timeout, NULL);
        if (ret != 0 || res != 0 || outdata.dsize == 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_control for getstathistory failed ret:%d res:%d\n", ret, res));
                return -1;
        }

        *stats = (struct ctdb_statistics_wire *)talloc_memdup(mem_ctx, outdata.dptr, outdata.dsize);
        talloc_free(outdata.dptr);
                    
        return 0;
}

struct ctdb_ltdb_header *ctdb_header_from_record_handle(struct ctdb_record_handle *h)
{
        if (h == NULL) {
                return NULL;
        }

        return &h->header;
}


struct ctdb_client_control_state *
ctdb_ctrl_updaterecord_send(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode, struct ctdb_db_context *ctdb_db, TDB_DATA key, struct ctdb_ltdb_header *header, TDB_DATA data)
{
        struct ctdb_client_control_state *handle;
        struct ctdb_marshall_buffer *m;
        struct ctdb_rec_data *rec;
        TDB_DATA outdata;

        m = talloc_zero(mem_ctx, struct ctdb_marshall_buffer);
        if (m == NULL) {
                DEBUG(DEBUG_ERR, ("Failed to allocate marshall buffer for update record\n"));
                return NULL;
        }

        m->db_id = ctdb_db->db_id;

        rec = ctdb_marshall_record(m, 0, key, header, data);
        if (rec == NULL) {
                DEBUG(DEBUG_ERR,("Failed to marshall record for update record\n"));
                talloc_free(m);
                return NULL;
        }
        m = talloc_realloc_size(mem_ctx, m, rec->length + offsetof(struct ctdb_marshall_buffer, data));
        if (m == NULL) {
                DEBUG(DEBUG_CRIT,(__location__ " Failed to expand recdata\n"));
                talloc_free(m);
                return NULL;
        }
        m->count++;
        memcpy((uint8_t *)m + offsetof(struct ctdb_marshall_buffer, data), rec, rec->length);


        outdata.dptr = (uint8_t *)m;
        outdata.dsize = talloc_get_size(m);

        handle = ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_UPDATE_RECORD, 0, outdata,
                           mem_ctx, &timeout, NULL);
        talloc_free(m);
        return handle;
}

int ctdb_ctrl_updaterecord_recv(struct ctdb_context *ctdb, struct ctdb_client_control_state *state)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, state, NULL, &res, NULL);
        if ( (ret != 0) || (res != 0) ){
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_update_record_recv failed\n"));
                return -1;
        }

        return 0;
}

int
ctdb_ctrl_updaterecord(struct ctdb_context *ctdb, TALLOC_CTX *mem_ctx, struct timeval timeout, uint32_t destnode, struct ctdb_db_context *ctdb_db, TDB_DATA key, struct ctdb_ltdb_header *header, TDB_DATA data)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_updaterecord_send(ctdb, mem_ctx, timeout, destnode, ctdb_db, key, header, data);
        return ctdb_ctrl_updaterecord_recv(ctdb, state);
}






/*
  set a database to be readonly
 */
struct ctdb_client_control_state *
ctdb_ctrl_set_db_readonly_send(struct ctdb_context *ctdb, uint32_t destnode, uint32_t dbid)
{
        TDB_DATA data;

        data.dptr = (uint8_t *)&dbid;
        data.dsize = sizeof(dbid);

        return ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_DB_READONLY, 0, data, 
                           ctdb, NULL, NULL);
}

int ctdb_ctrl_set_db_readonly_recv(struct ctdb_context *ctdb, struct ctdb_client_control_state *state)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, ctdb, NULL, &res, NULL);
        if (ret != 0 || res != 0) {
          DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_set_db_readonly_recv failed  ret:%d res:%d\n", ret, res));
                return -1;
        }

        return 0;
}

int ctdb_ctrl_set_db_readonly(struct ctdb_context *ctdb, uint32_t destnode, uint32_t dbid)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_set_db_readonly_send(ctdb, destnode, dbid);
        return ctdb_ctrl_set_db_readonly_recv(ctdb, state);
}

/*
  set a database to be sticky
 */
struct ctdb_client_control_state *
ctdb_ctrl_set_db_sticky_send(struct ctdb_context *ctdb, uint32_t destnode, uint32_t dbid)
{
        TDB_DATA data;

        data.dptr = (uint8_t *)&dbid;
        data.dsize = sizeof(dbid);

        return ctdb_control_send(ctdb, destnode, 0, 
                           CTDB_CONTROL_SET_DB_STICKY, 0, data, 
                           ctdb, NULL, NULL);
}

int ctdb_ctrl_set_db_sticky_recv(struct ctdb_context *ctdb, struct ctdb_client_control_state *state)
{
        int ret;
        int32_t res;

        ret = ctdb_control_recv(ctdb, state, ctdb, NULL, &res, NULL);
        if (ret != 0 || res != 0) {
                DEBUG(DEBUG_ERR,(__location__ " ctdb_ctrl_set_db_sticky_recv failed  ret:%d res:%d\n", ret, res));
                return -1;
        }

        return 0;
}

int ctdb_ctrl_set_db_sticky(struct ctdb_context *ctdb, uint32_t destnode, uint32_t dbid)
{
        struct ctdb_client_control_state *state;

        state = ctdb_ctrl_set_db_sticky_send(ctdb, destnode, dbid);
        return ctdb_ctrl_set_db_sticky_recv(ctdb, state);
}