boourns-memcached 1.4.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (542) hide show
  1. data/BENCHMARKS +128 -0
  2. data/CHANGELOG +158 -0
  3. data/Gemfile +2 -0
  4. data/Gemfile.lock +41 -0
  5. data/LICENSE +184 -0
  6. data/Manifest +243 -0
  7. data/README.rdoc +124 -0
  8. data/Rakefile +118 -0
  9. data/TODO +4 -0
  10. data/ext/Makefile +213 -0
  11. data/ext/Makefile.in +213 -0
  12. data/ext/bin/memcat +0 -0
  13. data/ext/bin/memcp +0 -0
  14. data/ext/bin/memdump +0 -0
  15. data/ext/bin/memerror +0 -0
  16. data/ext/bin/memflush +0 -0
  17. data/ext/bin/memrm +0 -0
  18. data/ext/bin/memslap +0 -0
  19. data/ext/bin/memstat +0 -0
  20. data/ext/extconf-make.rb +25 -0
  21. data/ext/extconf.rb +87 -0
  22. data/ext/include/libmemcached/memcached.h +304 -0
  23. data/ext/include/libmemcached/memcached.hpp +799 -0
  24. data/ext/include/libmemcached/memcached_configure.h +23 -0
  25. data/ext/include/libmemcached/memcached_constants.h +145 -0
  26. data/ext/include/libmemcached/memcached_exist.h +20 -0
  27. data/ext/include/libmemcached/memcached_get.h +87 -0
  28. data/ext/include/libmemcached/memcached_result.h +59 -0
  29. data/ext/include/libmemcached/memcached_sasl.h +44 -0
  30. data/ext/include/libmemcached/memcached_server.h +93 -0
  31. data/ext/include/libmemcached/memcached_storage.h +107 -0
  32. data/ext/include/libmemcached/memcached_string.h +53 -0
  33. data/ext/include/libmemcached/memcached_touch.h +31 -0
  34. data/ext/include/libmemcached/memcached_types.h +44 -0
  35. data/ext/include/libmemcached/memcached_watchpoint.h +38 -0
  36. data/ext/include/libmemcached/visibility.h +51 -0
  37. data/ext/lib/libmemcached.a +0 -0
  38. data/ext/lib/libmemcached.la +41 -0
  39. data/ext/lib/libmemcached_gem.a +0 -0
  40. data/ext/lib/libmemcached_gem.la +41 -0
  41. data/ext/lib/pkgconfig/libmemcached.pc +10 -0
  42. data/ext/libmemcached-0.32/AUTHORS +7 -0
  43. data/ext/libmemcached-0.32/COPYING +32 -0
  44. data/ext/libmemcached-0.32/ChangeLog +303 -0
  45. data/ext/libmemcached-0.32/INSTALL +302 -0
  46. data/ext/libmemcached-0.32/Makefile +831 -0
  47. data/ext/libmemcached-0.32/Makefile.am +36 -0
  48. data/ext/libmemcached-0.32/Makefile.in +831 -0
  49. data/ext/libmemcached-0.32/NEWS +1 -0
  50. data/ext/libmemcached-0.32/README +33 -0
  51. data/ext/libmemcached-0.32/THANKS +14 -0
  52. data/ext/libmemcached-0.32/TODO +11 -0
  53. data/ext/libmemcached-0.32/aclocal.m4 +1917 -0
  54. data/ext/libmemcached-0.32/clients/Makefile +773 -0
  55. data/ext/libmemcached-0.32/clients/Makefile.am +80 -0
  56. data/ext/libmemcached-0.32/clients/Makefile.in +773 -0
  57. data/ext/libmemcached-0.32/clients/client_options.h +32 -0
  58. data/ext/libmemcached-0.32/clients/execute.c +64 -0
  59. data/ext/libmemcached-0.32/clients/execute.h +5 -0
  60. data/ext/libmemcached-0.32/clients/execute.lo +12 -0
  61. data/ext/libmemcached-0.32/clients/execute.o +0 -0
  62. data/ext/libmemcached-0.32/clients/generator.c +74 -0
  63. data/ext/libmemcached-0.32/clients/generator.h +20 -0
  64. data/ext/libmemcached-0.32/clients/generator.lo +12 -0
  65. data/ext/libmemcached-0.32/clients/generator.o +0 -0
  66. data/ext/libmemcached-0.32/clients/libgenexec.la +41 -0
  67. data/ext/libmemcached-0.32/clients/libutilities.la +41 -0
  68. data/ext/libmemcached-0.32/clients/memcat +0 -0
  69. data/ext/libmemcached-0.32/clients/memcat.c +178 -0
  70. data/ext/libmemcached-0.32/clients/memcat.o +0 -0
  71. data/ext/libmemcached-0.32/clients/memcp +0 -0
  72. data/ext/libmemcached-0.32/clients/memcp.c +251 -0
  73. data/ext/libmemcached-0.32/clients/memcp.o +0 -0
  74. data/ext/libmemcached-0.32/clients/memdump +0 -0
  75. data/ext/libmemcached-0.32/clients/memdump.c +170 -0
  76. data/ext/libmemcached-0.32/clients/memdump.o +0 -0
  77. data/ext/libmemcached-0.32/clients/memerror +0 -0
  78. data/ext/libmemcached-0.32/clients/memerror.c +80 -0
  79. data/ext/libmemcached-0.32/clients/memerror.o +0 -0
  80. data/ext/libmemcached-0.32/clients/memflush +0 -0
  81. data/ext/libmemcached-0.32/clients/memflush.c +143 -0
  82. data/ext/libmemcached-0.32/clients/memflush.o +0 -0
  83. data/ext/libmemcached-0.32/clients/memrm +0 -0
  84. data/ext/libmemcached-0.32/clients/memrm.c +160 -0
  85. data/ext/libmemcached-0.32/clients/memrm.o +0 -0
  86. data/ext/libmemcached-0.32/clients/memslap +0 -0
  87. data/ext/libmemcached-0.32/clients/memslap-memslap.o +0 -0
  88. data/ext/libmemcached-0.32/clients/memslap.c +441 -0
  89. data/ext/libmemcached-0.32/clients/memstat +0 -0
  90. data/ext/libmemcached-0.32/clients/memstat.c +326 -0
  91. data/ext/libmemcached-0.32/clients/memstat.o +0 -0
  92. data/ext/libmemcached-0.32/clients/utilities.c +207 -0
  93. data/ext/libmemcached-0.32/clients/utilities.h +41 -0
  94. data/ext/libmemcached-0.32/clients/utilities.lo +12 -0
  95. data/ext/libmemcached-0.32/clients/utilities.o +0 -0
  96. data/ext/libmemcached-0.32/config.h +253 -0
  97. data/ext/libmemcached-0.32/config.h.in +252 -0
  98. data/ext/libmemcached-0.32/config.log +2440 -0
  99. data/ext/libmemcached-0.32/config.status +2384 -0
  100. data/ext/libmemcached-0.32/config/compile +143 -0
  101. data/ext/libmemcached-0.32/config/config.guess +1561 -0
  102. data/ext/libmemcached-0.32/config/config.rpath +666 -0
  103. data/ext/libmemcached-0.32/config/config.sub +1686 -0
  104. data/ext/libmemcached-0.32/config/depcomp +630 -0
  105. data/ext/libmemcached-0.32/config/install-sh +520 -0
  106. data/ext/libmemcached-0.32/config/ltmain.sh +9636 -0
  107. data/ext/libmemcached-0.32/config/missing +376 -0
  108. data/ext/libmemcached-0.32/configure +23825 -0
  109. data/ext/libmemcached-0.32/configure.ac +122 -0
  110. data/ext/libmemcached-0.32/docs/Makefile +920 -0
  111. data/ext/libmemcached-0.32/docs/Makefile.am +415 -0
  112. data/ext/libmemcached-0.32/docs/Makefile.in +920 -0
  113. data/ext/libmemcached-0.32/docs/libmemcached.3 +229 -0
  114. data/ext/libmemcached-0.32/docs/libmemcached.pod +123 -0
  115. data/ext/libmemcached-0.32/docs/libmemcached_examples.3 +242 -0
  116. data/ext/libmemcached-0.32/docs/libmemcached_examples.pod +115 -0
  117. data/ext/libmemcached-0.32/docs/libmemcachedutil.pod +40 -0
  118. data/ext/libmemcached-0.32/docs/memcached_add.3 +308 -0
  119. data/ext/libmemcached-0.32/docs/memcached_add_by_key.3 +308 -0
  120. data/ext/libmemcached-0.32/docs/memcached_analyze.3 +175 -0
  121. data/ext/libmemcached-0.32/docs/memcached_analyze.pod +52 -0
  122. data/ext/libmemcached-0.32/docs/memcached_append.3 +308 -0
  123. data/ext/libmemcached-0.32/docs/memcached_append_by_key.3 +308 -0
  124. data/ext/libmemcached-0.32/docs/memcached_auto.pod +97 -0
  125. data/ext/libmemcached-0.32/docs/memcached_behavior.pod +224 -0
  126. data/ext/libmemcached-0.32/docs/memcached_behavior_get.3 +317 -0
  127. data/ext/libmemcached-0.32/docs/memcached_behavior_set.3 +317 -0
  128. data/ext/libmemcached-0.32/docs/memcached_callback.pod +123 -0
  129. data/ext/libmemcached-0.32/docs/memcached_callback_get.3 +231 -0
  130. data/ext/libmemcached-0.32/docs/memcached_callback_set.3 +231 -0
  131. data/ext/libmemcached-0.32/docs/memcached_cas.3 +308 -0
  132. data/ext/libmemcached-0.32/docs/memcached_cas_by_key.3 +308 -0
  133. data/ext/libmemcached-0.32/docs/memcached_clone.3 +183 -0
  134. data/ext/libmemcached-0.32/docs/memcached_create.3 +183 -0
  135. data/ext/libmemcached-0.32/docs/memcached_create.pod +61 -0
  136. data/ext/libmemcached-0.32/docs/memcached_decrement.3 +219 -0
  137. data/ext/libmemcached-0.32/docs/memcached_decrement_with_initial.3 +219 -0
  138. data/ext/libmemcached-0.32/docs/memcached_delete.3 +176 -0
  139. data/ext/libmemcached-0.32/docs/memcached_delete.pod +54 -0
  140. data/ext/libmemcached-0.32/docs/memcached_delete_by_key.3 +176 -0
  141. data/ext/libmemcached-0.32/docs/memcached_destroy_sasl_auth_data.3 +184 -0
  142. data/ext/libmemcached-0.32/docs/memcached_dump.3 +175 -0
  143. data/ext/libmemcached-0.32/docs/memcached_dump.pod +53 -0
  144. data/ext/libmemcached-0.32/docs/memcached_fetch.3 +283 -0
  145. data/ext/libmemcached-0.32/docs/memcached_fetch_execute.3 +283 -0
  146. data/ext/libmemcached-0.32/docs/memcached_fetch_result.3 +283 -0
  147. data/ext/libmemcached-0.32/docs/memcached_flush.pod +46 -0
  148. data/ext/libmemcached-0.32/docs/memcached_flush_buffers.3 +164 -0
  149. data/ext/libmemcached-0.32/docs/memcached_flush_buffers.pod +42 -0
  150. data/ext/libmemcached-0.32/docs/memcached_free.3 +183 -0
  151. data/ext/libmemcached-0.32/docs/memcached_generate_hash_value.3 +179 -0
  152. data/ext/libmemcached-0.32/docs/memcached_generate_hash_value.pod +57 -0
  153. data/ext/libmemcached-0.32/docs/memcached_get.3 +283 -0
  154. data/ext/libmemcached-0.32/docs/memcached_get.pod +161 -0
  155. data/ext/libmemcached-0.32/docs/memcached_get_by_key.3 +283 -0
  156. data/ext/libmemcached-0.32/docs/memcached_get_memory_allocators.3 +194 -0
  157. data/ext/libmemcached-0.32/docs/memcached_get_sasl_callbacks.3 +184 -0
  158. data/ext/libmemcached-0.32/docs/memcached_get_user_data.3 +171 -0
  159. data/ext/libmemcached-0.32/docs/memcached_increment.3 +219 -0
  160. data/ext/libmemcached-0.32/docs/memcached_increment_with_initial.3 +219 -0
  161. data/ext/libmemcached-0.32/docs/memcached_lib_version.3 +176 -0
  162. data/ext/libmemcached-0.32/docs/memcached_memory_allocators.pod +73 -0
  163. data/ext/libmemcached-0.32/docs/memcached_mget.3 +283 -0
  164. data/ext/libmemcached-0.32/docs/memcached_mget_by_key.3 +283 -0
  165. data/ext/libmemcached-0.32/docs/memcached_pool.pod +77 -0
  166. data/ext/libmemcached-0.32/docs/memcached_prepend.3 +308 -0
  167. data/ext/libmemcached-0.32/docs/memcached_prepend_by_key.3 +308 -0
  168. data/ext/libmemcached-0.32/docs/memcached_quit.3 +169 -0
  169. data/ext/libmemcached-0.32/docs/memcached_quit.pod +47 -0
  170. data/ext/libmemcached-0.32/docs/memcached_replace.3 +308 -0
  171. data/ext/libmemcached-0.32/docs/memcached_replace_by_key.3 +308 -0
  172. data/ext/libmemcached-0.32/docs/memcached_sasl.pod +63 -0
  173. data/ext/libmemcached-0.32/docs/memcached_server_add.3 +224 -0
  174. data/ext/libmemcached-0.32/docs/memcached_server_count.3 +224 -0
  175. data/ext/libmemcached-0.32/docs/memcached_server_list.3 +224 -0
  176. data/ext/libmemcached-0.32/docs/memcached_server_list_append.3 +196 -0
  177. data/ext/libmemcached-0.32/docs/memcached_server_list_count.3 +196 -0
  178. data/ext/libmemcached-0.32/docs/memcached_server_list_free.3 +196 -0
  179. data/ext/libmemcached-0.32/docs/memcached_server_push.3 +224 -0
  180. data/ext/libmemcached-0.32/docs/memcached_server_st.pod +75 -0
  181. data/ext/libmemcached-0.32/docs/memcached_servers.pod +102 -0
  182. data/ext/libmemcached-0.32/docs/memcached_servers_parse.3 +196 -0
  183. data/ext/libmemcached-0.32/docs/memcached_set.3 +308 -0
  184. data/ext/libmemcached-0.32/docs/memcached_set.pod +187 -0
  185. data/ext/libmemcached-0.32/docs/memcached_set_by_key.3 +308 -0
  186. data/ext/libmemcached-0.32/docs/memcached_set_memory_allocators.3 +194 -0
  187. data/ext/libmemcached-0.32/docs/memcached_set_sasl_auth_data.3 +184 -0
  188. data/ext/libmemcached-0.32/docs/memcached_set_sasl_callbacks.3 +184 -0
  189. data/ext/libmemcached-0.32/docs/memcached_set_user_data.3 +171 -0
  190. data/ext/libmemcached-0.32/docs/memcached_stat.3 +204 -0
  191. data/ext/libmemcached-0.32/docs/memcached_stat_get_keys.3 +204 -0
  192. data/ext/libmemcached-0.32/docs/memcached_stat_get_value.3 +204 -0
  193. data/ext/libmemcached-0.32/docs/memcached_stat_servername.3 +204 -0
  194. data/ext/libmemcached-0.32/docs/memcached_stats.pod +82 -0
  195. data/ext/libmemcached-0.32/docs/memcached_strerror.3 +168 -0
  196. data/ext/libmemcached-0.32/docs/memcached_strerror.pod +46 -0
  197. data/ext/libmemcached-0.32/docs/memcached_user_data.pod +49 -0
  198. data/ext/libmemcached-0.32/docs/memcached_verbosity.3 +163 -0
  199. data/ext/libmemcached-0.32/docs/memcached_verbosity.pod +41 -0
  200. data/ext/libmemcached-0.32/docs/memcached_version.3 +176 -0
  201. data/ext/libmemcached-0.32/docs/memcached_version.pod +56 -0
  202. data/ext/libmemcached-0.32/docs/memcat.1 +161 -0
  203. data/ext/libmemcached-0.32/docs/memcat.pod +37 -0
  204. data/ext/libmemcached-0.32/docs/memcp.1 +164 -0
  205. data/ext/libmemcached-0.32/docs/memcp.pod +40 -0
  206. data/ext/libmemcached-0.32/docs/memdump.1 +155 -0
  207. data/ext/libmemcached-0.32/docs/memdump.pod +31 -0
  208. data/ext/libmemcached-0.32/docs/memerror.1 +154 -0
  209. data/ext/libmemcached-0.32/docs/memerror.pod +30 -0
  210. data/ext/libmemcached-0.32/docs/memflush.1 +159 -0
  211. data/ext/libmemcached-0.32/docs/memflush.pod +35 -0
  212. data/ext/libmemcached-0.32/docs/memrm.1 +158 -0
  213. data/ext/libmemcached-0.32/docs/memrm.pod +34 -0
  214. data/ext/libmemcached-0.32/docs/memslap.1 +157 -0
  215. data/ext/libmemcached-0.32/docs/memslap.pod +33 -0
  216. data/ext/libmemcached-0.32/docs/memstat.1 +159 -0
  217. data/ext/libmemcached-0.32/docs/memstat.pod +35 -0
  218. data/ext/libmemcached-0.32/libmemcached/Makefile +1069 -0
  219. data/ext/libmemcached-0.32/libmemcached/Makefile.am +111 -0
  220. data/ext/libmemcached-0.32/libmemcached/Makefile.in +1069 -0
  221. data/ext/libmemcached-0.32/libmemcached/byteorder.c +31 -0
  222. data/ext/libmemcached-0.32/libmemcached/common.h +189 -0
  223. data/ext/libmemcached-0.32/libmemcached/crc.c +86 -0
  224. data/ext/libmemcached-0.32/libmemcached/hsieh_hash.c +68 -0
  225. data/ext/libmemcached-0.32/libmemcached/jenkins_hash.c +213 -0
  226. data/ext/libmemcached-0.32/libmemcached/libmemcached.la +41 -0
  227. data/ext/libmemcached-0.32/libmemcached/libmemcached.ver +1 -0
  228. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-byteorder.lo +12 -0
  229. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-byteorder.o +0 -0
  230. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-crc.lo +12 -0
  231. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-crc.o +0 -0
  232. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-jenkins_hash.lo +12 -0
  233. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-jenkins_hash.o +0 -0
  234. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-md5.lo +12 -0
  235. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-md5.o +0 -0
  236. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached.lo +12 -0
  237. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached.o +0 -0
  238. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_allocators.lo +12 -0
  239. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_allocators.o +0 -0
  240. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_analyze.lo +12 -0
  241. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_analyze.o +0 -0
  242. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_auto.lo +12 -0
  243. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_auto.o +0 -0
  244. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_behavior.lo +12 -0
  245. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_behavior.o +0 -0
  246. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_connect.lo +12 -0
  247. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_connect.o +0 -0
  248. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_delete.lo +12 -0
  249. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_delete.o +0 -0
  250. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_do.lo +12 -0
  251. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_do.o +0 -0
  252. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_dump.lo +12 -0
  253. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_dump.o +0 -0
  254. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_exist.lo +12 -0
  255. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_exist.o +0 -0
  256. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_fetch.lo +12 -0
  257. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_fetch.o +0 -0
  258. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_flush.lo +12 -0
  259. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_flush.o +0 -0
  260. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_flush_buffers.lo +12 -0
  261. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_flush_buffers.o +0 -0
  262. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_get.lo +12 -0
  263. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_get.o +0 -0
  264. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_hash.lo +12 -0
  265. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_hash.o +0 -0
  266. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_hosts.lo +12 -0
  267. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_hosts.o +0 -0
  268. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_io.lo +12 -0
  269. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_io.o +0 -0
  270. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_key.lo +12 -0
  271. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_key.o +0 -0
  272. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_parse.lo +12 -0
  273. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_parse.o +0 -0
  274. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_purge.lo +12 -0
  275. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_purge.o +0 -0
  276. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_quit.lo +12 -0
  277. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_quit.o +0 -0
  278. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_response.lo +12 -0
  279. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_response.o +0 -0
  280. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_result.lo +12 -0
  281. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_result.o +0 -0
  282. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_sasl.lo +12 -0
  283. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_sasl.o +0 -0
  284. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_server.lo +12 -0
  285. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_server.o +0 -0
  286. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_stats.lo +12 -0
  287. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_stats.o +0 -0
  288. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_storage.lo +12 -0
  289. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_storage.o +0 -0
  290. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_strerror.lo +12 -0
  291. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_strerror.o +0 -0
  292. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_string.lo +12 -0
  293. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_string.o +0 -0
  294. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_touch.lo +12 -0
  295. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_touch.o +0 -0
  296. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_verbosity.lo +12 -0
  297. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_verbosity.o +0 -0
  298. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_version.lo +12 -0
  299. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-memcached_version.o +0 -0
  300. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-murmur_hash.lo +12 -0
  301. data/ext/libmemcached-0.32/libmemcached/libmemcached_la-murmur_hash.o +0 -0
  302. data/ext/libmemcached-0.32/libmemcached/libmemcached_probes.d +30 -0
  303. data/ext/libmemcached-0.32/libmemcached/libmemcached_probes.h +82 -0
  304. data/ext/libmemcached-0.32/libmemcached/libmemcachedcallbacks.la +41 -0
  305. data/ext/libmemcached-0.32/libmemcached/libmemcachedcallbacks_la-memcached_callback.lo +12 -0
  306. data/ext/libmemcached-0.32/libmemcached/libmemcachedcallbacks_la-memcached_callback.o +0 -0
  307. data/ext/libmemcached-0.32/libmemcached/md5.c +354 -0
  308. data/ext/libmemcached-0.32/libmemcached/memcached.c +152 -0
  309. data/ext/libmemcached-0.32/libmemcached/memcached.h +304 -0
  310. data/ext/libmemcached-0.32/libmemcached/memcached.hpp +799 -0
  311. data/ext/libmemcached-0.32/libmemcached/memcached/README.txt +7 -0
  312. data/ext/libmemcached-0.32/libmemcached/memcached/protocol_binary.h +385 -0
  313. data/ext/libmemcached-0.32/libmemcached/memcached_allocators.c +72 -0
  314. data/ext/libmemcached-0.32/libmemcached/memcached_analyze.c +100 -0
  315. data/ext/libmemcached-0.32/libmemcached/memcached_auto.c +207 -0
  316. data/ext/libmemcached-0.32/libmemcached/memcached_behavior.c +285 -0
  317. data/ext/libmemcached-0.32/libmemcached/memcached_callback.c +175 -0
  318. data/ext/libmemcached-0.32/libmemcached/memcached_configure.h +23 -0
  319. data/ext/libmemcached-0.32/libmemcached/memcached_configure.h.in +23 -0
  320. data/ext/libmemcached-0.32/libmemcached/memcached_connect.c +371 -0
  321. data/ext/libmemcached-0.32/libmemcached/memcached_constants.h +145 -0
  322. data/ext/libmemcached-0.32/libmemcached/memcached_delete.c +0 -0
  323. data/ext/libmemcached-0.32/libmemcached/memcached_do.c +70 -0
  324. data/ext/libmemcached-0.32/libmemcached/memcached_dump.c +79 -0
  325. data/ext/libmemcached-0.32/libmemcached/memcached_exist.c +114 -0
  326. data/ext/libmemcached-0.32/libmemcached/memcached_exist.h +20 -0
  327. data/ext/libmemcached-0.32/libmemcached/memcached_fetch.c +102 -0
  328. data/ext/libmemcached-0.32/libmemcached/memcached_flush.c +89 -0
  329. data/ext/libmemcached-0.32/libmemcached/memcached_flush_buffers.c +22 -0
  330. data/ext/libmemcached-0.32/libmemcached/memcached_get.c +494 -0
  331. data/ext/libmemcached-0.32/libmemcached/memcached_get.h +87 -0
  332. data/ext/libmemcached-0.32/libmemcached/memcached_hash.c +252 -0
  333. data/ext/libmemcached-0.32/libmemcached/memcached_hosts.c +510 -0
  334. data/ext/libmemcached-0.32/libmemcached/memcached_internal.h +31 -0
  335. data/ext/libmemcached-0.32/libmemcached/memcached_io.c +575 -0
  336. data/ext/libmemcached-0.32/libmemcached/memcached_io.h +72 -0
  337. data/ext/libmemcached-0.32/libmemcached/memcached_key.c +28 -0
  338. data/ext/libmemcached-0.32/libmemcached/memcached_parse.c +74 -0
  339. data/ext/libmemcached-0.32/libmemcached/memcached_pool.h +38 -0
  340. data/ext/libmemcached-0.32/libmemcached/memcached_purge.c +76 -0
  341. data/ext/libmemcached-0.32/libmemcached/memcached_quit.c +75 -0
  342. data/ext/libmemcached-0.32/libmemcached/memcached_response.c +529 -0
  343. data/ext/libmemcached-0.32/libmemcached/memcached_result.c +57 -0
  344. data/ext/libmemcached-0.32/libmemcached/memcached_result.h +59 -0
  345. data/ext/libmemcached-0.32/libmemcached/memcached_sasl.c +225 -0
  346. data/ext/libmemcached-0.32/libmemcached/memcached_sasl.h +44 -0
  347. data/ext/libmemcached-0.32/libmemcached/memcached_server.c +159 -0
  348. data/ext/libmemcached-0.32/libmemcached/memcached_server.h +93 -0
  349. data/ext/libmemcached-0.32/libmemcached/memcached_stats.c +437 -0
  350. data/ext/libmemcached-0.32/libmemcached/memcached_storage.c +515 -0
  351. data/ext/libmemcached-0.32/libmemcached/memcached_storage.h +107 -0
  352. data/ext/libmemcached-0.32/libmemcached/memcached_strerror.c +92 -0
  353. data/ext/libmemcached-0.32/libmemcached/memcached_string.c +138 -0
  354. data/ext/libmemcached-0.32/libmemcached/memcached_string.h +53 -0
  355. data/ext/libmemcached-0.32/libmemcached/memcached_touch.c +60 -0
  356. data/ext/libmemcached-0.32/libmemcached/memcached_touch.h +31 -0
  357. data/ext/libmemcached-0.32/libmemcached/memcached_types.h +44 -0
  358. data/ext/libmemcached-0.32/libmemcached/memcached_util.h +15 -0
  359. data/ext/libmemcached-0.32/libmemcached/memcached_verbosity.c +36 -0
  360. data/ext/libmemcached-0.32/libmemcached/memcached_version.c +112 -0
  361. data/ext/libmemcached-0.32/libmemcached/memcached_watchpoint.h +38 -0
  362. data/ext/libmemcached-0.32/libmemcached/murmur_hash.c +76 -0
  363. data/ext/libmemcached-0.32/libmemcached/visibility.h +51 -0
  364. data/ext/libmemcached-0.32/libmemcachedutil/Makefile +604 -0
  365. data/ext/libmemcached-0.32/libmemcachedutil/Makefile.am +11 -0
  366. data/ext/libmemcached-0.32/libmemcachedutil/Makefile.in +604 -0
  367. data/ext/libmemcached-0.32/libmemcachedutil/libmemcachedutil.ver +1 -0
  368. data/ext/libmemcached-0.32/libmemcachedutil/memcached_pool.c +170 -0
  369. data/ext/libmemcached-0.32/libtool +10223 -0
  370. data/ext/libmemcached-0.32/m4/ac_cxx_compile_stdcxx_0x.m4 +103 -0
  371. data/ext/libmemcached-0.32/m4/ac_cxx_header_stdcxx_98.m4 +67 -0
  372. data/ext/libmemcached-0.32/m4/acx_pthread.m4 +276 -0
  373. data/ext/libmemcached-0.32/m4/byteorder.m4 +40 -0
  374. data/ext/libmemcached-0.32/m4/deprecated.m4 +17 -0
  375. data/ext/libmemcached-0.32/m4/enable_utillib.m4 +16 -0
  376. data/ext/libmemcached-0.32/m4/extensions.m4 +94 -0
  377. data/ext/libmemcached-0.32/m4/hsieh.m4 +18 -0
  378. data/ext/libmemcached-0.32/m4/lib-prefix.m4 +221 -0
  379. data/ext/libmemcached-0.32/m4/libtool.m4 +7831 -0
  380. data/ext/libmemcached-0.32/m4/ltoptions.m4 +369 -0
  381. data/ext/libmemcached-0.32/m4/ltsugar.m4 +123 -0
  382. data/ext/libmemcached-0.32/m4/ltversion.m4 +23 -0
  383. data/ext/libmemcached-0.32/m4/lt~obsolete.m4 +98 -0
  384. data/ext/libmemcached-0.32/m4/memcached.m4 +30 -0
  385. data/ext/libmemcached-0.32/m4/pandora_64bit.m4 +55 -0
  386. data/ext/libmemcached-0.32/m4/pandora_canonical.m4 +151 -0
  387. data/ext/libmemcached-0.32/m4/pandora_check_compiler_version.m4 +37 -0
  388. data/ext/libmemcached-0.32/m4/pandora_check_cxx_standard.m4 +16 -0
  389. data/ext/libmemcached-0.32/m4/pandora_enable_dtrace.m4 +41 -0
  390. data/ext/libmemcached-0.32/m4/pandora_ensure_gcc_version.m4 +36 -0
  391. data/ext/libmemcached-0.32/m4/pandora_have_better_malloc.m4 +54 -0
  392. data/ext/libmemcached-0.32/m4/pandora_have_sasl.m4 +133 -0
  393. data/ext/libmemcached-0.32/m4/pandora_header_assert.m4 +23 -0
  394. data/ext/libmemcached-0.32/m4/pandora_libtool.m4 +15 -0
  395. data/ext/libmemcached-0.32/m4/pandora_optimize.m4 +79 -0
  396. data/ext/libmemcached-0.32/m4/pandora_shared_ptr.m4 +56 -0
  397. data/ext/libmemcached-0.32/m4/pandora_vc_build.m4 +32 -0
  398. data/ext/libmemcached-0.32/m4/pandora_warnings.m4 +262 -0
  399. data/ext/libmemcached-0.32/m4/pod2man.m4 +7 -0
  400. data/ext/libmemcached-0.32/m4/protocol_binary.m4 +23 -0
  401. data/ext/libmemcached-0.32/m4/setsockopt.m4 +57 -0
  402. data/ext/libmemcached-0.32/m4/visibility.m4 +52 -0
  403. data/ext/libmemcached-0.32/stamp-h1 +1 -0
  404. data/ext/libmemcached-0.32/support/Makefile +487 -0
  405. data/ext/libmemcached-0.32/support/Makefile.am +4 -0
  406. data/ext/libmemcached-0.32/support/Makefile.in +487 -0
  407. data/ext/libmemcached-0.32/support/libmemcached-fc.spec +105 -0
  408. data/ext/libmemcached-0.32/support/libmemcached-fc.spec.in +105 -0
  409. data/ext/libmemcached-0.32/support/libmemcached.pc +10 -0
  410. data/ext/libmemcached-0.32/support/libmemcached.pc.in +10 -0
  411. data/ext/libmemcached-0.32/support/libmemcached.spec +105 -0
  412. data/ext/libmemcached-0.32/support/libmemcached.spec.in +105 -0
  413. data/ext/libmemcached-0.32/support/set_benchmark.sh +5 -0
  414. data/ext/libmemcached-0.32/tests/Makefile +762 -0
  415. data/ext/libmemcached-0.32/tests/Makefile.am +113 -0
  416. data/ext/libmemcached-0.32/tests/Makefile.in +762 -0
  417. data/ext/libmemcached-0.32/tests/atomsmasher +0 -0
  418. data/ext/libmemcached-0.32/tests/atomsmasher.c +245 -0
  419. data/ext/libmemcached-0.32/tests/atomsmasher.o +0 -0
  420. data/ext/libmemcached-0.32/tests/function.c +4893 -0
  421. data/ext/libmemcached-0.32/tests/ketama_test_cases.h +108 -0
  422. data/ext/libmemcached-0.32/tests/libserver.la +41 -0
  423. data/ext/libmemcached-0.32/tests/libtest.la +41 -0
  424. data/ext/libmemcached-0.32/tests/output.cmp +7 -0
  425. data/ext/libmemcached-0.32/tests/output.res +7 -0
  426. data/ext/libmemcached-0.32/tests/output2.res +46 -0
  427. data/ext/libmemcached-0.32/tests/plus.cpp +293 -0
  428. data/ext/libmemcached-0.32/tests/plus.o +0 -0
  429. data/ext/libmemcached-0.32/tests/r/memcat.res +19 -0
  430. data/ext/libmemcached-0.32/tests/r/memcp.res +27 -0
  431. data/ext/libmemcached-0.32/tests/r/memrm.res +19 -0
  432. data/ext/libmemcached-0.32/tests/r/memslap.res +33 -0
  433. data/ext/libmemcached-0.32/tests/r/memstat.res +33 -0
  434. data/ext/libmemcached-0.32/tests/server.c +118 -0
  435. data/ext/libmemcached-0.32/tests/server.h +25 -0
  436. data/ext/libmemcached-0.32/tests/server.lo +12 -0
  437. data/ext/libmemcached-0.32/tests/server.o +0 -0
  438. data/ext/libmemcached-0.32/tests/start.c +16 -0
  439. data/ext/libmemcached-0.32/tests/start.o +0 -0
  440. data/ext/libmemcached-0.32/tests/startservers +0 -0
  441. data/ext/libmemcached-0.32/tests/t/memcat.test +4 -0
  442. data/ext/libmemcached-0.32/tests/t/memcp.test +3 -0
  443. data/ext/libmemcached-0.32/tests/t/memrm.test +3 -0
  444. data/ext/libmemcached-0.32/tests/t/memslap.test +5 -0
  445. data/ext/libmemcached-0.32/tests/t/memstat.test +3 -0
  446. data/ext/libmemcached-0.32/tests/test.c +137 -0
  447. data/ext/libmemcached-0.32/tests/test.h +46 -0
  448. data/ext/libmemcached-0.32/tests/test.lo +12 -0
  449. data/ext/libmemcached-0.32/tests/test.o +0 -0
  450. data/ext/libmemcached-0.32/tests/testapp +0 -0
  451. data/ext/libmemcached-0.32/tests/testapp-function.o +0 -0
  452. data/ext/libmemcached-0.32/tests/testplus +0 -0
  453. data/ext/libmemcached-0.32/tests/udp.c +76 -0
  454. data/ext/libmemcached-0.32/tests/udp.o +0 -0
  455. data/ext/libmemcached-0.32/tests/udptest +0 -0
  456. data/ext/rlibmemcached.bundle +0 -0
  457. data/ext/rlibmemcached.i +249 -0
  458. data/ext/rlibmemcached_wrap.c +13781 -0
  459. data/ext/rlibmemcached_wrap.o +0 -0
  460. data/ext/share/man/man1/memcat.1 +161 -0
  461. data/ext/share/man/man1/memcp.1 +164 -0
  462. data/ext/share/man/man1/memdump.1 +155 -0
  463. data/ext/share/man/man1/memerror.1 +154 -0
  464. data/ext/share/man/man1/memflush.1 +159 -0
  465. data/ext/share/man/man1/memrm.1 +158 -0
  466. data/ext/share/man/man1/memslap.1 +157 -0
  467. data/ext/share/man/man1/memstat.1 +159 -0
  468. data/ext/share/man/man3/libmemcached.3 +229 -0
  469. data/ext/share/man/man3/libmemcached_examples.3 +242 -0
  470. data/ext/share/man/man3/memcached_add.3 +308 -0
  471. data/ext/share/man/man3/memcached_add_by_key.3 +308 -0
  472. data/ext/share/man/man3/memcached_analyze.3 +175 -0
  473. data/ext/share/man/man3/memcached_append.3 +308 -0
  474. data/ext/share/man/man3/memcached_append_by_key.3 +308 -0
  475. data/ext/share/man/man3/memcached_behavior_get.3 +317 -0
  476. data/ext/share/man/man3/memcached_behavior_set.3 +317 -0
  477. data/ext/share/man/man3/memcached_callback_get.3 +231 -0
  478. data/ext/share/man/man3/memcached_callback_set.3 +231 -0
  479. data/ext/share/man/man3/memcached_cas.3 +308 -0
  480. data/ext/share/man/man3/memcached_cas_by_key.3 +308 -0
  481. data/ext/share/man/man3/memcached_clone.3 +183 -0
  482. data/ext/share/man/man3/memcached_create.3 +183 -0
  483. data/ext/share/man/man3/memcached_decrement.3 +219 -0
  484. data/ext/share/man/man3/memcached_decrement_with_initial.3 +219 -0
  485. data/ext/share/man/man3/memcached_delete.3 +176 -0
  486. data/ext/share/man/man3/memcached_delete_by_key.3 +176 -0
  487. data/ext/share/man/man3/memcached_destroy_sasl_auth_data.3 +184 -0
  488. data/ext/share/man/man3/memcached_dump.3 +175 -0
  489. data/ext/share/man/man3/memcached_fetch.3 +283 -0
  490. data/ext/share/man/man3/memcached_fetch_execute.3 +283 -0
  491. data/ext/share/man/man3/memcached_fetch_result.3 +283 -0
  492. data/ext/share/man/man3/memcached_flush_buffers.3 +164 -0
  493. data/ext/share/man/man3/memcached_free.3 +183 -0
  494. data/ext/share/man/man3/memcached_generate_hash_value.3 +179 -0
  495. data/ext/share/man/man3/memcached_get.3 +283 -0
  496. data/ext/share/man/man3/memcached_get_by_key.3 +283 -0
  497. data/ext/share/man/man3/memcached_get_memory_allocators.3 +194 -0
  498. data/ext/share/man/man3/memcached_get_sasl_callbacks.3 +184 -0
  499. data/ext/share/man/man3/memcached_get_user_data.3 +171 -0
  500. data/ext/share/man/man3/memcached_increment.3 +219 -0
  501. data/ext/share/man/man3/memcached_increment_with_initial.3 +219 -0
  502. data/ext/share/man/man3/memcached_lib_version.3 +176 -0
  503. data/ext/share/man/man3/memcached_mget.3 +283 -0
  504. data/ext/share/man/man3/memcached_mget_by_key.3 +283 -0
  505. data/ext/share/man/man3/memcached_prepend.3 +308 -0
  506. data/ext/share/man/man3/memcached_prepend_by_key.3 +308 -0
  507. data/ext/share/man/man3/memcached_quit.3 +169 -0
  508. data/ext/share/man/man3/memcached_replace.3 +308 -0
  509. data/ext/share/man/man3/memcached_replace_by_key.3 +308 -0
  510. data/ext/share/man/man3/memcached_server_add.3 +224 -0
  511. data/ext/share/man/man3/memcached_server_count.3 +224 -0
  512. data/ext/share/man/man3/memcached_server_list.3 +224 -0
  513. data/ext/share/man/man3/memcached_server_list_append.3 +196 -0
  514. data/ext/share/man/man3/memcached_server_list_count.3 +196 -0
  515. data/ext/share/man/man3/memcached_server_list_free.3 +196 -0
  516. data/ext/share/man/man3/memcached_server_push.3 +224 -0
  517. data/ext/share/man/man3/memcached_servers_parse.3 +196 -0
  518. data/ext/share/man/man3/memcached_set.3 +308 -0
  519. data/ext/share/man/man3/memcached_set_by_key.3 +308 -0
  520. data/ext/share/man/man3/memcached_set_memory_allocators.3 +194 -0
  521. data/ext/share/man/man3/memcached_set_sasl_auth_data.3 +184 -0
  522. data/ext/share/man/man3/memcached_set_sasl_callbacks.3 +184 -0
  523. data/ext/share/man/man3/memcached_set_user_data.3 +171 -0
  524. data/ext/share/man/man3/memcached_stat.3 +204 -0
  525. data/ext/share/man/man3/memcached_stat_get_keys.3 +204 -0
  526. data/ext/share/man/man3/memcached_stat_get_value.3 +204 -0
  527. data/ext/share/man/man3/memcached_stat_servername.3 +204 -0
  528. data/ext/share/man/man3/memcached_strerror.3 +168 -0
  529. data/ext/share/man/man3/memcached_verbosity.3 +163 -0
  530. data/ext/share/man/man3/memcached_version.3 +176 -0
  531. data/lib/memcached.rb +32 -0
  532. data/lib/memcached/behaviors.rb +77 -0
  533. data/lib/memcached/exceptions.rb +84 -0
  534. data/lib/memcached/experimental.rb +48 -0
  535. data/lib/memcached/memcached.rb +683 -0
  536. data/lib/memcached/rails.rb +200 -0
  537. data/test/test_helper.rb +19 -0
  538. data/test/unit/binding_test.rb +8 -0
  539. data/test/unit/memcached_experimental_test.rb +274 -0
  540. data/test/unit/memcached_test.rb +1340 -0
  541. data/test/unit/rails_test.rb +282 -0
  542. metadata +658 -0
@@ -0,0 +1,283 @@
1
+ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
2
+ .\"
3
+ .\" Standard preamble:
4
+ .\" ========================================================================
5
+ .de Sp \" Vertical space (when we can't use .PP)
6
+ .if t .sp .5v
7
+ .if n .sp
8
+ ..
9
+ .de Vb \" Begin verbatim text
10
+ .ft CW
11
+ .nf
12
+ .ne \\$1
13
+ ..
14
+ .de Ve \" End verbatim text
15
+ .ft R
16
+ .fi
17
+ ..
18
+ .\" Set up some character translations and predefined strings. \*(-- will
19
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20
+ .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21
+ .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22
+ .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23
+ .\" nothing in troff, for use with C<>.
24
+ .tr \(*W-
25
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26
+ .ie n \{\
27
+ . ds -- \(*W-
28
+ . ds PI pi
29
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31
+ . ds L" ""
32
+ . ds R" ""
33
+ . ds C` ""
34
+ . ds C' ""
35
+ 'br\}
36
+ .el\{\
37
+ . ds -- \|\(em\|
38
+ . ds PI \(*p
39
+ . ds L" ``
40
+ . ds R" ''
41
+ 'br\}
42
+ .\"
43
+ .\" Escape single quotes in literal strings from groff's Unicode transform.
44
+ .ie \n(.g .ds Aq \(aq
45
+ .el .ds Aq '
46
+ .\"
47
+ .\" If the F register is turned on, we'll generate index entries on stderr for
48
+ .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49
+ .\" entries marked with X<> in POD. Of course, you'll have to process the
50
+ .\" output yourself in some meaningful fashion.
51
+ .ie \nF \{\
52
+ . de IX
53
+ . tm Index:\\$1\t\\n%\t"\\$2"
54
+ ..
55
+ . nr % 0
56
+ . rr F
57
+ .\}
58
+ .el \{\
59
+ . de IX
60
+ ..
61
+ .\}
62
+ .\"
63
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
65
+ . \" fudge factors for nroff and troff
66
+ .if n \{\
67
+ . ds #H 0
68
+ . ds #V .8m
69
+ . ds #F .3m
70
+ . ds #[ \f1
71
+ . ds #] \fP
72
+ .\}
73
+ .if t \{\
74
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75
+ . ds #V .6m
76
+ . ds #F 0
77
+ . ds #[ \&
78
+ . ds #] \&
79
+ .\}
80
+ . \" simple accents for nroff and troff
81
+ .if n \{\
82
+ . ds ' \&
83
+ . ds ` \&
84
+ . ds ^ \&
85
+ . ds , \&
86
+ . ds ~ ~
87
+ . ds /
88
+ .\}
89
+ .if t \{\
90
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96
+ .\}
97
+ . \" troff and (daisy-wheel) nroff accents
98
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105
+ .ds ae a\h'-(\w'a'u*4/10)'e
106
+ .ds Ae A\h'-(\w'A'u*4/10)'E
107
+ . \" corrections for vroff
108
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110
+ . \" for low resolution devices (crt and lpr)
111
+ .if \n(.H>23 .if \n(.V>19 \
112
+ \{\
113
+ . ds : e
114
+ . ds 8 ss
115
+ . ds o a
116
+ . ds d- d\h'-1'\(ga
117
+ . ds D- D\h'-1'\(hy
118
+ . ds th \o'bp'
119
+ . ds Th \o'LP'
120
+ . ds ae ae
121
+ . ds Ae AE
122
+ .\}
123
+ .rm #[ #] #H #V #F C
124
+ .\" ========================================================================
125
+ .\"
126
+ .IX Title "..::docs::memcached_get 3"
127
+ .TH ..::docs::memcached_get 3 "2012-10-24" "" "libmemcached"
128
+ .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129
+ .\" way too many mistakes in technical documents.
130
+ .if n .ad l
131
+ .nh
132
+ .SH "NAME"
133
+ memcached_get, memcached_get_len, memcached_mget, memcached_mget_len, memcached_fetch \- Get a value
134
+ .SH "LIBRARY"
135
+ .IX Header "LIBRARY"
136
+ C Client Library for memcached (libmemcached, \-lmemcached)
137
+ .SH "SYNOPSIS"
138
+ .IX Header "SYNOPSIS"
139
+ .Vb 1
140
+ \& #include <memcached.h>
141
+ \&
142
+ \& memcached_result_st *
143
+ \& memcached_fetch_result(memcached_st *ptr,
144
+ \& memcached_result_st *result,
145
+ \& memcached_return *error);
146
+ \&
147
+ \& char *memcached_get(memcached_st *ptr,
148
+ \& const char *key, size_t key_length,
149
+ \& size_t *value_length,
150
+ \& uint32_t *flags,
151
+ \& memcached_return *error);
152
+ \&
153
+ \& memcached_return
154
+ \& memcached_mget(memcached_st *ptr,
155
+ \& char **keys, size_t *key_length,
156
+ \& size_t number_of_keys);
157
+ \& char *
158
+ \& memcached_get_by_key(memcached_st *ptr,
159
+ \& const char *master_key, size_t master_key_length,
160
+ \& const char *key, size_t key_length,
161
+ \& uint32_t user_spec_len,
162
+ \& size_t *value_length,
163
+ \& uint32_t *flags,
164
+ \& memcached_return *error);
165
+ \&
166
+ \& memcached_return
167
+ \& memcached_mget_by_key(memcached_st *ptr,
168
+ \& const char *master_key, size_t master_key_length,
169
+ \& char **keys, size_t *key_length,
170
+ \& size_t number_of_keys,
171
+ \& uint32_t user_spec_len);
172
+ \&
173
+ \& char *memcached_fetch(memcached_st *ptr,
174
+ \& char *key, size_t *key_length,
175
+ \& size_t *value_length,
176
+ \& uint32_t *flags,
177
+ \& memcached_return *error);
178
+ \& memcached_return
179
+ \& memcached_fetch_execute(memcached_st *ptr,
180
+ \& memcached_return (*callback[])(memcached_st *ptr, memcached_result_st *result, void *context),
181
+ \& void *context,
182
+ \& unsigned int number_of_callbacks);
183
+ \&
184
+ \& char *
185
+ \& memcached_get_len(memcached_st *ptr,
186
+ \& const char *key, size_t key_length,
187
+ \& uint32_t user_spec_len,
188
+ \& size_t *value_length,
189
+ \& uint32_t *flags,
190
+ \& memcached_return *error);
191
+ \&
192
+ \& memcached_return
193
+ \& memcached_mget_len(memcached_st *ptr,
194
+ \& const char **keys, size_t *key_length,
195
+ \& size_t number_of_keys, uint32_t user_spec_len);
196
+ .Ve
197
+ .SH "DESCRIPTION"
198
+ .IX Header "DESCRIPTION"
199
+ \&\fImemcached_get()\fR is used to fetch an individual value from the server. You
200
+ must pass in a key and its length to fetch the object. You must supply
201
+ three pointer variables which will give you the state of the returned
202
+ object. A uint32_t pointer to contain whatever flags you stored with the value,
203
+ a size_t pointer which will be filled with size of of the object, and a
204
+ memcached_return pointer to hold any error. The object will be returned
205
+ upon success and \s-1NULL\s0 will be returned on failure. Any object returned by
206
+ \&\fImemcached_get()\fR must be released by the caller application.
207
+ .PP
208
+ \&\fImemcached_get_len()\fR is also used to fetch an individual value from the
209
+ server. The only difference when compared to \fImemcached_get()\fR is that
210
+ the server will only send back the first n bytes of the value where n is
211
+ specified by the user. Note that this command is only available when
212
+ using the ascii protocol.
213
+ .PP
214
+ \&\fImemcached_mget()\fR is used to select multiple keys at once. For multiple key
215
+ operations it is always faster to use this function. This function always
216
+ works asynchronously. \fImemcached_fetch()\fR is then used to retrieve any keys
217
+ found. No error is given on keys that are not found. You must call either
218
+ \&\fImemcached_fetch()\fR or \fImemcached_fetch_result()\fR after a successful call to
219
+ \&\fImemcached_mget()\fR. You should continue to call these functions until they
220
+ return \s-1NULL\s0 (aka no more values). If you need to quit in the middle of a
221
+ \&\fImemcached_get()\fR call, execute a \fImemcached_quit()\fR. After you do this, you can
222
+ issue new queries against the server.
223
+ .PP
224
+ \&\fImemcached_mget_len()\fR is also used to select multiple keys at once. The
225
+ only difference when compared to \fImemcached_mget()\fR is that the server
226
+ will only send back the first n bytes of each value where n is
227
+ specified by the user. Note that this command is only available when
228
+ using the ascii protocol.
229
+ .PP
230
+ \&\fImemcached_fetch()\fR is used to fetch an individual value from the server.
231
+ \&\fImemcached_mget()\fR or \fImemcached_mget_len()\fR must always be called before
232
+ using this method. You must pass in a key and its length to fetch the
233
+ object. You must supply three pointer variables which will give you the
234
+ state of the returned object. A uint32_t pointer to contain whatever
235
+ flags you stored with the value, a size_t pointer which will be filled
236
+ with size of of the object, and a memcached_return pointer to hold any
237
+ error. The object will be returned upon success and \s-1NULL\s0 will be returned
238
+ on failure. \s-1MEMCACHD_END\s0 is returned by the *error value when all objects
239
+ that have been found are returned. The final value upon \s-1MEMCACHED_END\s0 is
240
+ null. Values returned by \fImemcached_fetch()\fR musted be free'ed by the caller.
241
+ .PP
242
+ \&\fImemcached_fetch_result()\fR is used to return a \fImemcached_result_st\fR\|(3) structure
243
+ from a memcached server. The result object is forward compatible with changes
244
+ to the server. For more information please refer to the \fImemcached_result_st\fR\|(3)
245
+ help. This function will dynamically allocate a result structure for you
246
+ if you do not pass one to the function.
247
+ .PP
248
+ \&\fImemcached_fetch_execute()\fR is a callback function for result sets. Instead
249
+ of returning the results to you for processing, it passes each of the
250
+ result sets to the list of functions you provide. It passes to the function
251
+ a memcached_st that can be cloned for use in the called function (it can not
252
+ be used directly). It also passes a result set which does not need to be freed.
253
+ Finally it passes a \*(L"context\*(R". This is just a pointer to a memory reference
254
+ you supply the calling function. Currently only one value is being passed
255
+ to each function call. In the future there will be an option to allow this
256
+ to be an array.
257
+ .PP
258
+ \&\fImemcached_get_by_key()\fR and \fImemcached_mget_by_key()\fR behave in a similar nature
259
+ as \fImemcached_get()\fR and \fImemcached_mget()\fR. The difference is that they take
260
+ a master key that is used for determining which server an object was stored
261
+ if key partitioning was used for storage.
262
+ .PP
263
+ All of the above functions are not supported when the \f(CW\*(C`MEMCACHED_BEHAVIOR_USE_UDP\*(C'\fR
264
+ has been set. Executing any of these functions with this behavior on will result in
265
+ \&\f(CW\*(C`MEMCACHED_NOT_SUPPORTED\*(C'\fR being returned or, for those functions which do not return
266
+ a \f(CW\*(C`memcached_return\*(C'\fR, the error function parameter will be set to
267
+ \&\f(CW\*(C`MEMCACHED_NOT_SUPPORTED\*(C'\fR.
268
+ .SH "RETURN"
269
+ .IX Header "RETURN"
270
+ All objects returned must be freed by the calling application.
271
+ \&\fImemcached_get()\fR, \fImemcached_get_len()\fR, and \fImemcached_fetch()\fR will return
272
+ \&\s-1NULL\s0 on error. You must look at the value of error to determine what
273
+ the actual error was.
274
+ .SH "HOME"
275
+ .IX Header "HOME"
276
+ To find out more information please check:
277
+ <http://tangent.org/552/libmemcached.html>
278
+ .SH "AUTHOR"
279
+ .IX Header "AUTHOR"
280
+ Brian Aker, <brian@tangent.org>
281
+ .SH "SEE ALSO"
282
+ .IX Header "SEE ALSO"
283
+ \&\fImemcached\fR\|(1) \fIlibmemcached\fR\|(3) \fImemcached_strerror\fR\|(3)
@@ -0,0 +1,161 @@
1
+ =head1 NAME
2
+
3
+ memcached_get, memcached_get_len, memcached_mget, memcached_mget_len, memcached_fetch - Get a value
4
+
5
+ =head1 LIBRARY
6
+
7
+ C Client Library for memcached (libmemcached, -lmemcached)
8
+
9
+ =head1 SYNOPSIS
10
+
11
+ #include <memcached.h>
12
+
13
+ memcached_result_st *
14
+ memcached_fetch_result(memcached_st *ptr,
15
+ memcached_result_st *result,
16
+ memcached_return *error);
17
+
18
+ char *memcached_get(memcached_st *ptr,
19
+ const char *key, size_t key_length,
20
+ size_t *value_length,
21
+ uint32_t *flags,
22
+ memcached_return *error);
23
+
24
+ memcached_return
25
+ memcached_mget(memcached_st *ptr,
26
+ char **keys, size_t *key_length,
27
+ size_t number_of_keys);
28
+ char *
29
+ memcached_get_by_key(memcached_st *ptr,
30
+ const char *master_key, size_t master_key_length,
31
+ const char *key, size_t key_length,
32
+ uint32_t user_spec_len,
33
+ size_t *value_length,
34
+ uint32_t *flags,
35
+ memcached_return *error);
36
+
37
+ memcached_return
38
+ memcached_mget_by_key(memcached_st *ptr,
39
+ const char *master_key, size_t master_key_length,
40
+ char **keys, size_t *key_length,
41
+ size_t number_of_keys,
42
+ uint32_t user_spec_len);
43
+
44
+ char *memcached_fetch(memcached_st *ptr,
45
+ char *key, size_t *key_length,
46
+ size_t *value_length,
47
+ uint32_t *flags,
48
+ memcached_return *error);
49
+ memcached_return
50
+ memcached_fetch_execute(memcached_st *ptr,
51
+ memcached_return (*callback[])(memcached_st *ptr, memcached_result_st *result, void *context),
52
+ void *context,
53
+ unsigned int number_of_callbacks);
54
+
55
+ char *
56
+ memcached_get_len(memcached_st *ptr,
57
+ const char *key, size_t key_length,
58
+ uint32_t user_spec_len,
59
+ size_t *value_length,
60
+ uint32_t *flags,
61
+ memcached_return *error);
62
+
63
+ memcached_return
64
+ memcached_mget_len(memcached_st *ptr,
65
+ const char **keys, size_t *key_length,
66
+ size_t number_of_keys, uint32_t user_spec_len);
67
+
68
+ =head1 DESCRIPTION
69
+
70
+ memcached_get() is used to fetch an individual value from the server. You
71
+ must pass in a key and its length to fetch the object. You must supply
72
+ three pointer variables which will give you the state of the returned
73
+ object. A uint32_t pointer to contain whatever flags you stored with the value,
74
+ a size_t pointer which will be filled with size of of the object, and a
75
+ memcached_return pointer to hold any error. The object will be returned
76
+ upon success and NULL will be returned on failure. Any object returned by
77
+ memcached_get() must be released by the caller application.
78
+
79
+ memcached_get_len() is also used to fetch an individual value from the
80
+ server. The only difference when compared to memcached_get() is that
81
+ the server will only send back the first n bytes of the value where n is
82
+ specified by the user. Note that this command is only available when
83
+ using the ascii protocol.
84
+
85
+ memcached_mget() is used to select multiple keys at once. For multiple key
86
+ operations it is always faster to use this function. This function always
87
+ works asynchronously. memcached_fetch() is then used to retrieve any keys
88
+ found. No error is given on keys that are not found. You must call either
89
+ memcached_fetch() or memcached_fetch_result() after a successful call to
90
+ memcached_mget(). You should continue to call these functions until they
91
+ return NULL (aka no more values). If you need to quit in the middle of a
92
+ memcached_get() call, execute a memcached_quit(). After you do this, you can
93
+ issue new queries against the server.
94
+
95
+ memcached_mget_len() is also used to select multiple keys at once. The
96
+ only difference when compared to memcached_mget() is that the server
97
+ will only send back the first n bytes of each value where n is
98
+ specified by the user. Note that this command is only available when
99
+ using the ascii protocol.
100
+
101
+ memcached_fetch() is used to fetch an individual value from the server.
102
+ memcached_mget() or memcached_mget_len() must always be called before
103
+ using this method. You must pass in a key and its length to fetch the
104
+ object. You must supply three pointer variables which will give you the
105
+ state of the returned object. A uint32_t pointer to contain whatever
106
+ flags you stored with the value, a size_t pointer which will be filled
107
+ with size of of the object, and a memcached_return pointer to hold any
108
+ error. The object will be returned upon success and NULL will be returned
109
+ on failure. MEMCACHD_END is returned by the *error value when all objects
110
+ that have been found are returned. The final value upon MEMCACHED_END is
111
+ null. Values returned by memcached_fetch() musted be free'ed by the caller.
112
+
113
+ memcached_fetch_result() is used to return a memcached_result_st(3) structure
114
+ from a memcached server. The result object is forward compatible with changes
115
+ to the server. For more information please refer to the memcached_result_st(3)
116
+ help. This function will dynamically allocate a result structure for you
117
+ if you do not pass one to the function.
118
+
119
+ memcached_fetch_execute() is a callback function for result sets. Instead
120
+ of returning the results to you for processing, it passes each of the
121
+ result sets to the list of functions you provide. It passes to the function
122
+ a memcached_st that can be cloned for use in the called function (it can not
123
+ be used directly). It also passes a result set which does not need to be freed.
124
+ Finally it passes a "context". This is just a pointer to a memory reference
125
+ you supply the calling function. Currently only one value is being passed
126
+ to each function call. In the future there will be an option to allow this
127
+ to be an array.
128
+
129
+ memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature
130
+ as memcached_get() and memcached_mget(). The difference is that they take
131
+ a master key that is used for determining which server an object was stored
132
+ if key partitioning was used for storage.
133
+
134
+ All of the above functions are not supported when the C<MEMCACHED_BEHAVIOR_USE_UDP>
135
+ has been set. Executing any of these functions with this behavior on will result in
136
+ C<MEMCACHED_NOT_SUPPORTED> being returned or, for those functions which do not return
137
+ a C<memcached_return>, the error function parameter will be set to
138
+ C<MEMCACHED_NOT_SUPPORTED>.
139
+
140
+ =head1 RETURN
141
+
142
+ All objects returned must be freed by the calling application.
143
+ memcached_get(), memcached_get_len(), and memcached_fetch() will return
144
+ NULL on error. You must look at the value of error to determine what
145
+ the actual error was.
146
+
147
+ =head1 HOME
148
+
149
+ To find out more information please check:
150
+ L<http://tangent.org/552/libmemcached.html>
151
+
152
+ =head1 AUTHOR
153
+
154
+ Brian Aker, E<lt>brian@tangent.orgE<gt>
155
+
156
+ =head1 SEE ALSO
157
+
158
+ memcached(1) libmemcached(3) memcached_strerror(3)
159
+
160
+ =cut
161
+
@@ -0,0 +1,283 @@
1
+ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
2
+ .\"
3
+ .\" Standard preamble:
4
+ .\" ========================================================================
5
+ .de Sp \" Vertical space (when we can't use .PP)
6
+ .if t .sp .5v
7
+ .if n .sp
8
+ ..
9
+ .de Vb \" Begin verbatim text
10
+ .ft CW
11
+ .nf
12
+ .ne \\$1
13
+ ..
14
+ .de Ve \" End verbatim text
15
+ .ft R
16
+ .fi
17
+ ..
18
+ .\" Set up some character translations and predefined strings. \*(-- will
19
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20
+ .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21
+ .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22
+ .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23
+ .\" nothing in troff, for use with C<>.
24
+ .tr \(*W-
25
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26
+ .ie n \{\
27
+ . ds -- \(*W-
28
+ . ds PI pi
29
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31
+ . ds L" ""
32
+ . ds R" ""
33
+ . ds C` ""
34
+ . ds C' ""
35
+ 'br\}
36
+ .el\{\
37
+ . ds -- \|\(em\|
38
+ . ds PI \(*p
39
+ . ds L" ``
40
+ . ds R" ''
41
+ 'br\}
42
+ .\"
43
+ .\" Escape single quotes in literal strings from groff's Unicode transform.
44
+ .ie \n(.g .ds Aq \(aq
45
+ .el .ds Aq '
46
+ .\"
47
+ .\" If the F register is turned on, we'll generate index entries on stderr for
48
+ .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49
+ .\" entries marked with X<> in POD. Of course, you'll have to process the
50
+ .\" output yourself in some meaningful fashion.
51
+ .ie \nF \{\
52
+ . de IX
53
+ . tm Index:\\$1\t\\n%\t"\\$2"
54
+ ..
55
+ . nr % 0
56
+ . rr F
57
+ .\}
58
+ .el \{\
59
+ . de IX
60
+ ..
61
+ .\}
62
+ .\"
63
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
65
+ . \" fudge factors for nroff and troff
66
+ .if n \{\
67
+ . ds #H 0
68
+ . ds #V .8m
69
+ . ds #F .3m
70
+ . ds #[ \f1
71
+ . ds #] \fP
72
+ .\}
73
+ .if t \{\
74
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75
+ . ds #V .6m
76
+ . ds #F 0
77
+ . ds #[ \&
78
+ . ds #] \&
79
+ .\}
80
+ . \" simple accents for nroff and troff
81
+ .if n \{\
82
+ . ds ' \&
83
+ . ds ` \&
84
+ . ds ^ \&
85
+ . ds , \&
86
+ . ds ~ ~
87
+ . ds /
88
+ .\}
89
+ .if t \{\
90
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96
+ .\}
97
+ . \" troff and (daisy-wheel) nroff accents
98
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105
+ .ds ae a\h'-(\w'a'u*4/10)'e
106
+ .ds Ae A\h'-(\w'A'u*4/10)'E
107
+ . \" corrections for vroff
108
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110
+ . \" for low resolution devices (crt and lpr)
111
+ .if \n(.H>23 .if \n(.V>19 \
112
+ \{\
113
+ . ds : e
114
+ . ds 8 ss
115
+ . ds o a
116
+ . ds d- d\h'-1'\(ga
117
+ . ds D- D\h'-1'\(hy
118
+ . ds th \o'bp'
119
+ . ds Th \o'LP'
120
+ . ds ae ae
121
+ . ds Ae AE
122
+ .\}
123
+ .rm #[ #] #H #V #F C
124
+ .\" ========================================================================
125
+ .\"
126
+ .IX Title "..::docs::memcached_get 3"
127
+ .TH ..::docs::memcached_get 3 "2012-10-24" "" "libmemcached"
128
+ .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129
+ .\" way too many mistakes in technical documents.
130
+ .if n .ad l
131
+ .nh
132
+ .SH "NAME"
133
+ memcached_get, memcached_get_len, memcached_mget, memcached_mget_len, memcached_fetch \- Get a value
134
+ .SH "LIBRARY"
135
+ .IX Header "LIBRARY"
136
+ C Client Library for memcached (libmemcached, \-lmemcached)
137
+ .SH "SYNOPSIS"
138
+ .IX Header "SYNOPSIS"
139
+ .Vb 1
140
+ \& #include <memcached.h>
141
+ \&
142
+ \& memcached_result_st *
143
+ \& memcached_fetch_result(memcached_st *ptr,
144
+ \& memcached_result_st *result,
145
+ \& memcached_return *error);
146
+ \&
147
+ \& char *memcached_get(memcached_st *ptr,
148
+ \& const char *key, size_t key_length,
149
+ \& size_t *value_length,
150
+ \& uint32_t *flags,
151
+ \& memcached_return *error);
152
+ \&
153
+ \& memcached_return
154
+ \& memcached_mget(memcached_st *ptr,
155
+ \& char **keys, size_t *key_length,
156
+ \& size_t number_of_keys);
157
+ \& char *
158
+ \& memcached_get_by_key(memcached_st *ptr,
159
+ \& const char *master_key, size_t master_key_length,
160
+ \& const char *key, size_t key_length,
161
+ \& uint32_t user_spec_len,
162
+ \& size_t *value_length,
163
+ \& uint32_t *flags,
164
+ \& memcached_return *error);
165
+ \&
166
+ \& memcached_return
167
+ \& memcached_mget_by_key(memcached_st *ptr,
168
+ \& const char *master_key, size_t master_key_length,
169
+ \& char **keys, size_t *key_length,
170
+ \& size_t number_of_keys,
171
+ \& uint32_t user_spec_len);
172
+ \&
173
+ \& char *memcached_fetch(memcached_st *ptr,
174
+ \& char *key, size_t *key_length,
175
+ \& size_t *value_length,
176
+ \& uint32_t *flags,
177
+ \& memcached_return *error);
178
+ \& memcached_return
179
+ \& memcached_fetch_execute(memcached_st *ptr,
180
+ \& memcached_return (*callback[])(memcached_st *ptr, memcached_result_st *result, void *context),
181
+ \& void *context,
182
+ \& unsigned int number_of_callbacks);
183
+ \&
184
+ \& char *
185
+ \& memcached_get_len(memcached_st *ptr,
186
+ \& const char *key, size_t key_length,
187
+ \& uint32_t user_spec_len,
188
+ \& size_t *value_length,
189
+ \& uint32_t *flags,
190
+ \& memcached_return *error);
191
+ \&
192
+ \& memcached_return
193
+ \& memcached_mget_len(memcached_st *ptr,
194
+ \& const char **keys, size_t *key_length,
195
+ \& size_t number_of_keys, uint32_t user_spec_len);
196
+ .Ve
197
+ .SH "DESCRIPTION"
198
+ .IX Header "DESCRIPTION"
199
+ \&\fImemcached_get()\fR is used to fetch an individual value from the server. You
200
+ must pass in a key and its length to fetch the object. You must supply
201
+ three pointer variables which will give you the state of the returned
202
+ object. A uint32_t pointer to contain whatever flags you stored with the value,
203
+ a size_t pointer which will be filled with size of of the object, and a
204
+ memcached_return pointer to hold any error. The object will be returned
205
+ upon success and \s-1NULL\s0 will be returned on failure. Any object returned by
206
+ \&\fImemcached_get()\fR must be released by the caller application.
207
+ .PP
208
+ \&\fImemcached_get_len()\fR is also used to fetch an individual value from the
209
+ server. The only difference when compared to \fImemcached_get()\fR is that
210
+ the server will only send back the first n bytes of the value where n is
211
+ specified by the user. Note that this command is only available when
212
+ using the ascii protocol.
213
+ .PP
214
+ \&\fImemcached_mget()\fR is used to select multiple keys at once. For multiple key
215
+ operations it is always faster to use this function. This function always
216
+ works asynchronously. \fImemcached_fetch()\fR is then used to retrieve any keys
217
+ found. No error is given on keys that are not found. You must call either
218
+ \&\fImemcached_fetch()\fR or \fImemcached_fetch_result()\fR after a successful call to
219
+ \&\fImemcached_mget()\fR. You should continue to call these functions until they
220
+ return \s-1NULL\s0 (aka no more values). If you need to quit in the middle of a
221
+ \&\fImemcached_get()\fR call, execute a \fImemcached_quit()\fR. After you do this, you can
222
+ issue new queries against the server.
223
+ .PP
224
+ \&\fImemcached_mget_len()\fR is also used to select multiple keys at once. The
225
+ only difference when compared to \fImemcached_mget()\fR is that the server
226
+ will only send back the first n bytes of each value where n is
227
+ specified by the user. Note that this command is only available when
228
+ using the ascii protocol.
229
+ .PP
230
+ \&\fImemcached_fetch()\fR is used to fetch an individual value from the server.
231
+ \&\fImemcached_mget()\fR or \fImemcached_mget_len()\fR must always be called before
232
+ using this method. You must pass in a key and its length to fetch the
233
+ object. You must supply three pointer variables which will give you the
234
+ state of the returned object. A uint32_t pointer to contain whatever
235
+ flags you stored with the value, a size_t pointer which will be filled
236
+ with size of of the object, and a memcached_return pointer to hold any
237
+ error. The object will be returned upon success and \s-1NULL\s0 will be returned
238
+ on failure. \s-1MEMCACHD_END\s0 is returned by the *error value when all objects
239
+ that have been found are returned. The final value upon \s-1MEMCACHED_END\s0 is
240
+ null. Values returned by \fImemcached_fetch()\fR musted be free'ed by the caller.
241
+ .PP
242
+ \&\fImemcached_fetch_result()\fR is used to return a \fImemcached_result_st\fR\|(3) structure
243
+ from a memcached server. The result object is forward compatible with changes
244
+ to the server. For more information please refer to the \fImemcached_result_st\fR\|(3)
245
+ help. This function will dynamically allocate a result structure for you
246
+ if you do not pass one to the function.
247
+ .PP
248
+ \&\fImemcached_fetch_execute()\fR is a callback function for result sets. Instead
249
+ of returning the results to you for processing, it passes each of the
250
+ result sets to the list of functions you provide. It passes to the function
251
+ a memcached_st that can be cloned for use in the called function (it can not
252
+ be used directly). It also passes a result set which does not need to be freed.
253
+ Finally it passes a \*(L"context\*(R". This is just a pointer to a memory reference
254
+ you supply the calling function. Currently only one value is being passed
255
+ to each function call. In the future there will be an option to allow this
256
+ to be an array.
257
+ .PP
258
+ \&\fImemcached_get_by_key()\fR and \fImemcached_mget_by_key()\fR behave in a similar nature
259
+ as \fImemcached_get()\fR and \fImemcached_mget()\fR. The difference is that they take
260
+ a master key that is used for determining which server an object was stored
261
+ if key partitioning was used for storage.
262
+ .PP
263
+ All of the above functions are not supported when the \f(CW\*(C`MEMCACHED_BEHAVIOR_USE_UDP\*(C'\fR
264
+ has been set. Executing any of these functions with this behavior on will result in
265
+ \&\f(CW\*(C`MEMCACHED_NOT_SUPPORTED\*(C'\fR being returned or, for those functions which do not return
266
+ a \f(CW\*(C`memcached_return\*(C'\fR, the error function parameter will be set to
267
+ \&\f(CW\*(C`MEMCACHED_NOT_SUPPORTED\*(C'\fR.
268
+ .SH "RETURN"
269
+ .IX Header "RETURN"
270
+ All objects returned must be freed by the calling application.
271
+ \&\fImemcached_get()\fR, \fImemcached_get_len()\fR, and \fImemcached_fetch()\fR will return
272
+ \&\s-1NULL\s0 on error. You must look at the value of error to determine what
273
+ the actual error was.
274
+ .SH "HOME"
275
+ .IX Header "HOME"
276
+ To find out more information please check:
277
+ <http://tangent.org/552/libmemcached.html>
278
+ .SH "AUTHOR"
279
+ .IX Header "AUTHOR"
280
+ Brian Aker, <brian@tangent.org>
281
+ .SH "SEE ALSO"
282
+ .IX Header "SEE ALSO"
283
+ \&\fImemcached\fR\|(1) \fIlibmemcached\fR\|(3) \fImemcached_strerror\fR\|(3)