1 /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
5 * Copyright (C) 2011 Data Differential, http://datadifferential.com/
6 * Copyright (C) 2006-2009 Brian Aker All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * * Redistributions in binary form must reproduce the above
16 * copyright notice, this list of conditions and the following disclaimer
17 * in the documentation and/or other materials provided with the
20 * * The names of its contributors may not be used to endorse or
21 * promote products derived from this software without specific prior
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
27 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
28 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
29 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 #include <libmemcached/common.h>
39 #include <libmemcached/options.hpp>
40 #include <libmemcached/virtual_bucket.h>
43 #include <sys/types.h>
45 bool memcached_is_consistent_distribution(const Memcached
* memc
)
47 switch (memc
->distribution
)
49 case MEMCACHED_DISTRIBUTION_CONSISTENT
:
50 case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA
:
51 case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA_SPY
:
52 case MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED
:
55 case MEMCACHED_DISTRIBUTION_MODULA
:
56 case MEMCACHED_DISTRIBUTION_RANDOM
:
57 case MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET
:
58 case MEMCACHED_DISTRIBUTION_CONSISTENT_MAX
:
66 This function is used to modify the behavior of running client.
68 We quit all connections so we can reset the sockets.
71 memcached_return_t
memcached_behavior_set(memcached_st
*shell
,
72 const memcached_behavior_t flag
,
75 Memcached
* ptr
= memcached2Memcached(shell
);
78 return MEMCACHED_INVALID_ARGUMENTS
;
83 case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS
:
84 ptr
->number_of_replicas
= (uint32_t)data
;
87 case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK
:
88 ptr
->io_msg_watermark
= (uint32_t) data
;
91 case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK
:
92 ptr
->io_bytes_watermark
= (uint32_t)data
;
95 case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH
:
96 ptr
->io_key_prefetch
= (uint32_t)data
;
99 case MEMCACHED_BEHAVIOR_SND_TIMEOUT
:
100 ptr
->snd_timeout
= (int32_t)data
;
103 case MEMCACHED_BEHAVIOR_RCV_TIMEOUT
:
104 ptr
->rcv_timeout
= (int32_t)data
;
107 case MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS
:
108 ptr
->flags
.auto_eject_hosts
= bool(data
);
110 case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT
:
113 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
114 memcached_literal_param("MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT requires a value greater then zero."));
116 ptr
->server_failure_limit
= uint32_t(data
);
119 case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL
:
120 send_quit(ptr
); // We need t shutdown all of the connections to make sure we do the correct protocol
123 ptr
->flags
.verify_key
= false;
125 ptr
->flags
.binary_protocol
= bool(data
);
128 case MEMCACHED_BEHAVIOR_SUPPORT_CAS
:
129 ptr
->flags
.support_cas
= bool(data
);
132 case MEMCACHED_BEHAVIOR_NO_BLOCK
:
133 ptr
->flags
.no_block
= bool(data
);
137 case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS
:
138 if (memcached_is_udp(ptr
))
140 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
141 memcached_literal_param("MEMCACHED_BEHAVIOR_BUFFER_REQUESTS cannot be set while MEMCACHED_BEHAVIOR_USE_UDP is enabled."));
143 ptr
->flags
.buffer_requests
= bool(data
);
147 case MEMCACHED_BEHAVIOR_USE_UDP
:
148 send_quit(ptr
); // We need t shutdown all of the connections to make sure we do the correct protocol
149 ptr
->flags
.use_udp
= bool(data
);
152 ptr
->flags
.reply
= false;
153 ptr
->flags
.buffer_requests
= false;
157 ptr
->flags
.reply
= true;
161 case MEMCACHED_BEHAVIOR_TCP_NODELAY
:
162 ptr
->flags
.tcp_nodelay
= bool(data
);
166 case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
:
167 ptr
->flags
.tcp_keepalive
= bool(data
);
171 case MEMCACHED_BEHAVIOR_DISTRIBUTION
:
172 return memcached_behavior_set_distribution(ptr
, (memcached_server_distribution_t
)data
);
174 case MEMCACHED_BEHAVIOR_KETAMA
:
178 return memcached_behavior_set_distribution(ptr
, MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA
);
181 return memcached_behavior_set_distribution(ptr
, MEMCACHED_DISTRIBUTION_MODULA
);
184 case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED
:
186 if (bool(data
) == false)
188 return memcached_behavior_set(ptr
, MEMCACHED_BEHAVIOR_KETAMA
, true);
191 (void)memcached_behavior_set_key_hash(ptr
, MEMCACHED_HASH_MD5
);
192 (void)memcached_behavior_set_distribution_hash(ptr
, MEMCACHED_HASH_MD5
);
194 @note We try to keep the same distribution going. This should be deprecated and rewritten.
196 return memcached_behavior_set_distribution(ptr
, MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED
);
199 case MEMCACHED_BEHAVIOR_HASH
:
200 return memcached_behavior_set_key_hash(ptr
, (memcached_hash_t
)(data
));
202 case MEMCACHED_BEHAVIOR_KETAMA_HASH
:
203 return memcached_behavior_set_distribution_hash(ptr
, (memcached_hash_t
)(data
));
205 case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS
:
206 return memcached_set_error(*ptr
, MEMCACHED_DEPRECATED
, MEMCACHED_AT
,
207 memcached_literal_param("MEMCACHED_BEHAVIOR_CACHE_LOOKUPS has been deprecated."));
209 case MEMCACHED_BEHAVIOR_VERIFY_KEY
:
210 if (ptr
->flags
.binary_protocol
)
212 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
213 memcached_literal_param("MEMCACHED_BEHAVIOR_VERIFY_KEY if the binary protocol has been enabled."));
215 ptr
->flags
.verify_key
= bool(data
);
218 case MEMCACHED_BEHAVIOR_SORT_HOSTS
:
220 ptr
->flags
.use_sort_hosts
= bool(data
);
221 return run_distribution(ptr
);
224 case MEMCACHED_BEHAVIOR_POLL_TIMEOUT
:
225 ptr
->poll_timeout
= (int32_t)data
;
228 case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT
:
229 ptr
->connect_timeout
= (int32_t)data
;
232 case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT
:
233 ptr
->retry_timeout
= int32_t(data
);
236 case MEMCACHED_BEHAVIOR_DEAD_TIMEOUT
:
237 ptr
->dead_timeout
= int32_t(data
);
240 case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
:
241 ptr
->send_size
= (int32_t)data
;
245 case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE
:
246 ptr
->recv_size
= (int32_t)data
;
250 case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE
:
251 ptr
->tcp_keepidle
= (uint32_t)data
;
255 case MEMCACHED_BEHAVIOR_USER_DATA
:
256 return memcached_set_error(*ptr
, MEMCACHED_DEPRECATED
, MEMCACHED_AT
,
257 memcached_literal_param("MEMCACHED_BEHAVIOR_USER_DATA deprecated."));
259 case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY
:
260 ptr
->flags
.hash_with_namespace
= bool(data
);
263 case MEMCACHED_BEHAVIOR_NOREPLY
:
264 if (memcached_is_udp(ptr
) and bool(data
) == false)
266 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
267 memcached_literal_param("MEMCACHED_BEHAVIOR_NOREPLY cannot be disabled while MEMCACHED_BEHAVIOR_USE_UDP is enabled."));
269 // We reverse the logic here to make it easier to understand throughout the
271 ptr
->flags
.reply
= bool(data
) ? false : true;
274 case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS
:
275 ptr
->flags
.auto_eject_hosts
= bool(data
);
278 case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ
:
279 srandom((uint32_t) time(NULL
));
280 ptr
->flags
.randomize_replica_read
= bool(data
);
283 case MEMCACHED_BEHAVIOR_CORK
:
284 return memcached_set_error(*ptr
, MEMCACHED_DEPRECATED
, MEMCACHED_AT
,
285 memcached_literal_param("MEMCACHED_BEHAVIOR_CORK is now incorporated into the driver by default."));
287 case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE
:
288 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
289 memcached_literal_param("MEMCACHED_BEHAVIOR_LOAD_FROM_FILE can not be set with memcached_behavior_set()"));
291 case MEMCACHED_BEHAVIOR_MAX
:
293 /* Shouldn't get here */
294 assert_msg(0, "Invalid behavior passed to memcached_behavior_set()");
295 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
296 memcached_literal_param("Invalid behavior passed to memcached_behavior_set()"));
299 return MEMCACHED_SUCCESS
;
302 bool _is_auto_eject_host(const memcached_st
*ptr
)
304 return ptr
->flags
.auto_eject_hosts
;
307 uint64_t memcached_behavior_get(memcached_st
*shell
,
308 const memcached_behavior_t flag
)
310 Memcached
* ptr
= memcached2Memcached(shell
);
313 return MEMCACHED_INVALID_ARGUMENTS
;
318 case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS
:
319 return ptr
->number_of_replicas
;
321 case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK
:
322 return ptr
->io_msg_watermark
;
324 case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK
:
325 return ptr
->io_bytes_watermark
;
327 case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH
:
328 return ptr
->io_key_prefetch
;
330 case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL
:
331 return ptr
->flags
.binary_protocol
;
333 case MEMCACHED_BEHAVIOR_SUPPORT_CAS
:
334 return ptr
->flags
.support_cas
;
336 case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS
:
339 case MEMCACHED_BEHAVIOR_NO_BLOCK
:
340 return ptr
->flags
.no_block
;
342 case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS
:
343 return ptr
->flags
.buffer_requests
;
345 case MEMCACHED_BEHAVIOR_USE_UDP
:
346 return memcached_is_udp(ptr
);
348 case MEMCACHED_BEHAVIOR_TCP_NODELAY
:
349 return ptr
->flags
.tcp_nodelay
;
351 case MEMCACHED_BEHAVIOR_VERIFY_KEY
:
352 return ptr
->flags
.verify_key
;
354 case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED
:
355 if (memcached_is_consistent_distribution(ptr
))
357 return memcached_is_weighted_ketama(ptr
);
361 case MEMCACHED_BEHAVIOR_DISTRIBUTION
:
362 return ptr
->distribution
;
364 case MEMCACHED_BEHAVIOR_KETAMA
:
365 return memcached_is_consistent_distribution(ptr
);
367 case MEMCACHED_BEHAVIOR_HASH
:
368 return hashkit_get_function(&ptr
->hashkit
);
370 case MEMCACHED_BEHAVIOR_KETAMA_HASH
:
371 return hashkit_get_function(&ptr
->hashkit
);
373 case MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS
:
374 case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT
:
375 return ptr
->server_failure_limit
;
377 case MEMCACHED_BEHAVIOR_SORT_HOSTS
:
378 return ptr
->flags
.use_sort_hosts
;
380 case MEMCACHED_BEHAVIOR_POLL_TIMEOUT
:
381 return (uint64_t)ptr
->poll_timeout
;
383 case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT
:
384 return (uint64_t)ptr
->connect_timeout
;
386 case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT
:
387 return (uint64_t)ptr
->retry_timeout
;
389 case MEMCACHED_BEHAVIOR_DEAD_TIMEOUT
:
390 return uint64_t(ptr
->dead_timeout
);
392 case MEMCACHED_BEHAVIOR_SND_TIMEOUT
:
393 return (uint64_t)ptr
->snd_timeout
;
395 case MEMCACHED_BEHAVIOR_RCV_TIMEOUT
:
396 return (uint64_t)ptr
->rcv_timeout
;
398 case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE
:
399 return (uint64_t)ptr
->tcp_keepidle
;
401 case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
:
404 socklen_t sock_length
= sizeof(int);
406 if (ptr
->send_size
!= -1) // If value is -1 then we are using the default
408 return (uint64_t) ptr
->send_size
;
411 memcached_instance_st
* instance
= memcached_instance_fetch(ptr
, 0);
413 if (instance
) // If we have an instance we test, otherwise we just set and pray
416 /* We just try the first host, and if it is down we return zero */
417 if (memcached_failed(memcached_connect(instance
)))
422 if (memcached_failed(memcached_io_wait_for_write(instance
)))
427 if (getsockopt(instance
->fd
, SOL_SOCKET
, SO_SNDBUF
, (char*)&sock_size
, &sock_length
) < 0)
429 memcached_set_errno(*ptr
, get_socket_errno(), MEMCACHED_AT
);
430 return 0; /* Zero means error */
434 return (uint64_t) sock_size
;
437 case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE
:
440 socklen_t sock_length
= sizeof(int);
442 if (ptr
->recv_size
!= -1) // If value is -1 then we are using the default
443 return (uint64_t) ptr
->recv_size
;
445 memcached_instance_st
* instance
= memcached_instance_fetch(ptr
, 0);
452 /* We just try the first host, and if it is down we return zero */
453 if (memcached_failed(memcached_connect(instance
)))
458 if (memcached_failed(memcached_io_wait_for_write(instance
)))
463 if (getsockopt(instance
->fd
, SOL_SOCKET
, SO_RCVBUF
, (char*)&sock_size
, &sock_length
) < 0)
465 memcached_set_errno(*ptr
, get_socket_errno(), MEMCACHED_AT
);
466 return 0; /* Zero means error */
470 return (uint64_t) sock_size
;
473 case MEMCACHED_BEHAVIOR_USER_DATA
:
474 memcached_set_error(*ptr
, MEMCACHED_DEPRECATED
, MEMCACHED_AT
,
475 memcached_literal_param("MEMCACHED_BEHAVIOR_USER_DATA deprecated."));
478 case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY
:
479 return ptr
->flags
.hash_with_namespace
;
481 case MEMCACHED_BEHAVIOR_NOREPLY
:
482 return ptr
->flags
.reply
? false : true;
484 case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS
:
485 return ptr
->flags
.auto_eject_hosts
;
487 case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ
:
488 return ptr
->flags
.randomize_replica_read
;
490 case MEMCACHED_BEHAVIOR_CORK
:
497 case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
:
498 return ptr
->flags
.tcp_keepalive
;
500 case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE
:
501 return bool(memcached_parse_filename(ptr
));
503 case MEMCACHED_BEHAVIOR_MAX
:
505 assert_msg(0, "Invalid behavior passed to memcached_behavior_get()");
513 memcached_return_t
memcached_behavior_set_distribution(memcached_st
*shell
, memcached_server_distribution_t type
)
515 Memcached
* ptr
= memcached2Memcached(shell
);
520 case MEMCACHED_DISTRIBUTION_MODULA
:
523 case MEMCACHED_DISTRIBUTION_CONSISTENT
:
524 case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA
:
525 memcached_set_weighted_ketama(ptr
, false);
528 case MEMCACHED_DISTRIBUTION_RANDOM
:
531 case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA_SPY
:
534 case MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED
:
535 memcached_set_weighted_ketama(ptr
, true);
538 case MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET
:
542 case MEMCACHED_DISTRIBUTION_CONSISTENT_MAX
:
543 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
544 memcached_literal_param("Invalid memcached_server_distribution_t"));
546 ptr
->distribution
= type
;
548 return run_distribution(ptr
);
551 return MEMCACHED_INVALID_ARGUMENTS
;
555 memcached_server_distribution_t
memcached_behavior_get_distribution(memcached_st
*shell
)
557 Memcached
* ptr
= memcached2Memcached(shell
);
560 return ptr
->distribution
;
563 return MEMCACHED_DISTRIBUTION_CONSISTENT_MAX
;
566 memcached_return_t
memcached_behavior_set_key_hash(memcached_st
*shell
, memcached_hash_t type
)
568 Memcached
* ptr
= memcached2Memcached(shell
);
571 if (hashkit_success(hashkit_set_function(&ptr
->hashkit
, (hashkit_hash_algorithm_t
)type
)))
573 return MEMCACHED_SUCCESS
;
576 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
577 memcached_literal_param("Invalid memcached_hash_t()"));
580 return MEMCACHED_INVALID_ARGUMENTS
;
583 memcached_hash_t
memcached_behavior_get_key_hash(memcached_st
*shell
)
585 Memcached
* ptr
= memcached2Memcached(shell
);
588 return (memcached_hash_t
)hashkit_get_function(&ptr
->hashkit
);
591 return MEMCACHED_HASH_MAX
;
594 memcached_return_t
memcached_behavior_set_distribution_hash(memcached_st
*shell
, memcached_hash_t type
)
596 Memcached
* ptr
= memcached2Memcached(shell
);
599 if (hashkit_success(hashkit_set_distribution_function(&ptr
->hashkit
, (hashkit_hash_algorithm_t
)type
)))
601 return MEMCACHED_SUCCESS
;
604 return memcached_set_error(*ptr
, MEMCACHED_INVALID_ARGUMENTS
, MEMCACHED_AT
,
605 memcached_literal_param("Invalid memcached_hash_t()"));
608 return MEMCACHED_INVALID_ARGUMENTS
;
611 memcached_hash_t
memcached_behavior_get_distribution_hash(memcached_st
*shell
)
613 Memcached
* ptr
= memcached2Memcached(shell
);
616 return (memcached_hash_t
)hashkit_get_function(&ptr
->hashkit
);
619 return MEMCACHED_HASH_MAX
;
622 const char *libmemcached_string_behavior(const memcached_behavior_t flag
)
626 case MEMCACHED_BEHAVIOR_NO_BLOCK
: return "MEMCACHED_BEHAVIOR_NO_BLOCK";
627 case MEMCACHED_BEHAVIOR_TCP_NODELAY
: return "MEMCACHED_BEHAVIOR_TCP_NODELAY";
628 case MEMCACHED_BEHAVIOR_HASH
: return "MEMCACHED_BEHAVIOR_HASH";
629 case MEMCACHED_BEHAVIOR_KETAMA
: return "MEMCACHED_BEHAVIOR_KETAMA";
630 case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
: return "MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE";
631 case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE
: return "MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE";
632 case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS
: return "MEMCACHED_BEHAVIOR_CACHE_LOOKUPS";
633 case MEMCACHED_BEHAVIOR_SUPPORT_CAS
: return "MEMCACHED_BEHAVIOR_SUPPORT_CAS";
634 case MEMCACHED_BEHAVIOR_POLL_TIMEOUT
: return "MEMCACHED_BEHAVIOR_POLL_TIMEOUT";
635 case MEMCACHED_BEHAVIOR_DISTRIBUTION
: return "MEMCACHED_BEHAVIOR_DISTRIBUTION";
636 case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS
: return "MEMCACHED_BEHAVIOR_BUFFER_REQUESTS";
637 case MEMCACHED_BEHAVIOR_USER_DATA
: return "MEMCACHED_BEHAVIOR_USER_DATA";
638 case MEMCACHED_BEHAVIOR_SORT_HOSTS
: return "MEMCACHED_BEHAVIOR_SORT_HOSTS";
639 case MEMCACHED_BEHAVIOR_VERIFY_KEY
: return "MEMCACHED_BEHAVIOR_VERIFY_KEY";
640 case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT
: return "MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT";
641 case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT
: return "MEMCACHED_BEHAVIOR_RETRY_TIMEOUT";
642 case MEMCACHED_BEHAVIOR_DEAD_TIMEOUT
: return "MEMCACHED_BEHAVIOR_DEAD_TIMEOUT";
643 case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED
: return "MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED";
644 case MEMCACHED_BEHAVIOR_KETAMA_HASH
: return "MEMCACHED_BEHAVIOR_KETAMA_HASH";
645 case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL
: return "MEMCACHED_BEHAVIOR_BINARY_PROTOCOL";
646 case MEMCACHED_BEHAVIOR_SND_TIMEOUT
: return "MEMCACHED_BEHAVIOR_SND_TIMEOUT";
647 case MEMCACHED_BEHAVIOR_RCV_TIMEOUT
: return "MEMCACHED_BEHAVIOR_RCV_TIMEOUT";
648 case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT
: return "MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT";
649 case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK
: return "MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK";
650 case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK
: return "MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK";
651 case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH
: return "MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH";
652 case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY
: return "MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY";
653 case MEMCACHED_BEHAVIOR_NOREPLY
: return "MEMCACHED_BEHAVIOR_NOREPLY";
654 case MEMCACHED_BEHAVIOR_USE_UDP
: return "MEMCACHED_BEHAVIOR_USE_UDP";
655 case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS
: return "MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS";
656 case MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS
: return "MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS";
657 case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS
: return "MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS";
658 case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ
: return "MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ";
659 case MEMCACHED_BEHAVIOR_CORK
: return "MEMCACHED_BEHAVIOR_CORK";
660 case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
: return "MEMCACHED_BEHAVIOR_TCP_KEEPALIVE";
661 case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE
: return "MEMCACHED_BEHAVIOR_TCP_KEEPIDLE";
662 case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE
: return "MEMCACHED_BEHAVIOR_LOAD_FROM_FILE";
664 case MEMCACHED_BEHAVIOR_MAX
: return "INVALID memcached_behavior_t";
668 const char *libmemcached_string_distribution(const memcached_server_distribution_t flag
)
672 case MEMCACHED_DISTRIBUTION_MODULA
: return "MEMCACHED_DISTRIBUTION_MODULA";
673 case MEMCACHED_DISTRIBUTION_CONSISTENT
: return "MEMCACHED_DISTRIBUTION_CONSISTENT";
674 case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA
: return "MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA";
675 case MEMCACHED_DISTRIBUTION_RANDOM
: return "MEMCACHED_DISTRIBUTION_RANDOM";
676 case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA_SPY
: return "MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA_SPY";
677 case MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED
: return "MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED";
678 case MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET
: return "MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET";
680 case MEMCACHED_DISTRIBUTION_CONSISTENT_MAX
: return "INVALID memcached_server_distribution_t";
684 memcached_return_t
memcached_bucket_set(memcached_st
*shell
,
685 const uint32_t *host_map
,
686 const uint32_t *forward_map
,
687 const uint32_t buckets
,
688 const uint32_t replicas
)
690 Memcached
* self
= memcached2Memcached(shell
);
691 memcached_return_t rc
;
695 return MEMCACHED_INVALID_ARGUMENTS
;
698 if (host_map
== NULL
)
700 return MEMCACHED_INVALID_ARGUMENTS
;
703 memcached_server_distribution_t old
= memcached_behavior_get_distribution(self
);
705 if (memcached_failed(rc
=memcached_behavior_set_distribution(self
, MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET
)))
710 if (memcached_failed(rc
= memcached_virtual_bucket_create(self
, host_map
, forward_map
, buckets
, replicas
)))
712 memcached_behavior_set_distribution(self
, old
);