ctdb/include/ctdb_private.h

   1 /*
   2    ctdb database library
   3
   4    Copyright (C) Andrew Tridgell  2006
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef _CTDB_PRIVATE_H
  21 #define _CTDB_PRIVATE_H
  22
  23 #include "ctdb_client.h"
  24 #include <sys/socket.h>
  25
  26 #include "common/db_hash.h"
  27
  28 /*
  29   array of tcp connections
  30  */
  31 struct ctdb_tcp_array {
  32         uint32_t num;
  33         struct ctdb_connection *connections;
  34 };
  35
  36 /*
  37   an installed ctdb remote call
  38 */
  39 typedef int (*ctdb_fn_t)(struct ctdb_call_info *);
  40
  41 struct ctdb_registered_call {
  42         struct ctdb_registered_call *next, *prev;
  43         uint32_t id;
  44         ctdb_fn_t fn;
  45 };
  46
  47 /*
  48   check that a pnn is valid
  49  */
  50 #define ctdb_validate_pnn(ctdb, pnn) (((uint32_t)(pnn)) < (ctdb)->num_nodes)
  51
  52 /* used for callbacks in ctdb_control requests */
  53 typedef void (*ctdb_control_callback_fn_t)(struct ctdb_context *,
  54                                            int32_t status, TDB_DATA data,
  55                                            const char *errormsg,
  56                                            void *private_data);
  57 /*
  58   structure describing a connected client in the daemon
  59  */
  60 struct ctdb_client {
  61         struct ctdb_context *ctdb;
  62         int fd;
  63         struct ctdb_queue *queue;
  64         uint32_t client_id;
  65         pid_t pid;
  66         struct ctdb_tcp_list *tcp_list;
  67         uint32_t db_id;
  68         uint32_t num_persistent_updates;
  69         struct ctdb_client_notify_list *notify;
  70 };
  71
  72 /*
  73   state associated with one node
  74 */
  75 struct ctdb_node {
  76         struct ctdb_context *ctdb;
  77         ctdb_sock_addr address;
  78         const char *name; /* for debug messages */
  79         void *transport_data; /* private to transport */
  80         uint32_t pnn;
  81         uint32_t flags;
  82
  83         /* used by the dead node monitoring */
  84         uint32_t dead_count;
  85         uint32_t rx_cnt;
  86         uint32_t tx_cnt;
  87
  88         /* a list of controls pending to this node, so we can time them out quickly
  89            if the node becomes disconnected */
  90         struct daemon_control_state *pending_controls;
  91
  92         /* used by the recovery daemon to track when a node should be banned */
  93         struct ctdb_banning_state *ban_state;
  94 };
  95
  96 /*
  97   transport specific methods
  98 */
  99 struct ctdb_methods {
 100         int (*initialise)(struct ctdb_context *); /* initialise transport structures */
 101         int (*start)(struct ctdb_context *); /* start the transport */
 102         int (*add_node)(struct ctdb_node *); /* setup a new node */
 103         int (*connect_node)(struct ctdb_node *); /* connect to node */
 104         int (*queue_pkt)(struct ctdb_node *, uint8_t *data, uint32_t length);
 105         void *(*allocate_pkt)(TALLOC_CTX *mem_ctx, size_t );
 106         void (*shutdown)(struct ctdb_context *); /* shutdown transport */
 107         void (*restart)(struct ctdb_node *); /* stop and restart the connection */
 108 };
 109
 110 /*
 111   transport calls up to the ctdb layer
 112 */
 113 struct ctdb_upcalls {
 114         /* recv_pkt is called when a packet comes in */
 115         void (*recv_pkt)(struct ctdb_context *, uint8_t *data, uint32_t length);
 116
 117         /* node_dead is called when an attempt to send to a node fails */
 118         void (*node_dead)(struct ctdb_node *);
 119
 120         /* node_connected is called when a connection to a node is established */
 121         void (*node_connected)(struct ctdb_node *);
 122 };
 123
 124 /* additional data required for the daemon mode */
 125 struct ctdb_daemon_data {
 126         int sd;
 127         char *name;
 128         struct ctdb_queue *queue;
 129 };
 130
 131
 132 #define CTDB_UPDATE_STAT(ctdb, counter, value) \
 133         {                                                                               \
 134                 if (value > ctdb->statistics.counter) {                                 \
 135                         ctdb->statistics.counter = value;                               \
 136                 }                                                                       \
 137                 if (value > ctdb->statistics_current.counter) {                         \
 138                         ctdb->statistics_current.counter = value;                       \
 139                 }                                                                       \
 140         }
 141
 142 #define CTDB_INCREMENT_STAT(ctdb, counter) \
 143         {                                                                               \
 144                 ctdb->statistics.counter++;                                             \
 145                 ctdb->statistics_current.counter++;                                     \
 146         }
 147
 148 #define CTDB_DECREMENT_STAT(ctdb, counter) \
 149         {                                                                               \
 150                 if (ctdb->statistics.counter > 0)                                       \
 151                         ctdb->statistics.counter--;                                     \
 152                 if (ctdb->statistics_current.counter > 0)                               \
 153                         ctdb->statistics_current.counter--;                             \
 154         }
 155
 156 #define CTDB_INCREMENT_DB_STAT(ctdb_db, counter) \
 157         {                                                                               \
 158                 ctdb_db->statistics.counter++;                                          \
 159         }
 160
 161 #define CTDB_DECREMENT_DB_STAT(ctdb_db, counter) \
 162         {                                                                               \
 163                 if (ctdb_db->statistics.counter > 0)                                    \
 164                         ctdb_db->statistics.counter--;                                  \
 165         }
 166
 167 #define CTDB_UPDATE_RECLOCK_LATENCY(ctdb, name, counter, value) \
 168         {                                                                               \
 169                 if (value > ctdb->statistics.counter.max)                               \
 170                         ctdb->statistics.counter.max = value;                           \
 171                 if (value > ctdb->statistics_current.counter.max)                       \
 172                         ctdb->statistics_current.counter.max = value;                   \
 173                                                                                         \
 174                 if (ctdb->statistics.counter.num == 0 ||                                \
 175                     value < ctdb->statistics.counter.min)                               \
 176                         ctdb->statistics.counter.min = value;                           \
 177                 if (ctdb->statistics_current.counter.num == 0 ||                        \
 178                     value < ctdb->statistics_current.counter.min)                       \
 179                         ctdb->statistics_current.counter.min = value;                   \
 180                                                                                         \
 181                 ctdb->statistics.counter.total += value;                                \
 182                 ctdb->statistics_current.counter.total += value;                        \
 183                                                                                         \
 184                 ctdb->statistics.counter.num++;                                         \
 185                 ctdb->statistics_current.counter.num++;                                 \
 186                                                                                         \
 187                 if (ctdb->tunable.reclock_latency_ms != 0) {                            \
 188                         if (value*1000 > ctdb->tunable.reclock_latency_ms) {            \
 189                                 DEBUG(DEBUG_ERR,                                        \
 190                                       ("High RECLOCK latency %fs for operation %s\n",   \
 191                                        value, name));                                   \
 192                         }                                                               \
 193                 }                                                                       \
 194         }
 195
 196 #define CTDB_UPDATE_DB_LATENCY(ctdb_db, operation, counter, value)                      \
 197         {                                                                               \
 198                 if (value > ctdb_db->statistics.counter.max)                            \
 199                         ctdb_db->statistics.counter.max = value;                        \
 200                 if (ctdb_db->statistics.counter.num == 0 ||                             \
 201                     value < ctdb_db->statistics.counter.min)                            \
 202                         ctdb_db->statistics.counter.min = value;                        \
 203                                                                                         \
 204                 ctdb_db->statistics.counter.total += value;                             \
 205                 ctdb_db->statistics.counter.num++;                                      \
 206                                                                                         \
 207                 if (ctdb_db->ctdb->tunable.log_latency_ms != 0) {                       \
 208                         if (value*1000 > ctdb_db->ctdb->tunable.log_latency_ms) {       \
 209                                 DEBUG(DEBUG_ERR,                                        \
 210                                       ("High latency %.6fs for operation %s on database %s\n",\
 211                                        value, operation, ctdb_db->db_name));            \
 212                         }                                                               \
 213                 }                                                                       \
 214         }
 215
 216 #define CTDB_UPDATE_LATENCY(ctdb, db, operation, counter, t) \
 217         {                                                                               \
 218                 double l = timeval_elapsed(&t);                                         \
 219                                                                                         \
 220                 if (l > ctdb->statistics.counter.max)                                   \
 221                         ctdb->statistics.counter.max = l;                               \
 222                 if (l > ctdb->statistics_current.counter.max)                           \
 223                         ctdb->statistics_current.counter.max = l;                       \
 224                                                                                         \
 225                 if (ctdb->statistics.counter.num == 0 ||                                \
 226                     l < ctdb->statistics.counter.min)                                   \
 227                         ctdb->statistics.counter.min = l;                               \
 228                 if (ctdb->statistics_current.counter.num == 0 ||                        \
 229                     l < ctdb->statistics_current.counter.min)                           \
 230                         ctdb->statistics_current.counter.min = l;                       \
 231                                                                                         \
 232                 ctdb->statistics.counter.total += l;                                    \
 233                 ctdb->statistics_current.counter.total += l;                            \
 234                                                                                         \
 235                 ctdb->statistics.counter.num++;                                         \
 236                 ctdb->statistics_current.counter.num++;                                 \
 237                                                                                         \
 238                 if (ctdb->tunable.log_latency_ms != 0) {                                \
 239                         if (l*1000 > ctdb->tunable.log_latency_ms) {                    \
 240                                 DEBUG(DEBUG_WARNING,                                    \
 241                                       ("High latency %.6fs for operation %s on database %s\n",\
 242                                        l, operation, db->db_name));                     \
 243                         }                                                               \
 244                 }                                                                       \
 245         }
 246
 247
 248 struct ctdb_cluster_mutex_handle;
 249 struct eventd_context;
 250
 251 enum ctdb_freeze_mode {CTDB_FREEZE_NONE, CTDB_FREEZE_PENDING, CTDB_FREEZE_FROZEN};
 252
 253 /* main state of the ctdb daemon */
 254 struct ctdb_context {
 255         struct tevent_context *ev;
 256         struct timeval ctdbd_start_time;
 257         struct timeval last_recovery_started;
 258         struct timeval last_recovery_finished;
 259         uint32_t recovery_mode;
 260         TALLOC_CTX *tickle_update_context;
 261         TALLOC_CTX *keepalive_ctx;
 262         TALLOC_CTX *check_public_ifaces_ctx;
 263         struct ctdb_tunable_list tunable;
 264         enum ctdb_freeze_mode freeze_mode;
 265         struct ctdb_freeze_handle *freeze_handle;
 266         bool freeze_transaction_started;
 267         uint32_t freeze_transaction_id;
 268         ctdb_sock_addr *address;
 269         const char *name;
 270         const char *db_directory;
 271         const char *db_directory_persistent;
 272         const char *db_directory_state;
 273         struct tdb_wrap *db_persistent_health;
 274         uint32_t db_persistent_startup_generation;
 275         uint64_t db_persistent_check_errors;
 276         uint64_t max_persistent_check_errors;
 277         const char *transport;
 278         const char *recovery_lock;
 279         uint32_t pnn; /* our own pnn */
 280         uint32_t num_nodes;
 281         uint32_t num_connected;
 282         unsigned flags;
 283         uint32_t capabilities;
 284         struct reqid_context *idr;
 285         struct ctdb_node **nodes; /* array of nodes in the cluster - indexed by vnn */
 286         struct ctdb_vnn *vnn; /* list of public ip addresses and interfaces */
 287         struct ctdb_interface *ifaces; /* list of local interfaces */
 288         char *err_msg;
 289         const struct ctdb_methods *methods; /* transport methods */
 290         const struct ctdb_upcalls *upcalls; /* transport upcalls */
 291         void *transport_data; /* private to transport */
 292         struct ctdb_db_context *db_list;
 293         struct srvid_context *srv;
 294         struct srvid_context *tunnels;
 295         struct ctdb_daemon_data daemon;
 296         struct ctdb_statistics statistics;
 297         struct ctdb_statistics statistics_current;
 298 #define MAX_STAT_HISTORY 100
 299         struct ctdb_statistics statistics_history[MAX_STAT_HISTORY];
 300         struct ctdb_vnn_map *vnn_map;
 301         uint32_t num_clients;
 302         uint32_t recovery_master;
 303         struct ctdb_client_ip *client_ip_list;
 304         bool do_checkpublicip;
 305         bool do_setsched;
 306         const char *event_script_dir;
 307         const char *notification_script;
 308         pid_t ctdbd_pid;
 309         pid_t recoverd_pid;
 310         enum ctdb_runstate runstate;
 311         struct ctdb_monitor_state *monitor;
 312         int start_as_disabled;
 313         int start_as_stopped;
 314         bool valgrinding;
 315         uint32_t *recd_ping_count;
 316         TALLOC_CTX *recd_ctx; /* a context used to track recoverd monitoring events */
 317         TALLOC_CTX *release_ips_ctx; /* a context used to automatically drop all IPs if we fail to recover the node */
 318
 319         struct eventd_context *ectx;
 320
 321         TALLOC_CTX *banning_ctx;
 322
 323         struct ctdb_vacuum_child_context *vacuumer;
 324
 325         /* mapping from pid to ctdb_client * */
 326         struct ctdb_client_pid_list *client_pids;
 327
 328         /* Used to defer db attach requests while in recovery mode */
 329         struct ctdb_deferred_attach_context *deferred_attach;
 330
 331         /* if we are a child process, do we have a domain socket to send controls on */
 332         bool can_send_controls;
 333
 334         struct ctdb_reloadips_handle *reload_ips;
 335
 336         const char *nodes_file;
 337         const char *public_addresses_file;
 338         struct trbt_tree *child_processes;
 339
 340         /* Used for locking record/db/alldb */
 341         struct lock_context *lock_current;
 342         struct lock_context *lock_pending;
 343 };
 344
 345 struct ctdb_db_hot_key {
 346         uint32_t count;
 347         TDB_DATA key;
 348         uint32_t last_logged_count;
 349 };
 350
 351 struct ctdb_db_context {
 352         struct ctdb_db_context *next, *prev;
 353         struct ctdb_context *ctdb;
 354         uint32_t db_id;
 355         uint8_t db_flags;
 356         const char *db_name;
 357         const char *db_path;
 358         struct tdb_wrap *ltdb;
 359         struct tdb_context *rottdb; /* ReadOnly tracking TDB */
 360         struct ctdb_registered_call *calls; /* list of registered calls */
 361         uint32_t seqnum;
 362         struct tevent_timer *seqnum_update;
 363         struct ctdb_traverse_local_handle *traverse;
 364         struct ctdb_vacuum_handle *vacuum_handle;
 365         char *unhealthy_reason;
 366         int pending_requests;
 367         struct revokechild_handle *revokechild_active;
 368         struct ctdb_persistent_state *persistent_state;
 369         struct trbt_tree *delete_queue;
 370         struct trbt_tree *fetch_queue;
 371         struct trbt_tree *sticky_records;
 372         int (*ctdb_ltdb_store_fn)(struct ctdb_db_context *ctdb_db,
 373                                   TDB_DATA key,
 374                                   struct ctdb_ltdb_header *header,
 375                                   TDB_DATA data);
 376
 377         /* used to track which records we are currently fetching
 378            so we can avoid sending duplicate fetch requests
 379         */
 380         struct trbt_tree *deferred_fetch;
 381         struct trbt_tree *defer_dmaster;
 382
 383         struct ctdb_db_statistics_old statistics;
 384         struct ctdb_db_hot_key hot_keys[MAX_HOT_KEYS];
 385
 386         struct lock_context *lock_current;
 387         struct lock_context *lock_pending;
 388         unsigned int lock_num_current;
 389         struct db_hash_context *lock_log;
 390
 391         struct ctdb_call_state *pending_calls;
 392
 393         enum ctdb_freeze_mode freeze_mode;
 394         struct ctdb_db_freeze_handle *freeze_handle;
 395         bool freeze_transaction_started;
 396         uint32_t freeze_transaction_id;
 397         uint32_t generation;
 398
 399         bool invalid_records;
 400         bool push_started;
 401         void *push_state;
 402
 403         struct hash_count_context *migratedb;
 404 };
 405
 406
 407 #define CTDB_NO_MEMORY(ctdb, p) do { if (!(p)) { \
 408           DEBUG(0,("Out of memory for %s at %s\n", #p, __location__)); \
 409           ctdb_set_error(ctdb, "Out of memory at %s:%d", __FILE__, __LINE__); \
 410           return -1; }} while (0)
 411
 412 #define CTDB_NO_MEMORY_VOID(ctdb, p) do { if (!(p)) { \
 413           DEBUG(0,("Out of memory for %s at %s\n", #p, __location__)); \
 414           ctdb_set_error(ctdb, "Out of memory at %s:%d", __FILE__, __LINE__); \
 415           return; }} while (0)
 416
 417 #define CTDB_NO_MEMORY_NULL(ctdb, p) do { if (!(p)) { \
 418           DEBUG(0,("Out of memory for %s at %s\n", #p, __location__)); \
 419           ctdb_set_error(ctdb, "Out of memory at %s:%d", __FILE__, __LINE__); \
 420           return NULL; }} while (0)
 421
 422 #define CTDB_NO_MEMORY_FATAL(ctdb, p) do { if (!(p)) { \
 423           DEBUG(0,("Out of memory for %s at %s\n", #p, __location__)); \
 424           ctdb_fatal(ctdb, "Out of memory in " __location__ ); \
 425           }} while (0)
 426
 427
 428 enum call_state {CTDB_CALL_WAIT, CTDB_CALL_DONE, CTDB_CALL_ERROR};
 429
 430 /*
 431   state of a in-progress ctdb call
 432 */
 433 struct ctdb_call_state {
 434         struct ctdb_call_state *next, *prev;
 435         enum call_state state;
 436         uint32_t reqid;
 437         struct ctdb_req_call_old *c;
 438         struct ctdb_db_context *ctdb_db;
 439         const char *errmsg;
 440         struct ctdb_call *call;
 441         uint32_t generation;
 442         struct {
 443                 void (*fn)(struct ctdb_call_state *);
 444                 void *private_data;
 445         } async;
 446 };
 447
 448 /* internal prototypes */
 449
 450 #define CHECK_CONTROL_DATA_SIZE(size) do { \
 451  if (indata.dsize != size) { \
 452          DEBUG(0,(__location__ " Invalid data size in opcode %u. Got %u expected %u\n", \
 453                   opcode, (unsigned)indata.dsize, (unsigned)size));     \
 454          return -1; \
 455  } \
 456  } while (0)
 457
 458 #define CHECK_CONTROL_MIN_DATA_SIZE(size) do { \
 459  if (indata.dsize < size) { \
 460          DEBUG(0,(__location__ " Invalid data size in opcode %u. Got %u expected >= %u\n", \
 461                   opcode, (unsigned)indata.dsize, (unsigned)size));     \
 462          return -1; \
 463  } \
 464  } while (0)
 465
 466 /*
 467   state of a in-progress ctdb call in client
 468 */
 469 struct ctdb_client_call_state {
 470         enum call_state state;
 471         uint32_t reqid;
 472         struct ctdb_db_context *ctdb_db;
 473         struct ctdb_call *call;
 474         struct {
 475                 void (*fn)(struct ctdb_client_call_state *);
 476                 void *private_data;
 477         } async;
 478 };
 479
 480 extern int script_log_level;
 481 extern bool fast_start;
 482 extern const char *ctdbd_pidfile;
 483
 484 typedef void (*deferred_requeue_fn)(void *call_context, struct ctdb_req_header *hdr);
 485
 486
 487 /* from tcp/ and ib/ */
 488
 489 int ctdb_tcp_init(struct ctdb_context *ctdb);
 490 int ctdb_ibw_init(struct ctdb_context *ctdb);
 491
 492 /* from ctdb_banning.c */
 493
 494 int32_t ctdb_control_set_ban_state(struct ctdb_context *ctdb, TDB_DATA indata);
 495 int32_t ctdb_control_get_ban_state(struct ctdb_context *ctdb, TDB_DATA *outdata);
 496 void ctdb_ban_self(struct ctdb_context *ctdb);
 497
 498 /* from ctdb_call.c */
 499
 500 struct ctdb_db_context *find_ctdb_db(struct ctdb_context *ctdb, uint32_t id);
 501
 502 void ctdb_request_dmaster(struct ctdb_context *ctdb,
 503                           struct ctdb_req_header *hdr);
 504 void ctdb_reply_dmaster(struct ctdb_context *ctdb,
 505                         struct ctdb_req_header *hdr);
 506 void ctdb_request_call(struct ctdb_context *ctdb, struct ctdb_req_header *hdr);
 507 void ctdb_reply_call(struct ctdb_context *ctdb, struct ctdb_req_header *hdr);
 508 void ctdb_reply_error(struct ctdb_context *ctdb, struct ctdb_req_header *hdr);
 509
 510 void ctdb_call_resend_db(struct ctdb_db_context *ctdb);
 511 void ctdb_call_resend_all(struct ctdb_context *ctdb);
 512
 513 struct ctdb_call_state *ctdb_call_local_send(struct ctdb_db_context *ctdb_db,
 514                                              struct ctdb_call *call,
 515                                              struct ctdb_ltdb_header *header,
 516                                              TDB_DATA *data);
 517
 518 struct ctdb_call_state *ctdb_daemon_call_send_remote(
 519                                         struct ctdb_db_context *ctdb_db,
 520                                         struct ctdb_call *call,
 521                                         struct ctdb_ltdb_header *header);
 522 int ctdb_daemon_call_recv(struct ctdb_call_state *state,
 523                           struct ctdb_call *call);
 524
 525 int ctdb_start_revoke_ro_record(struct ctdb_context *ctdb,
 526                                 struct ctdb_db_context *ctdb_db,
 527                                 TDB_DATA key, struct ctdb_ltdb_header *header,
 528                                 TDB_DATA data);
 529
 530 int ctdb_add_revoke_deferred_call(struct ctdb_context *ctdb,
 531                                   struct ctdb_db_context *ctdb_db,
 532                                   TDB_DATA key, struct ctdb_req_header *hdr,
 533                                   deferred_requeue_fn fn, void *call_context);
 534
 535 int ctdb_migration_init(struct ctdb_db_context *ctdb_db);
 536
 537 /* from server/ctdb_control.c */
 538
 539 int32_t ctdb_dump_memory(struct ctdb_context *ctdb, TDB_DATA *outdata);
 540
 541 void ctdb_request_control_reply(struct ctdb_context *ctdb,
 542                                 struct ctdb_req_control_old *c,
 543                                 TDB_DATA *outdata, int32_t status,
 544                                 const char *errormsg);
 545
 546 void ctdb_request_control(struct ctdb_context *ctdb,
 547                           struct ctdb_req_header *hdr);
 548 void ctdb_reply_control(struct ctdb_context *ctdb,
 549                         struct ctdb_req_header *hdr);
 550
 551 int ctdb_daemon_send_control(struct ctdb_context *ctdb, uint32_t destnode,
 552                              uint64_t srvid, uint32_t opcode,
 553                              uint32_t client_id, uint32_t flags,
 554                              TDB_DATA data,
 555                              ctdb_control_callback_fn_t callback,
 556                              void *private_data);
 557
 558 /* from server/ctdb_daemon.c */
 559
 560 int daemon_register_message_handler(struct ctdb_context *ctdb,
 561                                     uint32_t client_id, uint64_t srvid);
 562 int daemon_deregister_message_handler(struct ctdb_context *ctdb,
 563                                       uint32_t client_id, uint64_t srvid);
 564
 565 void daemon_tunnel_handler(uint64_t tunnel_id, TDB_DATA data,
 566                            void *private_data);
 567
 568 int ctdb_start_daemon(struct ctdb_context *ctdb,
 569                       bool interactive,
 570                       bool test_mode_enabled);
 571
 572 struct ctdb_req_header *_ctdb_transport_allocate(struct ctdb_context *ctdb,
 573                                                  TALLOC_CTX *mem_ctx,
 574                                                  enum ctdb_operation operation,
 575                                                  size_t length, size_t slength,
 576                                                  const char *type);
 577
 578 #define ctdb_transport_allocate(ctdb, mem_ctx, operation, length, type) \
 579         (type *)_ctdb_transport_allocate(ctdb, mem_ctx, operation, length, \
 580                                          sizeof(type), #type)
 581
 582 void ctdb_daemon_cancel_controls(struct ctdb_context *ctdb,
 583                                  struct ctdb_node *node);
 584
 585 int ctdb_daemon_set_call(struct ctdb_context *ctdb, uint32_t db_id,
 586                          ctdb_fn_t fn, int id);
 587
 588 int ctdb_daemon_send_message(struct ctdb_context *ctdb, uint32_t pnn,
 589                              uint64_t srvid, TDB_DATA data);
 590
 591 int32_t ctdb_control_register_notify(struct ctdb_context *ctdb,
 592                                      uint32_t client_id, TDB_DATA indata);
 593 int32_t ctdb_control_deregister_notify(struct ctdb_context *ctdb,
 594                                        uint32_t client_id, TDB_DATA indata);
 595
 596 struct ctdb_client *ctdb_find_client_by_pid(struct ctdb_context *ctdb,
 597                                             pid_t pid);
 598
 599 int32_t ctdb_control_process_exists(struct ctdb_context *ctdb, pid_t pid);
 600 int32_t ctdb_control_check_pid_srvid(struct ctdb_context *ctdb,
 601                                      TDB_DATA indata);
 602
 603 int ctdb_control_getnodesfile(struct ctdb_context *ctdb, uint32_t opcode,
 604                               TDB_DATA indata, TDB_DATA *outdata);
 605
 606 void ctdb_shutdown_sequence(struct ctdb_context *ctdb, int exit_code);
 607
 608 int switch_from_server_to_client(struct ctdb_context *ctdb);
 609
 610 /* From server/ctdb_fork.c */
 611
 612 void ctdb_track_child(struct ctdb_context *ctdb, pid_t pid);
 613
 614 pid_t ctdb_fork(struct ctdb_context *ctdb);
 615 pid_t ctdb_vfork_exec(TALLOC_CTX *mem_ctx, struct ctdb_context *ctdb,
 616                       const char *helper, int helper_argc,
 617                       const char **helper_argv);
 618
 619 struct tevent_signal *ctdb_init_sigchld(struct ctdb_context *ctdb);
 620
 621 int ctdb_kill(struct ctdb_context *ctdb, pid_t pid, int signum);
 622
 623 /* from server/ctdb_freeze.c */
 624
 625 int32_t ctdb_control_db_freeze(struct ctdb_context *ctdb,
 626                                struct ctdb_req_control_old *c,
 627                                uint32_t db_id, bool *async_reply);
 628 int32_t ctdb_control_db_thaw(struct ctdb_context *ctdb, uint32_t db_id);
 629
 630 int32_t ctdb_control_freeze(struct ctdb_context *ctdb,
 631                             struct ctdb_req_control_old *c, bool *async_reply);
 632 int32_t ctdb_control_thaw(struct ctdb_context *ctdb, bool check_recmode);
 633
 634 bool ctdb_blocking_freeze(struct ctdb_context *ctdb);
 635
 636 int32_t ctdb_control_db_transaction_start(struct ctdb_context *ctdb,
 637                                           TDB_DATA indata);
 638 int32_t ctdb_control_db_transaction_cancel(struct ctdb_context *ctdb,
 639                                            TDB_DATA indata);
 640 int32_t ctdb_control_db_transaction_commit(struct ctdb_context *ctdb,
 641                                            TDB_DATA indata);
 642
 643 int32_t ctdb_control_wipe_database(struct ctdb_context *ctdb, TDB_DATA indata);
 644
 645 bool ctdb_db_frozen(struct ctdb_db_context *ctdb_db);
 646 bool ctdb_db_all_frozen(struct ctdb_context *ctdb);
 647 bool ctdb_db_allow_access(struct ctdb_db_context *ctdb_db);
 648
 649 /* from server/ctdb_keepalive.c */
 650
 651 void ctdb_start_keepalive(struct ctdb_context *ctdb);
 652 void ctdb_stop_keepalive(struct ctdb_context *ctdb);
 653
 654 void ctdb_request_keepalive(struct ctdb_context *ctdb,
 655                             struct ctdb_req_header *hdr);
 656
 657 /* from server/ctdb_lock.c */
 658
 659 struct lock_request;
 660
 661 typedef int (*ctdb_db_handler_t)(struct ctdb_db_context *ctdb_db,
 662                                  void *private_data);
 663
 664 int ctdb_db_iterator(struct ctdb_context *ctdb, ctdb_db_handler_t handler,
 665                      void *private_data);
 666
 667 int ctdb_lockdb_mark(struct ctdb_db_context *ctdb_db);
 668
 669 int ctdb_lockdb_unmark(struct ctdb_db_context *ctdb_db);
 670
 671 struct lock_request *ctdb_lock_record(TALLOC_CTX *mem_ctx,
 672                                       struct ctdb_db_context *ctdb_db,
 673                                       TDB_DATA key,
 674                                       bool auto_mark,
 675                                       void (*callback)(void *, bool),
 676                                       void *private_data);
 677
 678 struct lock_request *ctdb_lock_db(TALLOC_CTX *mem_ctx,
 679                                   struct ctdb_db_context *ctdb_db,
 680                                   bool auto_mark,
 681                                   void (*callback)(void *, bool),
 682                                   void *private_data);
 683
 684 /* from ctdb_logging.c */
 685
 686 bool ctdb_logging_init(TALLOC_CTX *mem_ctx, const char *logging,
 687                        const char *debug_level);
 688
 689 int ctdb_set_child_logging(struct ctdb_context *ctdb);
 690
 691 /* from ctdb_logging_file.c */
 692
 693 void ctdb_log_init_file(void);
 694
 695 /* from ctdb_logging_syslog.c */
 696
 697 void ctdb_log_init_syslog(void);
 698
 699 /* from ctdb_ltdb_server.c */
 700
 701 int ctdb_ltdb_lock_requeue(struct ctdb_db_context *ctdb_db,
 702                            TDB_DATA key, struct ctdb_req_header *hdr,
 703                            void (*recv_pkt)(void *, struct ctdb_req_header *),
 704                            void *recv_context, bool ignore_generation);
 705
 706 int ctdb_ltdb_lock_fetch_requeue(struct ctdb_db_context *ctdb_db,
 707                                  TDB_DATA key, struct ctdb_ltdb_header *header,
 708                                  struct ctdb_req_header *hdr, TDB_DATA *data,
 709                                  void (*recv_pkt)(void *, struct ctdb_req_header *),
 710                                  void *recv_context, bool ignore_generation);
 711
 712 int ctdb_load_persistent_health(struct ctdb_context *ctdb,
 713                                 struct ctdb_db_context *ctdb_db);
 714 int ctdb_update_persistent_health(struct ctdb_context *ctdb,
 715                                   struct ctdb_db_context *ctdb_db,
 716                                   const char *reason,/* NULL means healthy */
 717                                   unsigned int num_healthy_nodes);
 718 int ctdb_recheck_persistent_health(struct ctdb_context *ctdb);
 719
 720 int32_t ctdb_control_db_set_healthy(struct ctdb_context *ctdb,
 721                                     TDB_DATA indata);
 722 int32_t ctdb_control_db_get_health(struct ctdb_context *ctdb,
 723                                    TDB_DATA indata, TDB_DATA *outdata);
 724
 725 int ctdb_set_db_readonly(struct ctdb_context *ctdb,
 726                          struct ctdb_db_context *ctdb_db);
 727
 728 int ctdb_process_deferred_attach(struct ctdb_context *ctdb);
 729
 730 int32_t ctdb_control_db_attach(struct ctdb_context *ctdb,
 731                                TDB_DATA indata,
 732                                TDB_DATA *outdata,
 733                                uint8_t db_flags,
 734                                uint32_t srcnode,
 735                                uint32_t client_id,
 736                                struct ctdb_req_control_old *c,
 737                                bool *async_reply);
 738 int32_t ctdb_control_db_detach(struct ctdb_context *ctdb, TDB_DATA indata,
 739                                uint32_t client_id);
 740
 741 int ctdb_attach_databases(struct ctdb_context *ctdb);
 742
 743 int32_t ctdb_ltdb_update_seqnum(struct ctdb_context *ctdb, uint32_t db_id,
 744                                 uint32_t srcnode);
 745 int32_t ctdb_ltdb_enable_seqnum(struct ctdb_context *ctdb, uint32_t db_id);
 746
 747 int ctdb_set_db_sticky(struct ctdb_context *ctdb,
 748                        struct ctdb_db_context *ctdb_db);
 749
 750 void ctdb_db_statistics_reset(struct ctdb_db_context *ctdb_db);
 751
 752 int32_t ctdb_control_get_db_statistics(struct ctdb_context *ctdb,
 753                                        uint32_t db_id, TDB_DATA *outdata);
 754
 755 /* from ctdb_monitor.c */
 756
 757 void ctdb_run_notification_script(struct ctdb_context *ctdb, const char *event);
 758
 759 void ctdb_stop_monitoring(struct ctdb_context *ctdb);
 760
 761 void ctdb_wait_for_first_recovery(struct ctdb_context *ctdb);
 762
 763 int32_t ctdb_control_modflags(struct ctdb_context *ctdb, TDB_DATA indata);
 764
 765 /* from ctdb_persistent.c */
 766
 767 void ctdb_persistent_finish_trans3_commits(struct ctdb_context *ctdb);
 768
 769 int32_t ctdb_control_trans3_commit(struct ctdb_context *ctdb,
 770                                    struct ctdb_req_control_old *c,
 771                                    TDB_DATA recdata, bool *async_reply);
 772
 773 int32_t ctdb_control_start_persistent_update(struct ctdb_context *ctdb,
 774                                              struct ctdb_req_control_old *c,
 775                                              TDB_DATA recdata);
 776 int32_t ctdb_control_cancel_persistent_update(struct ctdb_context *ctdb,
 777                                               struct ctdb_req_control_old *c,
 778                                               TDB_DATA recdata);
 779
 780 int32_t ctdb_control_get_db_seqnum(struct ctdb_context *ctdb,
 781                                    TDB_DATA indata, TDB_DATA *outdata);
 782
 783 /* from ctdb_recover.c */
 784
 785 int ctdb_control_getvnnmap(struct ctdb_context *ctdb, uint32_t opcode,
 786                            TDB_DATA indata, TDB_DATA *outdata);
 787 int ctdb_control_setvnnmap(struct ctdb_context *ctdb, uint32_t opcode,
 788                            TDB_DATA indata, TDB_DATA *outdata);
 789
 790 int ctdb_control_getdbmap(struct ctdb_context *ctdb, uint32_t opcode,
 791                           TDB_DATA indata, TDB_DATA *outdata);
 792 int ctdb_control_getnodemap(struct ctdb_context *ctdb, uint32_t opcode,
 793                             TDB_DATA indata, TDB_DATA *outdata);
 794
 795 int ctdb_control_reload_nodes_file(struct ctdb_context *ctdb, uint32_t opcode);
 796
 797 int32_t ctdb_control_db_pull(struct ctdb_context *ctdb,
 798                              struct ctdb_req_control_old *c,
 799                              TDB_DATA indata, TDB_DATA *outdata);
 800 int32_t ctdb_control_db_push_start(struct ctdb_context *ctdb,
 801                                    TDB_DATA indata);
 802 int32_t ctdb_control_db_push_confirm(struct ctdb_context *ctdb,
 803                                      TDB_DATA indata, TDB_DATA *outdata);
 804
 805 int ctdb_deferred_drop_all_ips(struct ctdb_context *ctdb);
 806
 807 int32_t ctdb_control_set_recmode(struct ctdb_context *ctdb,
 808                                  struct ctdb_req_control_old *c,
 809                                  TDB_DATA indata, bool *async_reply,
 810                                  const char **errormsg);
 811
 812 int32_t ctdb_control_end_recovery(struct ctdb_context *ctdb,
 813                                  struct ctdb_req_control_old *c,
 814                                  bool *async_reply);
 815 int32_t ctdb_control_start_recovery(struct ctdb_context *ctdb,
 816                                  struct ctdb_req_control_old *c,
 817                                  bool *async_reply);
 818
 819 int32_t ctdb_control_try_delete_records(struct ctdb_context *ctdb,
 820                                         TDB_DATA indata, TDB_DATA *outdata);
 821
 822 int32_t ctdb_control_get_capabilities(struct ctdb_context *ctdb,
 823                                       TDB_DATA *outdata);
 824
 825 int32_t ctdb_control_recd_ping(struct ctdb_context *ctdb);
 826 int32_t ctdb_control_set_recmaster(struct ctdb_context *ctdb,
 827                                    uint32_t opcode, TDB_DATA indata);
 828
 829 void ctdb_node_become_inactive(struct ctdb_context *ctdb);
 830
 831 int32_t ctdb_control_stop_node(struct ctdb_context *ctdb);
 832 int32_t ctdb_control_continue_node(struct ctdb_context *ctdb);
 833
 834 /* from ctdb_recoverd.c */
 835
 836 int ctdb_start_recoverd(struct ctdb_context *ctdb);
 837 void ctdb_stop_recoverd(struct ctdb_context *ctdb);
 838
 839 /* from ctdb_server.c */
 840
 841 int ctdb_set_transport(struct ctdb_context *ctdb, const char *transport);
 842
 843 struct ctdb_node *ctdb_ip_to_node(struct ctdb_context *ctdb,
 844                                   const ctdb_sock_addr *nodeip);
 845 uint32_t ctdb_ip_to_pnn(struct ctdb_context *ctdb,
 846                         const ctdb_sock_addr *nodeip);
 847
 848 void ctdb_load_nodes_file(struct ctdb_context *ctdb);
 849
 850 int ctdb_set_address(struct ctdb_context *ctdb, const char *address);
 851
 852 uint32_t ctdb_get_num_active_nodes(struct ctdb_context *ctdb);
 853
 854 void ctdb_input_pkt(struct ctdb_context *ctdb, struct ctdb_req_header *);
 855
 856 void ctdb_node_dead(struct ctdb_node *node);
 857 void ctdb_node_connected(struct ctdb_node *node);
 858
 859 void ctdb_queue_packet(struct ctdb_context *ctdb, struct ctdb_req_header *hdr);
 860 void ctdb_queue_packet_opcode(struct ctdb_context *ctdb,
 861                               struct ctdb_req_header *hdr, unsigned opcode);
 862
 863 /* from ctdb_serverids.c */
 864
 865 int32_t ctdb_control_register_server_id(struct ctdb_context *ctdb,
 866                                         uint32_t client_id, TDB_DATA indata);
 867 int32_t ctdb_control_check_server_id(struct ctdb_context *ctdb,
 868                                      TDB_DATA indata);
 869 int32_t ctdb_control_unregister_server_id(struct ctdb_context *ctdb,
 870                                           TDB_DATA indata);
 871 int32_t ctdb_control_get_server_id_list(struct ctdb_context *ctdb,
 872                                         TDB_DATA *outdata);
 873
 874 /* from ctdb_statistics.c */
 875
 876 int ctdb_statistics_init(struct ctdb_context *ctdb);
 877
 878 int32_t ctdb_control_get_stat_history(struct ctdb_context *ctdb,
 879                                       struct ctdb_req_control_old *c,
 880                                       TDB_DATA *outdata);
 881
 882 /* from ctdb_takeover.c */
 883
 884 int32_t ctdb_control_takeover_ip(struct ctdb_context *ctdb,
 885                                  struct ctdb_req_control_old *c,
 886                                  TDB_DATA indata,
 887                                  bool *async_reply);
 888 int32_t ctdb_control_release_ip(struct ctdb_context *ctdb,
 889                                  struct ctdb_req_control_old *c,
 890                                  TDB_DATA indata,
 891                                  bool *async_reply);
 892 int32_t ctdb_control_ipreallocated(struct ctdb_context *ctdb,
 893                                  struct ctdb_req_control_old *c,
 894                                  bool *async_reply);
 895
 896 int ctdb_set_public_addresses(struct ctdb_context *ctdb, bool check_addresses);
 897
 898 int32_t ctdb_control_tcp_client(struct ctdb_context *ctdb, uint32_t client_id,
 899                                 TDB_DATA indata);
 900 int32_t ctdb_control_tcp_add(struct ctdb_context *ctdb, TDB_DATA indata,
 901                              bool tcp_update_needed);
 902 int32_t ctdb_control_tcp_remove(struct ctdb_context *ctdb, TDB_DATA indata);
 903 int32_t ctdb_control_startup(struct ctdb_context *ctdb, uint32_t vnn);
 904
 905 void ctdb_takeover_client_destructor_hook(struct ctdb_client *client);
 906
 907 void ctdb_release_all_ips(struct ctdb_context *ctdb);
 908
 909 int32_t ctdb_control_get_public_ips(struct ctdb_context *ctdb,
 910                                     struct ctdb_req_control_old *c,
 911                                     TDB_DATA *outdata);
 912 int32_t ctdb_control_get_public_ip_info(struct ctdb_context *ctdb,
 913                                         struct ctdb_req_control_old *c,
 914                                         TDB_DATA indata, TDB_DATA *outdata);
 915
 916 int32_t ctdb_control_get_ifaces(struct ctdb_context *ctdb,
 917                                 struct ctdb_req_control_old *c,
 918                                 TDB_DATA *outdata);
 919 int32_t ctdb_control_set_iface_link(struct ctdb_context *ctdb,
 920                                     struct ctdb_req_control_old *c,
 921                                     TDB_DATA indata);
 922
 923 int32_t ctdb_control_set_tcp_tickle_list(struct ctdb_context *ctdb,
 924                                          TDB_DATA indata);
 925 int32_t ctdb_control_get_tcp_tickle_list(struct ctdb_context *ctdb,
 926                                          TDB_DATA indata, TDB_DATA *outdata);
 927
 928 void ctdb_start_tcp_tickle_update(struct ctdb_context *ctdb);
 929
 930 int32_t ctdb_control_send_gratious_arp(struct ctdb_context *ctdb,
 931                                        TDB_DATA indata);
 932
 933 int32_t ctdb_control_add_public_address(struct ctdb_context *ctdb,
 934                                         TDB_DATA indata);
 935 int32_t ctdb_control_del_public_address(struct ctdb_context *ctdb,
 936                                         TDB_DATA recdata);
 937
 938 int32_t ctdb_control_reload_public_ips(struct ctdb_context *ctdb,
 939                                        struct ctdb_req_control_old *c,
 940                                        bool *async_reply);
 941
 942 /* from ctdb_traverse.c */
 943
 944 int32_t ctdb_control_traverse_all_ext(struct ctdb_context *ctdb,
 945                                       TDB_DATA data, TDB_DATA *outdata);
 946 int32_t ctdb_control_traverse_all(struct ctdb_context *ctdb,
 947                                   TDB_DATA data, TDB_DATA *outdata);
 948 int32_t ctdb_control_traverse_data(struct ctdb_context *ctdb,
 949                                    TDB_DATA data, TDB_DATA *outdata);
 950 int32_t ctdb_control_traverse_kill(struct ctdb_context *ctdb, TDB_DATA indata,
 951                                     TDB_DATA *outdata, uint32_t srcnode);
 952
 953 int32_t ctdb_control_traverse_start_ext(struct ctdb_context *ctdb,
 954                                         TDB_DATA indata, TDB_DATA *outdata,
 955                                         uint32_t srcnode, uint32_t client_id);
 956 int32_t ctdb_control_traverse_start(struct ctdb_context *ctdb,
 957                                     TDB_DATA indata, TDB_DATA *outdata,
 958                                     uint32_t srcnode, uint32_t client_id);
 959
 960 /* from ctdb_tunables.c */
 961
 962 void ctdb_tunables_set_defaults(struct ctdb_context *ctdb);
 963
 964 int32_t ctdb_control_get_tunable(struct ctdb_context *ctdb, TDB_DATA indata,
 965                                  TDB_DATA *outdata);
 966 int32_t ctdb_control_set_tunable(struct ctdb_context *ctdb, TDB_DATA indata);
 967 int32_t ctdb_control_list_tunables(struct ctdb_context *ctdb,
 968                                    TDB_DATA *outdata);
 969
 970 /* from ctdb_tunnel.c */
 971
 972 int32_t ctdb_control_tunnel_register(struct ctdb_context *ctdb,
 973                                      uint32_t client_id, uint64_t tunnel_id);
 974 int32_t ctdb_control_tunnel_deregister(struct ctdb_context *ctdb,
 975                                        uint32_t client_id, uint64_t tunnel_id);
 976
 977 int ctdb_daemon_send_tunnel(struct ctdb_context *ctdb, uint32_t destnode,
 978                             uint64_t tunnel_id, uint32_t client_id,
 979                             TDB_DATA data);
 980
 981 void ctdb_request_tunnel(struct ctdb_context *ctdb,
 982                          struct ctdb_req_header *hdr);
 983
 984 /* from ctdb_update_record.c */
 985
 986 int32_t ctdb_control_update_record(struct ctdb_context *ctdb,
 987                                    struct ctdb_req_control_old *c,
 988                                    TDB_DATA recdata, bool *async_reply);
 989
 990 /* from ctdb_uptime.c */
 991
 992 int32_t ctdb_control_uptime(struct ctdb_context *ctdb, TDB_DATA *outdata);
 993
 994 /* from ctdb_vacuum.c */
 995
 996 int32_t ctdb_control_db_vacuum(struct ctdb_context *ctdb,
 997                                struct ctdb_req_control_old *c,
 998                                TDB_DATA indata,
 999                                bool *async_reply);
1000
1001 void ctdb_stop_vacuuming(struct ctdb_context *ctdb);
1002 int ctdb_vacuum_init(struct ctdb_db_context *ctdb_db);
1003
1004 int32_t ctdb_control_schedule_for_deletion(struct ctdb_context *ctdb,
1005                                            TDB_DATA indata);
1006 int32_t ctdb_local_schedule_for_deletion(struct ctdb_db_context *ctdb_db,
1007                                          const struct ctdb_ltdb_header *hdr,
1008                                          TDB_DATA key);
1009
1010 void ctdb_local_remove_from_delete_queue(struct ctdb_db_context *ctdb_db,
1011                                          const struct ctdb_ltdb_header *hdr,
1012                                          const TDB_DATA key);
1013
1014 int32_t ctdb_control_vacuum_fetch(struct ctdb_context *ctdb, TDB_DATA indata);
1015
1016 /* from eventscript.c */
1017
1018 int ctdb_start_eventd(struct ctdb_context *ctdb);
1019 void ctdb_stop_eventd(struct ctdb_context *ctdb);
1020
1021 int ctdb_event_script_callback(struct ctdb_context *ctdb,
1022                                TALLOC_CTX *mem_ctx,
1023                                void (*callback)(struct ctdb_context *,
1024                                                 int, void *),
1025                                void *private_data,
1026                                enum ctdb_event call,
1027                                const char *fmt, ...) PRINTF_ATTRIBUTE(6,7);
1028
1029 int ctdb_event_script_args(struct ctdb_context *ctdb,
1030                            enum ctdb_event call,
1031                            const char *fmt, ...) PRINTF_ATTRIBUTE(3,4);
1032
1033 int ctdb_event_script(struct ctdb_context *ctdb,
1034                       enum ctdb_event call);
1035
1036 #endif