2 * Copyright (C) 2006-2009 Brian Aker
5 * Use and distribution licensed under the BSD license. See
6 * the COPYING file in the parent directory for full text.
8 * Summary: String structure used for libmemcached.
13 This is a partial implementation for fetching/creating memcached_server_st objects.
17 static inline void _server_init(memcached_server_st
*self
, const memcached_st
*root
,
18 const char *hostname
, in_port_t port
,
19 uint32_t weight
, memcached_connection_t type
)
21 self
->options
.sockaddr_inited
= false;
22 self
->options
.is_shutting_down
= false;
23 self
->number_of_hosts
= 0;
24 self
->cursor_active
= 0;
26 self
->cached_errno
= 0;
28 self
->io_bytes_sent
= 0;
29 self
->server_failure_counter
= 0;
31 self
->state
.is_corked
= false;
32 self
->major_version
= 0;
33 self
->micro_version
= 0;
34 self
->minor_version
= 0;
36 self
->read_ptr
= self
->read_buffer
;
37 self
->cached_server_error
= NULL
;
38 self
->read_buffer_length
= 0;
39 self
->read_data_length
= 0;
40 self
->write_buffer_offset
= 0;
41 self
->address_info
= NULL
;
45 self
->next_retry
= root
->retry_timeout
;
53 self
->limit_maxbytes
= 0;
57 strncpy(self
->hostname
, hostname
, NI_MAXHOST
- 1);
60 static memcached_server_st
*_server_create(memcached_server_st
*self
, const memcached_st
*memc
)
64 self
= (memcached_server_st
*)libmemcached_malloc(memc
, sizeof(memcached_server_st
));
67 return NULL
; /* MEMCACHED_MEMORY_ALLOCATION_FAILURE */
69 self
->options
.is_allocated
= true;
73 self
->options
.is_allocated
= false;
76 self
->options
.is_initialized
= true;
81 memcached_server_st
*memcached_server_create_with(const memcached_st
*memc
,
82 memcached_server_write_instance_st self
,
83 const char *hostname
, in_port_t port
,
84 uint32_t weight
, memcached_connection_t type
)
86 self
= _server_create(self
, memc
);
91 _server_init(self
, memc
, hostname
, port
, weight
, type
);
94 if (type
== MEMCACHED_CONNECTION_UDP
)
96 self
->write_buffer_offset
= UDP_DATAGRAM_HEADER_LENGTH
;
97 memcached_io_init_udp_header(self
, 0);
103 void memcached_server_free(memcached_server_st
*self
)
105 memcached_quit_server(self
, false);
107 if (self
->cached_server_error
)
108 free(self
->cached_server_error
);
110 if (self
->address_info
)
111 freeaddrinfo(self
->address_info
);
113 if (memcached_is_allocated(self
))
115 libmemcached_free(self
->root
, self
);
119 self
->options
.is_initialized
= false;
124 If we do not have a valid object to clone from, we toss an error.
126 memcached_server_st
*memcached_server_clone(memcached_server_st
*destination
,
127 const memcached_server_st
*source
)
129 /* We just do a normal create if source is missing */
133 destination
= memcached_server_create_with(source
->root
, destination
,
134 source
->hostname
, source
->port
, source
->weight
,
136 if (destination
!= NULL
)
138 destination
->cached_errno
= source
->cached_errno
;
140 if (source
->cached_server_error
)
141 destination
->cached_server_error
= strdup(source
->cached_server_error
);
148 memcached_return_t
memcached_server_cursor(const memcached_st
*ptr
,
149 const memcached_server_fn
*callback
,
151 uint32_t number_of_callbacks
)
153 for (uint32_t x
= 0; x
< memcached_server_count(ptr
); x
++)
155 memcached_server_instance_st instance
=
156 memcached_server_instance_by_position(ptr
, x
);
158 for (uint32_t y
= 0; y
< number_of_callbacks
; y
++)
160 unsigned int iferror
;
162 iferror
= (*callback
[y
])(ptr
, instance
, context
);
169 return MEMCACHED_SUCCESS
;
172 memcached_server_instance_st
memcached_server_by_key(const memcached_st
*ptr
,
175 memcached_return_t
*error
)
178 memcached_server_instance_st instance
;
180 *error
= memcached_validate_key_length(key_length
,
181 ptr
->flags
.binary_protocol
);
182 unlikely (*error
!= MEMCACHED_SUCCESS
)
185 unlikely (memcached_server_count(ptr
) == 0)
187 *error
= MEMCACHED_NO_SERVERS
;
191 if (ptr
->flags
.verify_key
&& (memcached_key_test((const char **)&key
, &key_length
, 1) == MEMCACHED_BAD_KEY_PROVIDED
))
193 *error
= MEMCACHED_BAD_KEY_PROVIDED
;
197 server_key
= memcached_generate_hash(ptr
, key
, key_length
);
198 instance
= memcached_server_instance_by_position(ptr
, server_key
);
204 void memcached_server_error_reset(memcached_server_st
*ptr
)
206 ptr
->cached_server_error
[0]= 0;
209 memcached_server_instance_st
memcached_server_get_last_disconnect(const memcached_st
*ptr
)
211 return ptr
->last_disconnected_server
;
214 inline uint32_t memcached_server_list_count(const memcached_server_st
*self
)
216 return (self
== NULL
)
218 : self
->number_of_hosts
;
221 void memcached_server_list_free(memcached_server_st
*self
)
223 server_list_free(NULL
, self
);
227 @todo allow lists to query themselves even if they lack a root
229 memcached_return_t
memcached_server_remove(memcached_server_st
*self
)
231 uint32_t host_index
= 0;
232 memcached_st
*root
= (memcached_st
*)self
->root
;
233 memcached_server_st
*list
;
236 return MEMCACHED_FAILURE
;
238 list
= memcached_server_list(root
);
240 /* Until we devise a way to mark servers that are about to be harvested, we need to shutdown before doing the clone. */
241 memcached_quit(root
);
243 for (uint32_t x
= 0; x
< memcached_server_count(root
); x
++)
245 if (strncmp(list
[x
].hostname
, self
->hostname
, NI_MAXHOST
) != 0 || list
[x
].port
!= self
->port
)
249 memcached_server_st
*check
=
250 memcached_server_clone(list
+host_index
, list
+x
);
252 if (! check
) // Now we are in trouble, allocation didn't happen and we are midway through an operation. Bail!
254 return MEMCACHED_FAILURE
;
256 memcached_server_free(list
+x
);
261 root
->number_of_hosts
= host_index
;
263 run_distribution(root
);
265 return MEMCACHED_SUCCESS
;
269 inline uint32_t memcached_servers_set_count(memcached_server_st
*servers
, uint32_t count
)
271 return servers
->number_of_hosts
= count
;
274 inline uint32_t memcached_server_count(const memcached_st
*self
)
276 return self
->number_of_hosts
;
279 inline const char *memcached_server_name(memcached_server_instance_st self
)
281 return self
->hostname
;
284 inline in_port_t
memcached_server_port(memcached_server_instance_st self
)
289 inline memcached_server_st
*memcached_server_list(memcached_st
*self
)
291 return self
->servers
;
294 inline void memcached_server_list_set(memcached_st
*self
, memcached_server_st
*list
)
299 inline uint32_t memcached_server_response_count(memcached_server_instance_st self
)
301 return self
->cursor_active
;
304 const char *memcached_server_error(memcached_server_instance_st ptr
)
307 ? ptr
->cached_server_error