git.m6w6.name Git - m6w6/libmemcached/blob - libmemcached/behavior.cc

   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: Change the behavior of the memcached connection.
   9  *
  10  */
  11
  12 #include <libmemcached/common.h>
  13 #include <libmemcached/virtual_bucket.h>
  14
  15 #include <time.h>
  16 #include <sys/types.h>
  17
  18 static bool set_flag(uint64_t data)
  19 {
  20   // Wordy :)
  21   return data ? true : false;
  22 }
  23
  24 /*
  25   This function is used to modify the behavior of running client.
  26
  27   We quit all connections so we can reset the sockets.
  28 */
  29
  30 memcached_return_t memcached_behavior_set(memcached_st *ptr,
  31                                           const memcached_behavior_t flag,
  32                                           uint64_t data)
  33 {
  34   switch (flag)
  35   {
  36   case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS:
  37     ptr->number_of_replicas= (uint32_t)data;
  38     break;
  39   case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK:
  40     ptr->io_msg_watermark= (uint32_t) data;
  41     break;
  42   case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK:
  43     ptr->io_bytes_watermark= (uint32_t)data;
  44     break;
  45   case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH:
  46     ptr->io_key_prefetch = (uint32_t)data;
  47     break;
  48   case MEMCACHED_BEHAVIOR_SND_TIMEOUT:
  49     ptr->snd_timeout= (int32_t)data;
  50     break;
  51   case MEMCACHED_BEHAVIOR_RCV_TIMEOUT:
  52     ptr->rcv_timeout= (int32_t)data;
  53     break;
  54
  55   case MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS:
  56     ptr->flags.auto_eject_hosts= set_flag(data);
  57   case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT:
  58     ptr->server_failure_limit= (uint32_t)data;
  59     break;
  60
  61   case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL:
  62     send_quit(ptr); // We need t shutdown all of the connections to make sure we do the correct protocol
  63     if (data)
  64     {
  65       ptr->flags.verify_key= false;
  66     }
  67     ptr->flags.binary_protocol= set_flag(data);
  68     break;
  69   case MEMCACHED_BEHAVIOR_SUPPORT_CAS:
  70     ptr->flags.support_cas= set_flag(data);
  71     break;
  72   case MEMCACHED_BEHAVIOR_NO_BLOCK:
  73     ptr->flags.no_block= set_flag(data);
  74     send_quit(ptr);
  75     break;
  76   case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS:
  77     ptr->flags.buffer_requests= set_flag(data);
  78     send_quit(ptr);
  79     break;
  80   case MEMCACHED_BEHAVIOR_USE_UDP:
  81     if (memcached_server_count(ptr))
  82     {
  83       return MEMCACHED_FAILURE;
  84     }
  85     ptr->flags.use_udp= set_flag(data);
  86     if (data)
  87     {
  88       ptr->flags.no_reply= set_flag(data);
  89     }
  90     break;
  91   case MEMCACHED_BEHAVIOR_TCP_NODELAY:
  92     ptr->flags.tcp_nodelay= set_flag(data);
  93     send_quit(ptr);
  94     break;
  95   case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE:
  96     ptr->flags.tcp_keepalive= set_flag(data);
  97     send_quit(ptr);
  98     break;
  99   case MEMCACHED_BEHAVIOR_DISTRIBUTION:
 100     return memcached_behavior_set_distribution(ptr, (memcached_server_distribution_t)data);
 101   case MEMCACHED_BEHAVIOR_KETAMA:
 102     {
 103       if (data) // Turn on
 104         return memcached_behavior_set_distribution(ptr, MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA);
 105
 106       return memcached_behavior_set_distribution(ptr, MEMCACHED_DISTRIBUTION_MODULA);
 107     }
 108   case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED:
 109     {
 110       (void)memcached_behavior_set_key_hash(ptr, MEMCACHED_HASH_MD5);
 111       (void)memcached_behavior_set_distribution_hash(ptr, MEMCACHED_HASH_MD5);
 112       ptr->ketama.weighted= set_flag(data);
 113       /**
 114         @note We try to keep the same distribution going. This should be deprecated and rewritten.
 115       */
 116       return memcached_behavior_set_distribution(ptr, MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA);
 117     }
 118   case MEMCACHED_BEHAVIOR_HASH:
 119     return memcached_behavior_set_key_hash(ptr, (memcached_hash_t)(data));
 120   case MEMCACHED_BEHAVIOR_KETAMA_HASH:
 121     return memcached_behavior_set_distribution_hash(ptr, (memcached_hash_t)(data));
 122
 123   case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS:
 124     return memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 125                                       memcached_string_with_size("MEMCACHED_BEHAVIOR_CACHE_LOOKUPS has been deprecated."));
 126
 127   case MEMCACHED_BEHAVIOR_VERIFY_KEY:
 128     if (ptr->flags.binary_protocol)
 129       return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 130                                         memcached_string_with_size("MEMCACHED_BEHAVIOR_VERIFY_KEY if the binary protocol has been enabled."));
 131     ptr->flags.verify_key= set_flag(data);
 132     break;
 133   case MEMCACHED_BEHAVIOR_SORT_HOSTS:
 134     {
 135       ptr->flags.use_sort_hosts= set_flag(data);
 136       run_distribution(ptr);
 137
 138       break;
 139     }
 140   case MEMCACHED_BEHAVIOR_POLL_TIMEOUT:
 141     ptr->poll_timeout= (int32_t)data;
 142     break;
 143   case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT:
 144     ptr->connect_timeout= (int32_t)data;
 145     break;
 146   case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT:
 147     ptr->retry_timeout= (int32_t)data;
 148     break;
 149   case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE:
 150     ptr->send_size= (int32_t)data;
 151     send_quit(ptr);
 152     break;
 153   case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE:
 154     ptr->recv_size= (int32_t)data;
 155     send_quit(ptr);
 156     break;
 157   case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE:
 158     ptr->tcp_keepidle= (uint32_t)data;
 159     send_quit(ptr);
 160     break;
 161   case MEMCACHED_BEHAVIOR_USER_DATA:
 162     return memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 163                                       memcached_string_with_size("MEMCACHED_BEHAVIOR_USER_DATA deprecated."));
 164   case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY:
 165     ptr->flags.hash_with_prefix_key= set_flag(data);
 166     break;
 167   case MEMCACHED_BEHAVIOR_NOREPLY:
 168     ptr->flags.no_reply= set_flag(data);
 169     break;
 170   case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS:
 171     ptr->flags.auto_eject_hosts= set_flag(data);
 172     break;
 173   case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ:
 174       srandom((uint32_t) time(NULL));
 175       ptr->flags.randomize_replica_read= set_flag(data);
 176       break;
 177   case MEMCACHED_BEHAVIOR_CORK:
 178       {
 179         return memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 180                                           memcached_string_with_size("MEMCACHED_BEHAVIOR_CORK is now incorporated into the driver by default."));
 181       }
 182       break;
 183   case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE:
 184       return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 185                                         memcached_string_with_size("MEMCACHED_BEHAVIOR_LOAD_FROM_FILE can not be set with memcached_behavior_set()"));
 186   case MEMCACHED_BEHAVIOR_MAX:
 187   default:
 188     /* Shouldn't get here */
 189     WATCHPOINT_ASSERT(0);
 190     return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 191                                       memcached_string_with_size("Invalid behavior passed to memcached_behavior_set()"));
 192   }
 193
 194   return MEMCACHED_SUCCESS;
 195 }
 196
 197 bool _is_auto_eject_host(const memcached_st *ptr)
 198 {
 199   return ptr->flags.auto_eject_hosts;
 200 }
 201
 202 uint64_t memcached_behavior_get(memcached_st *ptr,
 203                                 const memcached_behavior_t flag)
 204 {
 205   switch (flag)
 206   {
 207   case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS:
 208     return ptr->number_of_replicas;
 209   case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK:
 210     return ptr->io_msg_watermark;
 211   case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK:
 212     return ptr->io_bytes_watermark;
 213   case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH:
 214     return ptr->io_key_prefetch;
 215   case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL:
 216     return ptr->flags.binary_protocol;
 217   case MEMCACHED_BEHAVIOR_SUPPORT_CAS:
 218     return ptr->flags.support_cas;
 219
 220   case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS:
 221     return true;
 222
 223   case MEMCACHED_BEHAVIOR_NO_BLOCK:
 224     return ptr->flags.no_block;
 225   case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS:
 226     return ptr->flags.buffer_requests;
 227   case MEMCACHED_BEHAVIOR_USE_UDP:
 228     return ptr->flags.use_udp;
 229   case MEMCACHED_BEHAVIOR_TCP_NODELAY:
 230     return ptr->flags.tcp_nodelay;
 231   case MEMCACHED_BEHAVIOR_VERIFY_KEY:
 232     return ptr->flags.verify_key;
 233   case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED:
 234     return ptr->ketama.weighted;
 235   case MEMCACHED_BEHAVIOR_DISTRIBUTION:
 236     return ptr->distribution;
 237   case MEMCACHED_BEHAVIOR_KETAMA:
 238     return (ptr->distribution == MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA) ? (uint64_t) 1 : 0;
 239   case MEMCACHED_BEHAVIOR_HASH:
 240     return hashkit_get_function(&ptr->hashkit);
 241   case MEMCACHED_BEHAVIOR_KETAMA_HASH:
 242     return hashkit_get_function(&ptr->distribution_hashkit);
 243   case MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS:
 244   case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT:
 245     return ptr->server_failure_limit;
 246   case MEMCACHED_BEHAVIOR_SORT_HOSTS:
 247     return ptr->flags.use_sort_hosts;
 248   case MEMCACHED_BEHAVIOR_POLL_TIMEOUT:
 249     return (uint64_t)ptr->poll_timeout;
 250   case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT:
 251     return (uint64_t)ptr->connect_timeout;
 252   case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT:
 253     return (uint64_t)ptr->retry_timeout;
 254   case MEMCACHED_BEHAVIOR_SND_TIMEOUT:
 255     return (uint64_t)ptr->snd_timeout;
 256   case MEMCACHED_BEHAVIOR_RCV_TIMEOUT:
 257     return (uint64_t)ptr->rcv_timeout;
 258   case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE:
 259     return (uint64_t)ptr->tcp_keepidle;
 260   case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE:
 261     {
 262       int sock_size= 0;
 263       socklen_t sock_length= sizeof(int);
 264       memcached_server_write_instance_st instance;
 265
 266       if (ptr->send_size != -1) // If value is -1 then we are using the default
 267         return (uint64_t) ptr->send_size;
 268
 269       instance= memcached_server_instance_fetch(ptr, 0);
 270
 271       if (instance) // If we have an instance we test, otherwise we just set and pray
 272       {
 273         /* REFACTOR */
 274         /* We just try the first host, and if it is down we return zero */
 275         if ((memcached_connect(instance)) != MEMCACHED_SUCCESS)
 276         {
 277           return 0;
 278         }
 279
 280         if (memcached_io_wait_for_write(instance) != MEMCACHED_SUCCESS)
 281         {
 282           return 0;
 283         }
 284
 285         if (getsockopt(instance->fd, SOL_SOCKET, SO_SNDBUF, &sock_size, &sock_length) < 0)
 286         {
 287           memcached_set_errno(ptr, errno, NULL);
 288           return 0; /* Zero means error */
 289         }
 290       }
 291
 292       return (uint64_t) sock_size;
 293     }
 294   case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE:
 295     {
 296       int sock_size= 0;
 297       socklen_t sock_length= sizeof(int);
 298       memcached_server_write_instance_st instance;
 299
 300       if (ptr->recv_size != -1) // If value is -1 then we are using the default
 301         return (uint64_t) ptr->recv_size;
 302
 303       instance= memcached_server_instance_fetch(ptr, 0);
 304
 305       /**
 306         @note REFACTOR
 307       */
 308       if (instance)
 309       {
 310         /* We just try the first host, and if it is down we return zero */
 311         if ((memcached_connect(instance)) != MEMCACHED_SUCCESS)
 312         {
 313           return 0;
 314         }
 315
 316         if (memcached_io_wait_for_write(instance) != MEMCACHED_SUCCESS)
 317         {
 318           return 0;
 319         }
 320
 321         if (getsockopt(instance->fd, SOL_SOCKET, SO_RCVBUF, &sock_size, &sock_length) < 0)
 322         {
 323           memcached_set_errno(ptr, errno, NULL);
 324           return 0; /* Zero means error */
 325         }
 326
 327       }
 328
 329       return (uint64_t) sock_size;
 330     }
 331   case MEMCACHED_BEHAVIOR_USER_DATA:
 332     memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 333                                memcached_string_with_size("MEMCACHED_BEHAVIOR_USER_DATA deprecated."));
 334     return 0;
 335   case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY:
 336     return ptr->flags.hash_with_prefix_key;
 337   case MEMCACHED_BEHAVIOR_NOREPLY:
 338     return ptr->flags.no_reply;
 339   case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS:
 340     return ptr->flags.auto_eject_hosts;
 341   case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ:
 342     return ptr->flags.randomize_replica_read;
 343   case MEMCACHED_BEHAVIOR_CORK:
 344 #ifdef HAVE_MSG_MORE
 345     return true;
 346 #else
 347     return false;
 348 #endif
 349   case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE:
 350     return ptr->flags.tcp_keepalive;
 351   case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE:
 352     return ptr->configure.filename ? true : false;
 353   case MEMCACHED_BEHAVIOR_MAX:
 354   default:
 355     WATCHPOINT_ASSERT(0); /* Programming mistake if it gets this far */
 356     return 0;
 357   }
 358
 359   /* NOTREACHED */
 360 }
 361
 362
 363 memcached_return_t memcached_behavior_set_distribution(memcached_st *ptr, memcached_server_distribution_t type)
 364 {
 365   if (type < MEMCACHED_DISTRIBUTION_CONSISTENT_MAX)
 366   {
 367     if (MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED)
 368     {
 369       ptr->ketama.weighted= true;
 370     }
 371     else
 372     {
 373       ptr->ketama.weighted= false;
 374     }
 375     ptr->distribution= type;
 376     run_distribution(ptr);
 377     return MEMCACHED_SUCCESS;
 378   }
 379
 380   return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 381                                     memcached_string_with_size("Invalid memcached_server_distribution_t"));
 382 }
 383
 384
 385 memcached_server_distribution_t memcached_behavior_get_distribution(memcached_st *ptr)
 386 {
 387   return ptr->distribution;
 388 }
 389
 390 memcached_return_t memcached_behavior_set_key_hash(memcached_st *ptr, memcached_hash_t type)
 391 {
 392   if (hashkit_set_function(&ptr->hashkit, (hashkit_hash_algorithm_t)type) == HASHKIT_SUCCESS)
 393     return MEMCACHED_SUCCESS;
 394
 395   return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 396                                     memcached_string_with_size("Invalid memcached_hash_t()"));
 397 }
 398
 399 memcached_hash_t memcached_behavior_get_key_hash(memcached_st *ptr)
 400 {
 401   return (memcached_hash_t)hashkit_get_function(&ptr->hashkit);
 402 }
 403
 404 memcached_return_t memcached_behavior_set_distribution_hash(memcached_st *ptr, memcached_hash_t type)
 405 {
 406   if (hashkit_set_function(&ptr->distribution_hashkit, (hashkit_hash_algorithm_t)type) == HASHKIT_SUCCESS)
 407     return MEMCACHED_SUCCESS;
 408
 409   return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 410                                     memcached_string_with_size("Invalid memcached_hash_t()"));
 411 }
 412
 413 memcached_hash_t memcached_behavior_get_distribution_hash(memcached_st *ptr)
 414 {
 415   return (memcached_hash_t)hashkit_get_function(&ptr->distribution_hashkit);
 416 }
 417
 418 const char *libmemcached_string_behavior(const memcached_behavior_t flag)
 419 {
 420   switch (flag)
 421   {
 422   case MEMCACHED_BEHAVIOR_NO_BLOCK: return "MEMCACHED_BEHAVIOR_NO_BLOCK";
 423   case MEMCACHED_BEHAVIOR_TCP_NODELAY: return "MEMCACHED_BEHAVIOR_TCP_NODELAY";
 424   case MEMCACHED_BEHAVIOR_HASH: return "MEMCACHED_BEHAVIOR_HASH";
 425   case MEMCACHED_BEHAVIOR_KETAMA: return "MEMCACHED_BEHAVIOR_KETAMA";
 426   case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE: return "MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE";
 427   case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE: return "MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE";
 428   case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS: return "MEMCACHED_BEHAVIOR_CACHE_LOOKUPS";
 429   case MEMCACHED_BEHAVIOR_SUPPORT_CAS: return "MEMCACHED_BEHAVIOR_SUPPORT_CAS";
 430   case MEMCACHED_BEHAVIOR_POLL_TIMEOUT: return "MEMCACHED_BEHAVIOR_POLL_TIMEOUT";
 431   case MEMCACHED_BEHAVIOR_DISTRIBUTION: return "MEMCACHED_BEHAVIOR_DISTRIBUTION";
 432   case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS: return "MEMCACHED_BEHAVIOR_BUFFER_REQUESTS";
 433   case MEMCACHED_BEHAVIOR_USER_DATA: return "MEMCACHED_BEHAVIOR_USER_DATA";
 434   case MEMCACHED_BEHAVIOR_SORT_HOSTS: return "MEMCACHED_BEHAVIOR_SORT_HOSTS";
 435   case MEMCACHED_BEHAVIOR_VERIFY_KEY: return "MEMCACHED_BEHAVIOR_VERIFY_KEY";
 436   case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT: return "MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT";
 437   case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT: return "MEMCACHED_BEHAVIOR_RETRY_TIMEOUT";
 438   case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED: return "MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED";
 439   case MEMCACHED_BEHAVIOR_KETAMA_HASH: return "MEMCACHED_BEHAVIOR_KETAMA_HASH";
 440   case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL: return "MEMCACHED_BEHAVIOR_BINARY_PROTOCOL";
 441   case MEMCACHED_BEHAVIOR_SND_TIMEOUT: return "MEMCACHED_BEHAVIOR_SND_TIMEOUT";
 442   case MEMCACHED_BEHAVIOR_RCV_TIMEOUT: return "MEMCACHED_BEHAVIOR_RCV_TIMEOUT";
 443   case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT: return "MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT";
 444   case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK: return "MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK";
 445   case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK: return "MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK";
 446   case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH: return "MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH";
 447   case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY: return "MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY";
 448   case MEMCACHED_BEHAVIOR_NOREPLY: return "MEMCACHED_BEHAVIOR_NOREPLY";
 449   case MEMCACHED_BEHAVIOR_USE_UDP: return "MEMCACHED_BEHAVIOR_USE_UDP";
 450   case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS: return "MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS";
 451   case MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS: return "MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS";
 452   case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS: return "MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS";
 453   case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ: return "MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ";
 454   case MEMCACHED_BEHAVIOR_CORK: return "MEMCACHED_BEHAVIOR_CORK";
 455   case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE: return "MEMCACHED_BEHAVIOR_TCP_KEEPALIVE";
 456   case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE: return "MEMCACHED_BEHAVIOR_TCP_KEEPIDLE";
 457   case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE: return "MEMCACHED_BEHAVIOR_LOAD_FROM_FILE";
 458   default:
 459   case MEMCACHED_BEHAVIOR_MAX: return "INVALID memcached_behavior_t";
 460   }
 461 }
 462
 463 const char *libmemcached_string_distribution(const memcached_server_distribution_t flag)
 464 {
 465   switch (flag)
 466   {
 467   case MEMCACHED_DISTRIBUTION_MODULA: return "MEMCACHED_DISTRIBUTION_MODULA";
 468   case MEMCACHED_DISTRIBUTION_CONSISTENT: return "MEMCACHED_DISTRIBUTION_CONSISTENT";
 469   case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA: return "MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA";
 470   case MEMCACHED_DISTRIBUTION_RANDOM: return "MEMCACHED_DISTRIBUTION_RANDOM";
 471   case MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA_SPY: return "MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA_SPY";
 472   case MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED: return "MEMCACHED_DISTRIBUTION_CONSISTENT_WEIGHTED";
 473   case MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET: return "MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET";
 474   default:
 475   case MEMCACHED_DISTRIBUTION_CONSISTENT_MAX: return "INVALID memcached_server_distribution_t";
 476   }
 477 }
 478
 479 memcached_return_t memcached_bucket_set(memcached_st *self,
 480                                         const uint32_t *host_map,
 481                                         const uint32_t *forward_map,
 482                                         const uint32_t buckets,
 483                                         const uint32_t replicas)
 484 {
 485   memcached_return_t rc;
 486
 487   if (! self)
 488     return MEMCACHED_INVALID_ARGUMENTS;
 489
 490   if (! host_map)
 491     return MEMCACHED_INVALID_ARGUMENTS;
 492
 493   memcached_server_distribution_t old;
 494   old= memcached_behavior_get_distribution(self);
 495
 496   rc =memcached_behavior_set_distribution(self, MEMCACHED_DISTRIBUTION_VIRTUAL_BUCKET);
 497   if (rc != MEMCACHED_SUCCESS)
 498   {
 499     return rc;
 500   }
 501
 502   rc= memcached_virtual_bucket_create(self, host_map, forward_map, buckets, replicas);
 503   if (rc != MEMCACHED_SUCCESS)
 504   {
 505     memcached_behavior_set_distribution(self, old);
 506   }
 507
 508   return rc;
 509 }