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     send_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     send_quit(ptr);
  71     break;
  72   case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS:
  73     ptr->flags.buffer_requests= set_flag(data);
  74     send_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     send_quit(ptr);
  90     break;
  91   case MEMCACHED_BEHAVIOR_TCP_KEEPALIVE:
  92     ptr->flags.tcp_keepalive= set_flag(data);
  93     send_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
 119   case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS:
 120     return memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 121                                       memcached_string_with_size("MEMCACHED_BEHAVIOR_CACHE_LOOKUPS has been deprecated."));
 122
 123   case MEMCACHED_BEHAVIOR_VERIFY_KEY:
 124     if (ptr->flags.binary_protocol)
 125       return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 126                                         memcached_string_with_size("MEMCACHED_BEHAVIOR_VERIFY_KEY if the binary protocol has been enabled."));
 127     ptr->flags.verify_key= set_flag(data);
 128     break;
 129   case MEMCACHED_BEHAVIOR_SORT_HOSTS:
 130     {
 131       ptr->flags.use_sort_hosts= set_flag(data);
 132       run_distribution(ptr);
 133
 134       break;
 135     }
 136   case MEMCACHED_BEHAVIOR_POLL_TIMEOUT:
 137     ptr->poll_timeout= (int32_t)data;
 138     break;
 139   case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT:
 140     ptr->connect_timeout= (int32_t)data;
 141     break;
 142   case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT:
 143     ptr->retry_timeout= (int32_t)data;
 144     break;
 145   case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE:
 146     ptr->send_size= (int32_t)data;
 147     send_quit(ptr);
 148     break;
 149   case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE:
 150     ptr->recv_size= (int32_t)data;
 151     send_quit(ptr);
 152     break;
 153   case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE:
 154     ptr->tcp_keepidle= (uint32_t)data;
 155     send_quit(ptr);
 156     break;
 157   case MEMCACHED_BEHAVIOR_USER_DATA:
 158     return memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 159                                       memcached_string_with_size("MEMCACHED_BEHAVIOR_USER_DATA deprecated."));
 160   case MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY:
 161     ptr->flags.hash_with_prefix_key= set_flag(data);
 162     break;
 163   case MEMCACHED_BEHAVIOR_NOREPLY:
 164     ptr->flags.no_reply= set_flag(data);
 165     break;
 166   case MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS:
 167     ptr->flags.auto_eject_hosts= set_flag(data);
 168     break;
 169   case MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ:
 170       srandom((uint32_t) time(NULL));
 171       ptr->flags.randomize_replica_read= set_flag(data);
 172       break;
 173   case MEMCACHED_BEHAVIOR_CORK:
 174       {
 175         return memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 176                                           memcached_string_with_size("MEMCACHED_BEHAVIOR_CORK is now incorporated into the driver by default."));
 177       }
 178       break;
 179   case MEMCACHED_BEHAVIOR_LOAD_FROM_FILE:
 180       return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 181                                         memcached_string_with_size("MEMCACHED_BEHAVIOR_LOAD_FROM_FILE can not be set with memcached_behavior_set()"));
 182   case MEMCACHED_BEHAVIOR_MAX:
 183   default:
 184     /* Shouldn't get here */
 185     WATCHPOINT_ASSERT(0);
 186     return memcached_set_error_string(ptr, MEMCACHED_INVALID_ARGUMENTS,
 187                                       memcached_string_with_size("Invalid behavior passed to memcached_behavior_set()"));
 188   }
 189
 190   return MEMCACHED_SUCCESS;
 191 }
 192
 193 bool _is_auto_eject_host(const memcached_st *ptr)
 194 {
 195   return ptr->flags.auto_eject_hosts;
 196 }
 197
 198 uint64_t memcached_behavior_get(memcached_st *ptr,
 199                                 const memcached_behavior_t flag)
 200 {
 201   switch (flag)
 202   {
 203   case MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS:
 204     return ptr->number_of_replicas;
 205   case MEMCACHED_BEHAVIOR_IO_MSG_WATERMARK:
 206     return ptr->io_msg_watermark;
 207   case MEMCACHED_BEHAVIOR_IO_BYTES_WATERMARK:
 208     return ptr->io_bytes_watermark;
 209   case MEMCACHED_BEHAVIOR_IO_KEY_PREFETCH:
 210     return ptr->io_key_prefetch;
 211   case MEMCACHED_BEHAVIOR_BINARY_PROTOCOL:
 212     return ptr->flags.binary_protocol;
 213   case MEMCACHED_BEHAVIOR_SUPPORT_CAS:
 214     return ptr->flags.support_cas;
 215
 216   case MEMCACHED_BEHAVIOR_CACHE_LOOKUPS:
 217     return true;
 218
 219   case MEMCACHED_BEHAVIOR_NO_BLOCK:
 220     return ptr->flags.no_block;
 221   case MEMCACHED_BEHAVIOR_BUFFER_REQUESTS:
 222     return ptr->flags.buffer_requests;
 223   case MEMCACHED_BEHAVIOR_USE_UDP:
 224     return ptr->flags.use_udp;
 225   case MEMCACHED_BEHAVIOR_TCP_NODELAY:
 226     return ptr->flags.tcp_nodelay;
 227   case MEMCACHED_BEHAVIOR_VERIFY_KEY:
 228     return ptr->flags.verify_key;
 229   case MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED:
 230     return ptr->ketama.weighted;
 231   case MEMCACHED_BEHAVIOR_DISTRIBUTION:
 232     return ptr->distribution;
 233   case MEMCACHED_BEHAVIOR_KETAMA:
 234     return (ptr->distribution == MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA) ? (uint64_t) 1 : 0;
 235   case MEMCACHED_BEHAVIOR_HASH:
 236     return hashkit_get_function(&ptr->hashkit);
 237   case MEMCACHED_BEHAVIOR_KETAMA_HASH:
 238     return hashkit_get_function(&ptr->distribution_hashkit);
 239   case MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT:
 240     return ptr->server_failure_limit;
 241   case MEMCACHED_BEHAVIOR_SORT_HOSTS:
 242     return ptr->flags.use_sort_hosts;
 243   case MEMCACHED_BEHAVIOR_POLL_TIMEOUT:
 244     return (uint64_t)ptr->poll_timeout;
 245   case MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT:
 246     return (uint64_t)ptr->connect_timeout;
 247   case MEMCACHED_BEHAVIOR_RETRY_TIMEOUT:
 248     return (uint64_t)ptr->retry_timeout;
 249   case MEMCACHED_BEHAVIOR_SND_TIMEOUT:
 250     return (uint64_t)ptr->snd_timeout;
 251   case MEMCACHED_BEHAVIOR_RCV_TIMEOUT:
 252     return (uint64_t)ptr->rcv_timeout;
 253   case MEMCACHED_BEHAVIOR_TCP_KEEPIDLE:
 254     return (uint64_t)ptr->tcp_keepidle;
 255   case MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE:
 256     {
 257       int sock_size= 0;
 258       socklen_t sock_length= sizeof(int);
 259       memcached_server_write_instance_st instance;
 260
 261       if (ptr->send_size != -1) // If value is -1 then we are using the default
 262         return (uint64_t) ptr->send_size;
 263
 264       instance= memcached_server_instance_fetch(ptr, 0);
 265
 266       if (instance) // If we have an instance we test, otherwise we just set and pray
 267       {
 268         /* REFACTOR */
 269         /* We just try the first host, and if it is down we return zero */
 270         if ((memcached_connect(instance)) != MEMCACHED_SUCCESS)
 271         {
 272           return 0;
 273         }
 274
 275         if (memcached_io_wait_for_write(instance) != MEMCACHED_SUCCESS)
 276         {
 277           return 0;
 278         }
 279
 280         if (getsockopt(instance->fd, SOL_SOCKET, SO_SNDBUF, &sock_size, &sock_length) < 0)
 281         {
 282           memcached_set_errno(ptr, errno, NULL);
 283           return 0; /* Zero means error */
 284         }
 285       }
 286
 287       return (uint64_t) sock_size;
 288     }
 289   case MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE:
 290     {
 291       int sock_size= 0;
 292       socklen_t sock_length= sizeof(int);
 293       memcached_server_write_instance_st instance;
 294
 295       if (ptr->recv_size != -1) // If value is -1 then we are using the default
 296         return (uint64_t) ptr->recv_size;
 297
 298       instance= memcached_server_instance_fetch(ptr, 0);
 299
 300       /**
 301         @note REFACTOR
 302       */
 303       if (instance)
 304       {
 305         /* We just try the first host, and if it is down we return zero */
 306         if ((memcached_connect(instance)) != MEMCACHED_SUCCESS)
 307         {
 308           return 0;
 309         }
 310
 311         if (memcached_io_wait_for_write(instance) != MEMCACHED_SUCCESS)
 312         {
 313           return 0;
 314         }
 315
 316         if (getsockopt(instance->fd, SOL_SOCKET, SO_RCVBUF, &sock_size, &sock_length) < 0)
 317         {
 318           memcached_set_errno(ptr, errno, NULL);
 319           return 0; /* Zero means error */
 320         }
 321
 322       }
 323
 324       return (uint64_t) sock_size;
 325     }
 326   case MEMCACHED_BEHAVIOR_USER_DATA:
 327     memcached_set_error_string(ptr, MEMCACHED_DEPRECATED,
 328                                memcached_string_with_size("MEMCACHED_BEHAVIOR_USER_DATA deprecated."));
 329     return 0;
 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 }