git.m6w6.name Git - m6w6/libmemcached/blob - libmemcached/server.h

   1 /* LibMemcached
   2  * Copyright (C) 2006-2009 Brian Aker
   3  * All rights reserved.
   4  *
   5  * Use and distribution licensed under the BSD license.  See
   6  * the COPYING file in the parent directory for full text.
   7  *
   8  * Summary: String structure used for libmemcached.
   9  *
  10  */
  11
  12 #ifndef __LIBMEMCACHED_SERVER_H__
  13 #define __LIBMEMCACHED_SERVER_H__
  14
  15
  16 struct memcached_server_st {
  17   struct {
  18     bool is_allocated MEMCACHED_BITFIELD;
  19     bool is_initialized MEMCACHED_BITFIELD;
  20     bool sockaddr_inited MEMCACHED_BITFIELD;
  21     bool is_shutting_down MEMCACHED_BITFIELD;
  22   } options;
  23   uint32_t number_of_hosts;
  24   uint32_t cursor_active;
  25   in_port_t port;
  26   int cached_errno;
  27   int fd;
  28   uint32_t io_bytes_sent; /* # bytes sent since last read */
  29   uint32_t server_failure_counter;
  30   uint32_t weight;
  31   struct { // Place any "state" sort variables in here.
  32     bool is_corked;
  33   } state;
  34   uint8_t major_version;
  35   uint8_t micro_version;
  36   uint8_t minor_version;
  37   memcached_connection_t type;
  38   char *read_ptr;
  39   char *cached_server_error;
  40   size_t read_buffer_length;
  41   size_t read_data_length;
  42   size_t write_buffer_offset;
  43   struct addrinfo *address_info;
  44   time_t next_retry;
  45   const memcached_st *root;
  46   uint64_t limit_maxbytes;
  47   char read_buffer[MEMCACHED_MAX_BUFFER];
  48   char write_buffer[MEMCACHED_MAX_BUFFER];
  49   char hostname[NI_MAXHOST];
  50 };
  51
  52
  53 #ifdef __cplusplus
  54 extern "C" {
  55 #endif
  56
  57 LIBMEMCACHED_API
  58 memcached_return_t memcached_server_cursor(const memcached_st *ptr,
  59                                            const memcached_server_fn *callback,
  60                                            void *context,
  61                                            uint32_t number_of_callbacks);
  62
  63 LIBMEMCACHED_API
  64   const memcached_server_st *memcached_server_by_key(const memcached_st *ptr,
  65                                                      const char *key,
  66                                                      size_t key_length,
  67                                                      memcached_return_t *error);
  68
  69 LIBMEMCACHED_API
  70 const char *memcached_server_error(const memcached_server_st *ptr);
  71
  72 LIBMEMCACHED_API
  73 void memcached_server_error_reset(memcached_server_st *ptr);
  74
  75 LIBMEMCACHED_API
  76 void memcached_server_free(memcached_server_st *ptr);
  77
  78 LIBMEMCACHED_LOCAL
  79 memcached_server_st *memcached_server_clone(memcached_server_st *destination,
  80                                             const memcached_server_st *source);
  81
  82 LIBMEMCACHED_API
  83 memcached_return_t memcached_server_remove(memcached_server_st *st_ptr);
  84
  85 LIBMEMCACHED_API
  86 memcached_server_st *memcached_server_get_last_disconnect(memcached_st *ptr);
  87
  88
  89 LIBMEMCACHED_API
  90 memcached_return_t memcached_server_add_udp(memcached_st *ptr,
  91                                             const char *hostname,
  92                                             in_port_t port);
  93 LIBMEMCACHED_API
  94 memcached_return_t memcached_server_add_unix_socket(memcached_st *ptr,
  95                                                     const char *filename);
  96 LIBMEMCACHED_API
  97 memcached_return_t memcached_server_add(memcached_st *ptr,
  98                                         const char *hostname, in_port_t port);
  99
 100 LIBMEMCACHED_API
 101 memcached_return_t memcached_server_add_udp_with_weight(memcached_st *ptr,
 102                                                         const char *hostname,
 103                                                         in_port_t port,
 104                                                         uint32_t weight);
 105 LIBMEMCACHED_API
 106 memcached_return_t memcached_server_add_unix_socket_with_weight(memcached_st *ptr,
 107                                                                 const char *filename,
 108                                                                 uint32_t weight);
 109 LIBMEMCACHED_API
 110 memcached_return_t memcached_server_add_with_weight(memcached_st *ptr, const char *hostname,
 111                                                     in_port_t port,
 112                                                     uint32_t weight);
 113 /* Server List Public functions */
 114
 115 LIBMEMCACHED_API
 116 void memcached_server_list_free(memcached_server_st *ptr);
 117
 118
 119 LIBMEMCACHED_API
 120 memcached_return_t memcached_server_push(memcached_st *ptr, const memcached_server_st *list);
 121
 122 LIBMEMCACHED_API
 123 memcached_server_st *memcached_server_list_append(memcached_server_st *ptr,
 124                                                   const char *hostname,
 125                                                   in_port_t port,
 126                                                   memcached_return_t *error);
 127 LIBMEMCACHED_API
 128 memcached_server_st *memcached_server_list_append_with_weight(memcached_server_st *ptr,
 129                                                               const char *hostname,
 130                                                               in_port_t port,
 131                                                               uint32_t weight,
 132                                                               memcached_return_t *error);
 133 LIBMEMCACHED_API
 134 uint32_t memcached_server_list_count(const memcached_server_st *ptr);
 135
 136 LIBMEMCACHED_API
 137 uint32_t memcached_server_count(const memcached_st *);
 138
 139
 140 LIBMEMCACHED_LOCAL
 141 uint32_t memcached_servers_set_count(memcached_server_st *servers, uint32_t count);
 142
 143 LIBMEMCACHED_API
 144 memcached_server_st *memcached_server_list(memcached_st *);
 145
 146 LIBMEMCACHED_LOCAL
 147 void memcached_server_list_set(memcached_st *self, memcached_server_st *list);
 148
 149 LIBMEMCACHED_API
 150 uint32_t memcached_server_response_count(const memcached_server_st *self);
 151
 152 LIBMEMCACHED_API
 153 const char *memcached_server_name(const memcached_server_st *self);
 154
 155 LIBMEMCACHED_API
 156 in_port_t memcached_server_port(const memcached_server_st *self);
 157
 158
 159 #ifdef __cplusplus
 160 } // extern "C"
 161 #endif
 162
 163 #endif /* __LIBMEMCACHED_SERVER_H__ */