source3/include/ctdbd_conn.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Samba3 ctdb connection handling
   4    Copyright (C) Volker Lendecke 2007
   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 _CTDBD_CONN_H
  21 #define _CTDBD_CONN_H
  22
  23 #include "replace.h"
  24 #include "system/filesys.h"
  25 #include "system/network.h"
  26 #include "lib/dbwrap/dbwrap.h"
  27 #include <tdb.h>
  28 #include <tevent.h>
  29
  30 struct ctdbd_connection;
  31 struct messaging_context;
  32 struct messaging_rec;
  33
  34 int ctdbd_init_connection(TALLOC_CTX *mem_ctx,
  35                           const char *sockname, int timeout,
  36                           struct ctdbd_connection **pconn);
  37 int ctdbd_init_async_connection(
  38         TALLOC_CTX *mem_ctx,
  39         const char *sockname,
  40         int timeout,
  41         struct ctdbd_connection **pconn);
  42 int ctdbd_reinit_connection(TALLOC_CTX *mem_ctx,
  43                             const char *sockname, int timeout,
  44                             struct ctdbd_connection *conn);
  45
  46 uint32_t ctdbd_vnn(const struct ctdbd_connection *conn);
  47
  48 int ctdbd_conn_get_fd(struct ctdbd_connection *conn);
  49 void ctdbd_socket_readable(struct tevent_context *ev,
  50                            struct ctdbd_connection *conn);
  51
  52 int ctdbd_messaging_send_iov(struct ctdbd_connection *conn,
  53                              uint32_t dst_vnn, uint64_t dst_srvid,
  54                              const struct iovec *iov, int iovlen);
  55
  56 bool ctdbd_process_exists(struct ctdbd_connection *conn, uint32_t vnn,
  57                           pid_t pid, uint64_t unique_id);
  58
  59 char *ctdbd_dbpath(struct ctdbd_connection *conn,
  60                    TALLOC_CTX *mem_ctx, uint32_t db_id);
  61
  62 int ctdbd_db_attach(struct ctdbd_connection *conn, const char *name,
  63                     uint32_t *db_id, bool persistent);
  64
  65 int ctdbd_migrate(struct ctdbd_connection *conn, uint32_t db_id, TDB_DATA key);
  66
  67 int ctdbd_parse(struct ctdbd_connection *conn, uint32_t db_id,
  68                 TDB_DATA key, bool local_copy,
  69                 void (*parser)(TDB_DATA key, TDB_DATA data,
  70                                void *private_data),
  71                 void *private_data);
  72
  73 int ctdbd_traverse(struct ctdbd_connection *master, uint32_t db_id,
  74                    void (*fn)(TDB_DATA key, TDB_DATA data,
  75                               void *private_data),
  76                    void *private_data);
  77
  78 int ctdbd_register_ips(struct ctdbd_connection *conn,
  79                        const struct sockaddr_storage *server,
  80                        const struct sockaddr_storage *client,
  81                        int (*cb)(struct tevent_context *ev,
  82                                  uint32_t src_vnn, uint32_t dst_vnn,
  83                                  uint64_t dst_srvid,
  84                                  const uint8_t *msg, size_t msglen,
  85                                  void *private_data),
  86                        void *private_data);
  87 void ctdbd_unregister_ips(struct ctdbd_connection *conn,
  88                           const struct sockaddr_storage *_server,
  89                           const struct sockaddr_storage *_client,
  90                           int (*cb)(struct tevent_context *ev,
  91                                     uint32_t src_vnn,
  92                                     uint32_t dst_vnn,
  93                                     uint64_t dst_srvid,
  94                                     const uint8_t *msg,
  95                                     size_t msglen,
  96                                     void *private_data),
  97                           void *private_data);
  98
  99 /*
 100  * call @cb for each public IP. If @cb returns non-zero, then break the loop
 101  * and propagate the return value upwards.
 102  * @returns: 0 on success, where all @cb invocations also returned zero
 103  *           ENOMEM on memory allocation failure
 104  *           EIO on ctdbd connection failure
 105  *           @cb() return value if non-zero
 106  */
 107 int ctdbd_public_ip_foreach(struct ctdbd_connection *conn,
 108                             int (*cb)(uint32_t total_ip_count,
 109                                       const struct sockaddr_storage *ip,
 110                                       bool is_movable_ip,
 111                                       void *private_data),
 112                             void *private_data);
 113
 114 int ctdbd_control_local(struct ctdbd_connection *conn, uint32_t opcode,
 115                         uint64_t srvid, uint32_t flags, TDB_DATA data,
 116                         TALLOC_CTX *mem_ctx, TDB_DATA *outdata,
 117                         int32_t *cstatus);
 118 int ctdb_watch_us(struct ctdbd_connection *conn);
 119 int ctdb_unwatch(struct ctdbd_connection *conn);
 120
 121 struct ctdb_req_message_old;
 122
 123 int register_with_ctdbd(struct ctdbd_connection *conn, uint64_t srvid,
 124                         int (*cb)(struct tevent_context *ev,
 125                                   uint32_t src_vnn, uint32_t dst_vnn,
 126                                   uint64_t dst_srvid,
 127                                   const uint8_t *msg, size_t msglen,
 128                                   void *private_data),
 129                         void *private_data);
 130 void deregister_from_ctdbd(struct ctdbd_connection *conn,
 131                            uint64_t srvid,
 132                            int (*cb)(struct tevent_context *ev,
 133                                      uint32_t src_vnn,
 134                                      uint32_t dst_vnn,
 135                                      uint64_t dst_srvid,
 136                                      const uint8_t *msg,
 137                                      size_t msglen,
 138                                      void *private_data),
 139                            void *private_data);
 140 int ctdbd_probe(const char *sockname, int timeout);
 141
 142 struct ctdb_req_header;
 143 void ctdbd_prep_hdr_next_reqid(
 144         struct ctdbd_connection *conn, struct ctdb_req_header *hdr);
 145
 146 /*
 147  * Async ctdb_request. iov[0] must start with an initialized
 148  * struct ctdb_req_header
 149  */
 150 struct tevent_req *ctdbd_req_send(
 151         TALLOC_CTX *mem_ctx,
 152         struct tevent_context *ev,
 153         struct ctdbd_connection *conn,
 154         struct iovec *iov,
 155         size_t num_iov);
 156 int ctdbd_req_recv(
 157         struct tevent_req *req,
 158         TALLOC_CTX *mem_ctx,
 159         struct ctdb_req_header **reply);
 160
 161 struct tevent_req *ctdbd_parse_send(TALLOC_CTX *mem_ctx,
 162                                     struct tevent_context *ev,
 163                                     struct ctdbd_connection *conn,
 164                                     uint32_t db_id,
 165                                     TDB_DATA key,
 166                                     bool local_copy,
 167                                     void (*parser)(TDB_DATA key,
 168                                                    TDB_DATA data,
 169                                                    void *private_data),
 170                                     void *private_data,
 171                                     enum dbwrap_req_state *req_state);
 172 int ctdbd_parse_recv(struct tevent_req *req);
 173
 174 #endif /* _CTDBD_CONN_H */