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