X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=libmemcached%2Fmemcached.h;h=3c29a5e14c899442068cf4df38fec92078a8e989;hb=969fea8e7bed82c109685ec3976cf7b0ec514ae9;hp=668e9a124671de83ddebd4760d4605e439ab60a3;hpb=c52c930e6cb28a0c48c63992135691111fd9f779;p=awesomized%2Flibmemcached diff --git a/libmemcached/memcached.h b/libmemcached/memcached.h index 668e9a12..3c29a5e1 100644 --- a/libmemcached/memcached.h +++ b/libmemcached/memcached.h @@ -1,21 +1,43 @@ -/* LibMemcached - * Copyright (C) 2006-2009 Brian Aker - * All rights reserved. +/* vim:expandtab:shiftwidth=2:tabstop=2:smarttab: + * + * Libmemcached library * - * Use and distribution licensed under the BSD license. See - * the COPYING file in the parent directory for full text. + * Copyright (C) 2011 Data Differential, http://datadifferential.com/ + * Copyright (C) 2006-2009 Brian Aker All rights reserved. * - * Summary: interface for memcached server - * Description: main include file for libmemcached + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above + * copyright notice, this list of conditions and the following disclaimer + * in the documentation and/or other materials provided with the + * distribution. + * + * * The names of its contributors may not be used to endorse or + * promote products derived from this software without specific prior + * written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ -#ifndef __LIBMEMCACHED_MEMCACHED_H__ -#define __LIBMEMCACHED_MEMCACHED_H__ +#pragma once #include -#include -#include #include #include @@ -26,11 +48,16 @@ #include #include +#include #include +#include #include #include +#include +#include #include #include + // Everything above this line must be in the order specified. #include #include @@ -44,6 +71,8 @@ #include #include #include +#include +#include #include #include #include @@ -64,29 +93,29 @@ struct memcached_st { bool is_processing_input:1; bool is_time_for_rebuild:1; } state; + struct { // Everything below here is pretty static. bool auto_eject_hosts:1; bool binary_protocol:1; bool buffer_requests:1; - bool cork:1; - bool hash_with_prefix_key:1; - bool ketama_weighted:1; - bool no_block:1; + bool hash_with_namespace:1; + bool no_block:1; // Don't block bool no_reply:1; bool randomize_replica_read:1; - bool reuse_memory:1; bool support_cas:1; bool tcp_nodelay:1; - bool use_cache_lookups:1; bool use_sort_hosts:1; bool use_udp:1; bool verify_key:1; bool tcp_keepalive:1; } flags; + memcached_server_distribution_t distribution; hashkit_st hashkit; - uint32_t continuum_points_counter; // Ketama + struct { + unsigned int version; + } server_info; uint32_t number_of_hosts; memcached_server_st *servers; memcached_server_st *last_disconnected_server; @@ -97,46 +126,42 @@ struct memcached_st { uint32_t io_bytes_watermark; uint32_t io_key_prefetch; uint32_t tcp_keepidle; - int cached_errno; int32_t poll_timeout; - int32_t connect_timeout; + int32_t connect_timeout; // How long we will wait on connect() before we will timeout int32_t retry_timeout; - uint32_t continuum_count; // Ketama int send_size; int recv_size; void *user_data; - time_t next_distribution_rebuild; // Ketama - size_t prefix_key_length; + uint64_t query_id; uint32_t number_of_replicas; - hashkit_st distribution_hashkit; memcached_result_st result; - memcached_continuum_item_st *continuum; // Ketama - struct _allocators_st { - memcached_calloc_fn calloc; - memcached_free_fn free; - memcached_malloc_fn malloc; - memcached_realloc_fn realloc; - void *context; - } allocators; + struct { + bool weighted; + uint32_t continuum_count; // Ketama + uint32_t continuum_points_counter; // Ketama + time_t next_distribution_rebuild; // Ketama + memcached_continuum_item_st *continuum; // Ketama + } ketama; + + struct memcached_virtual_bucket_t *virtual_bucket; + + struct memcached_allocator_t allocators; memcached_clone_fn on_clone; memcached_cleanup_fn on_cleanup; memcached_trigger_key_fn get_key_failure; memcached_trigger_delete_key_fn delete_trigger; memcached_callback_st *callbacks; -#ifdef LIBMEMCACHED_WITH_SASL_SUPPORT + struct memcached_sasl_st sasl; + struct memcached_error_t *error_messages; + struct memcached_array_st *_namespace; struct { - const sasl_callback_t *callbacks; - /* - ** Did we allocate data inside the callbacks, or did the user - ** supply that. - */ - bool is_allocated:1; - } sasl; - -#endif - char prefix_key[MEMCACHED_PREFIX_KEY_MAX_SIZE]; + uint32_t initial_pool_size; + uint32_t max_pool_size; + int32_t version; // This is used by pool and others to determine if the memcached_st is out of date. + struct memcached_array_st *filename; + } configure; struct { bool is_allocated:1; } options; @@ -153,9 +178,18 @@ void memcached_servers_reset(memcached_st *ptr); LIBMEMCACHED_API memcached_st *memcached_create(memcached_st *ptr); +LIBMEMCACHED_API +memcached_st *memcached(const char *string, size_t string_length); + LIBMEMCACHED_API void memcached_free(memcached_st *ptr); +LIBMEMCACHED_API +memcached_return_t memcached_reset(memcached_st *ptr); + +LIBMEMCACHED_API +void memcached_reset_last_disconnected_server(memcached_st *ptr); + LIBMEMCACHED_API memcached_st *memcached_clone(memcached_st *clone, const memcached_st *ptr); @@ -174,39 +208,9 @@ memcached_server_instance_st memcached_server_instance_by_position(const memcach LIBMEMCACHED_API uint32_t memcached_server_count(const memcached_st *); -#ifdef __cplusplus -} // extern "C" -#endif - +LIBMEMCACHED_API +uint64_t memcached_query_id(const memcached_st *); #ifdef __cplusplus -class Memcached : private memcached_st { -public: - - Memcached() - { - memcached_create(this); - } - - ~Memcached() - { - memcached_free(this); - } - - Memcached(const Memcached& source) - { - memcached_clone(this, &source); - } - - Memcached& operator=(const Memcached& source) - { - memcached_free(this); - memcached_clone(this, &source); - - return *this; - } -}; +} // extern "C" #endif - -#endif /* __LIBMEMCACHED_MEMCACHED_H__ */ -