git.m6w6.name Git - awesomized/libmemcached/blob - libmemcached/behavior.c

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