Merged in a lost patch.
[m6w6/libmemcached] / libmemcached / common.h
1 /*
2 Common include file for libmemached
3 */
4
5 #ifndef LIBMEMCACHED_COMMON_H
6 #define LIBMEMCACHED_COMMON_H
7
8 #include "config.h"
9
10 #include <stdio.h>
11 #include <stdlib.h>
12 #include <string.h>
13 #include <strings.h>
14 #include <ctype.h>
15 #include <sys/types.h>
16 #include <sys/socket.h>
17 #include <netinet/in.h>
18 #include <arpa/inet.h>
19 #include <netdb.h>
20 #include <unistd.h>
21 #include <limits.h>
22 #include <errno.h>
23 #include <fcntl.h>
24 #include <sys/un.h>
25 #include <netinet/tcp.h>
26 #ifdef TIME_WITH_SYS_TIME
27 # include <sys/time.h>
28 # include <time.h>
29 #else
30 # ifdef HAVE_SYS_TIME_H
31 # include <sys/time.h>
32 # else
33 # include <time.h>
34 # endif
35 #endif
36
37 /* Define this here, which will turn on the visibilty controls while we're
38 * building libmemcached.
39 */
40 #define BUILDING_LIBMEMCACHED 1
41
42
43 #include "libmemcached/memcached.h"
44 #include "libmemcached/memcached_watchpoint.h"
45
46 /* These are private not to be installed headers */
47 #include "libmemcached/memcached_io.h"
48 #include "libmemcached/memcached_internal.h"
49 #include "libmemcached/libmemcached_probes.h"
50 #include "libmemcached/memcached/protocol_binary.h"
51
52 /* string value */
53 struct memcached_continuum_item_st {
54 uint32_t index;
55 uint32_t value;
56 };
57
58
59 #if !defined(__GNUC__) || (__GNUC__ == 2 && __GNUC_MINOR__ < 96)
60
61 #define likely(x) if((x))
62 #define unlikely(x) if((x))
63
64 #else
65
66 #define likely(x) if(__builtin_expect(!!(x), 1))
67 #define unlikely(x) if(__builtin_expect((x), 0))
68 #endif
69
70
71 #define MEMCACHED_BLOCK_SIZE 1024
72 #define MEMCACHED_DEFAULT_COMMAND_SIZE 350
73 #define SMALL_STRING_LEN 1024
74 #define HUGE_STRING_LEN 8196
75
76
77 typedef enum {
78 MEM_NO_BLOCK= (1 << 0),
79 MEM_TCP_NODELAY= (1 << 1),
80 MEM_REUSE_MEMORY= (1 << 2),
81 MEM_USE_MD5= (1 << 3),
82 /* 4 was once Ketama */
83 MEM_USE_CRC= (1 << 5),
84 MEM_USE_CACHE_LOOKUPS= (1 << 6),
85 MEM_SUPPORT_CAS= (1 << 7),
86 MEM_BUFFER_REQUESTS= (1 << 8),
87 MEM_USE_SORT_HOSTS= (1 << 9),
88 MEM_VERIFY_KEY= (1 << 10),
89 /* 11 used for weighted ketama */
90 MEM_KETAMA_WEIGHTED= (1 << 11),
91 MEM_BINARY_PROTOCOL= (1 << 12),
92 MEM_HASH_WITH_PREFIX_KEY= (1 << 13),
93 MEM_NOREPLY= (1 << 14),
94 MEM_USE_UDP= (1 << 15),
95 MEM_AUTO_EJECT_HOSTS= (1 << 16)
96 } memcached_flags;
97
98 /* Hashing algo */
99
100 LIBMEMCACHED_LOCAL
101 void md5_signature(const unsigned char *key, unsigned int length, unsigned char *result);
102 LIBMEMCACHED_LOCAL
103 uint32_t hash_crc32(const char *data,
104 size_t data_len);
105 #ifdef HAVE_HSIEH_HASH
106 LIBMEMCACHED_LOCAL
107 uint32_t hsieh_hash(const char *key, size_t key_length);
108 #endif
109 LIBMEMCACHED_LOCAL
110 uint32_t murmur_hash(const char *key, size_t key_length);
111 LIBMEMCACHED_LOCAL
112 uint32_t jenkins_hash(const void *key, size_t length, uint32_t initval);
113
114 LIBMEMCACHED_LOCAL
115 memcached_return memcached_connect(memcached_server_st *ptr);
116 LIBMEMCACHED_LOCAL
117 memcached_return memcached_response(memcached_server_st *ptr,
118 char *buffer, size_t buffer_length,
119 memcached_result_st *result);
120 LIBMEMCACHED_LOCAL
121 void memcached_quit_server(memcached_server_st *ptr, uint8_t io_death);
122
123 #define memcached_server_response_increment(A) (A)->cursor_active++
124 #define memcached_server_response_decrement(A) (A)->cursor_active--
125 #define memcached_server_response_reset(A) (A)->cursor_active=0
126
127 LIBMEMCACHED_LOCAL
128 memcached_return memcached_do(memcached_server_st *ptr, const void *commmand,
129 size_t command_length, uint8_t with_flush);
130 LIBMEMCACHED_LOCAL
131 memcached_return value_fetch(memcached_server_st *ptr,
132 char *buffer,
133 memcached_result_st *result);
134 LIBMEMCACHED_LOCAL
135 void server_list_free(memcached_st *ptr, memcached_server_st *servers);
136
137 LIBMEMCACHED_LOCAL
138 memcached_return memcached_key_test(const char **keys, size_t *key_length,
139 unsigned int number_of_keys);
140
141
142 LIBMEMCACHED_LOCAL
143 uint32_t generate_hash(memcached_st *ptr, const char *key, size_t key_length);
144
145 #ifndef HAVE_HTONLL
146 LIBMEMCACHED_LOCAL
147 extern uint64_t ntohll(uint64_t);
148 LIBMEMCACHED_LOCAL
149 extern uint64_t htonll(uint64_t);
150 #endif
151
152 LIBMEMCACHED_LOCAL
153 memcached_return memcached_purge(memcached_server_st *ptr);
154
155 static inline memcached_return memcached_validate_key_length(size_t key_length,
156 bool binary) {
157 unlikely (key_length == 0)
158 return MEMCACHED_BAD_KEY_PROVIDED;
159
160 if (binary)
161 {
162 unlikely (key_length > 0xffff)
163 return MEMCACHED_BAD_KEY_PROVIDED;
164 }
165 else
166 {
167 unlikely (key_length >= MEMCACHED_MAX_KEY)
168 return MEMCACHED_BAD_KEY_PROVIDED;
169 }
170
171 return MEMCACHED_SUCCESS;
172 }
173
174 #endif /* LIBMEMCACHED_COMMON_H */