5 This is not a feature, but a bug fix release. The minor version number
6 has been incremented due to the following changes:
8 * Ported build system to CMake.
9 * Ported tests to Catch2.
10 * Build requires C++11 compiler support.
11 * Tests require C++17 compiler support.
12 * Moved the project from launchpad to github:
13 * Source: https://github.com/m6w6/libmemcached
14 * Documentation: https://m6w6.github.io/libmemcached
15 * Continuous Integration:
16 * Github: https://github.com/m6w6/libmemcached/actions (Linux, MacOS **·** amd64)
17 * Travis: https://travis-ci.org/m6w6/libmemcached (Linux **·** arm64, ppc64le, s390x)
18 * Cirrus: https://cirrus-ci.com/m6w6/libmemcached (FreeBSD **·** amd64)
22 * Fix build failure due to comparison of incompatible types in bin/memflush and bin/memstat.
23 * Fix wrong type of memcached_instance_st::server_timeout_counter_query_id from uint32_t to uint64_t.
24 * Fix memcached_dump(): returned MEMCACHED_CLIENT_ERROR on request to dump illegal slab id.
25 * Fix bin/memcapable: failed with "No hostname was provided" when providing a hostname.
26 * Fix hashkit/murmur and hashkit/murur3: undefined behavior on platforms requiring aligned access.
27 * Fix Memcache::set(): possible subscription of empty vector.
28 * Fix libmemcached_util_version_check().
29 * Fix ketama/consistent hashing: crash on reallocation of continuum.
30 * Fix gh #90: Build fails on Darwin.
31 * Fix gh #83: memcp waits forever if file no found.
32 * Fix gh #80: memparse docs.
33 * Fix gh #72 and gh #47: memcached_return_t docs.
34 * Fix gh #62: uint32_t overflow cause busy loop.
35 * Removed restriction of UDP+IPv6.
36 * Fix SERVER_ERROR_MEMORY_ALLOCATION_FAILURE: recognize more strings returned by the server.
37 * Fix gh #13: reset continuum counter after freeing them.
38 * Fix gh #14 and gh #17: SASL: AUTH_CONTINUE was considered a failure and caused IO reset.
39 * Fix gh #25: hashkit/murmur3 unavailable.
40 * Fix missing handling of EAGAIN for non-blocking unix domain socket.
41 * Fix gh #35: handling of BEHAVIOR_REMOVE_FAILED_SERVERS.
42 * Fix gh #41: ensure stable sort on continuum host key collision.
43 * Fix gh #42: MEMCACHED_MAX_BUFFER docs.
44 * Fix gh #43: libmemcached_configuration docs.
45 * Fix gh #46: clarification on millisecond timeout docs.
46 * Fix gh #50: memcached_fetch_result() can return previously returned data.
47 * Fix gh #53: stack overflow in memcached_fetch_result().
48 * Fix gh #57: include <inttypes.h> vs <cinttypes>
49 * Fix gh #58: more specific error messages when connect() fails.
50 * Fix gh #59: bin/memcat: typo in "No servers provied".
51 * Fix gh #77: undeclared UINT64_C in ketama.cc.
52 * Fix gh #12: never reconnects after connection reset (binary protocol).
53 * Fix gh #49: assertion memcached_failed(rc) failed in memcached_send_ascii().
54 * Fix gh #67: get returns NOTFOUND on timeout.
55 * Fix gh #76: memcached_touch() crashes when expiration=-1 (ASCII only).
56 * Fix gh #23: build fails with bison 2.3.
57 * Fix memaslap: build fails with newer compiler versions.
58 * Fix usage of strerror_r() implementations returning pointer to char.
59 * Fix pipelining commands with memcached >= 1.6.
60 * Fixed memcached_stat_get_value(): buffer overflow.
61 * Fix memcached_stat(): undefined behavior due to unintialized memcached_return_t.
62 * Fix SASL tests: requires SASL_PWDB_CONF.
63 * Fix bin/memaslap to idnentify itself as memaslap instead of memslap.
64 * Fix bin/memcapable to work with memcached >= 1.6.
65 * Fix murmur and murmur3 hashes on big endian platforms.
72 * MEMCACHED_BEHAVIOR_RETRY_TIMEOUT can now be set to zero.
78 * Remove c++ namespace that was being exposed (the API should be plug compatible)..
79 * Fix cases where --servers wasn't behaving the same in all clients.
84 * Added support to do two part shutdown of socket.
85 * Fixes for Fedora 18.
86 * Fix for binary memcached_touch()
91 * Added support for Murmur3 (HASHKIT_HASH_MURMUR3)
97 * CLIENT_ERROR fixed to not be treated as a fatal error.
98 * Compiler fixes for older Ubuntu releases.
101 > released 2012-10-19
103 * Fix bug that caused version string to not be exported correctly.
106 > released 2012-10-09
108 * Added memcached_result_take_value().
109 * Added ax_libmemcached.m4
112 > released 2012-09-17
114 * Removed custom version of memcached.
115 * Updated hardening rules.
116 * Fixed a case where the return error from a socket connection differred from that of a TCP/IP socket.
119 > released 2012-07-30
121 * --disable-assert has been removed from configure, and --enable-assert has been added in its place.
122 * Compiling fixes for Clang on OSX Mountain Lion.
125 > released 2012-07-05
127 * Faster close on socket.
128 * Instance allocation is now seperated from server interface.
129 This should allow for a better preservation of ABI compliance from now on.
130 * Fix close on exec bug.
131 * Numerous other bug fixes.
134 > released 2012-05-22
136 * Added support for setting options via ENV variable LIBMEMCACHED
137 * Fix corner case on last used result.
140 > released 2012-04-28
142 * Add API call for exist calls.
143 * Update all license files to be BSD.
146 > released 2012-04-08
148 * Fixes for gcc 4.7, lp:961812
149 * Fix for restart issue that happens under testing.
151 * Support for transparent AES encryption.
154 > released 2012-03-14
157 * Version is now parsed directly in the parser, which makes buffered operations now work with it..
158 * memstat has been extended so that it can be used to find the version of the server.
159 * Update documentation.
160 * Fixes for compile issues on Debian and Ubuntu
163 > released 2012-01-27
165 * Fix for memcached_dump().
166 * Additional testing for memcached_stat_execute().
169 > released 2012-01-09
171 * Increased size of sort buffer used during Ketama.
172 * Added support for new behavior to handle dead servers.
173 * Overall haul of UDP IO.
174 * Fixed C compile issue with memcached_exist()
175 * Numerous bug fixes.
176 * Clang support for OSX.
177 * All commands now using vector send support.
180 > released 2011-10-24
182 * Dropped libmemcached/memcached_util.h (undocumented header file)
183 * Added memcached_touch() and memcached_touch_by_key()
184 * UDP support restructured to toggle on a complete memcached_st structure.
187 > released 2011-09-27
189 * Fix for FreeBSD/OpenBSD and -lm
190 * Added memcached_exist()
191 * Fix for memory when using config test.
195 > released 2011-09-12
197 * Build fixes for Ubuntu/Suse.
198 * Fixes for OSX Lion.
199 * Bug fix for looping back through dns lookups under certain failures.
200 * Fixes related to dead server failures.
203 > released 2011-07-21
205 * memcached_callback_set() now takes its data argument as const
207 * Fix in parser for port number.
210 > released 2011-06-20
212 * Updates to C++ interface
213 * Custom free allocators need to now check for value before calling free.
214 * memcached_fetch_result() now uses the internal result when available (about 25 to 50% faster).
215 * Fix for stats structure.
216 * Updates to documentation.
217 * memcached_fetch_result() now uses the internal result when available (about 25 to 50% faster).
220 > released 2011-04-14
222 * Fix calls to auto methods so that if value is not passed in nothing bad happens.
223 * New parser calls for generating memcached_st objects.
225 * New flow control for messages means faster get/set calls.
226 * Added new documentation system.
227 * A behavior change has been now made that if you specify a weight for any server, we enable the weight flag and do weight balancing.
228 * Added MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS to simplify the setting of AUTO REJECT for servers.
231 > released 2011-03-16
233 * Fix memory leak in server parse.
234 * Move test framework out to be its own library (easier to work with Gearman).
238 > released 2011-02-24
240 * Additional fixes for OpenBSD.
241 * Bug fix 677609, 456080.
242 * SIGPIPE fix for Linux send().
243 * memcapable can now test ascii or binary based on flags.
244 * Additional build fixes for SASL.
248 > released 2011-02-14
250 * Fixes a number of corner case bugs.
251 * Fixes related to OpenBSD.
252 * Better testing for protocol version.
253 * Removes special case infinite wait on blocking setup.
256 > released 2011-02-09
258 * Add support for systemtap
261 > released 2010-09-23
264 * Hudson port support in test harness.
265 * Improved portability of test hanrness.
269 > released 2010-07-28
271 * Added --args to memstat so that a greater range of values can be returned.
272 * Prelimanary support for Windows.
273 * memcached_stat_execute() merged.
276 > released 2010-07-06
278 * Mistake in libtool caused issue with library version
281 > released 2010-06-30
283 * Added --file for memcat.
284 * Added limemcached_ping() to libmemcached_util
285 * Bugfix for some cases where connect would have issues with timeout.
286 * Wrong value for errno given as error on an IO failure inside of poll.
287 * Bug fix for issue where multiple interfaces with bad DNS were not being caught.
290 > released 2010-04-23
292 * Placed retry logic in for busted resolvers
293 * Add an ignore for SIGPIPE to solve OSX issues.
294 * A couple of fixed for memcached_light server.
295 * Updated to debug mode to track io_wait
298 > released 2010-04-06
300 * Add support for prefix keys to binary protocol.
301 * Remove the undocumented call memcached_server_remove().
302 * The undocumented call memcached_server_by_key() now returns const.
303 * memcached_server_error_reset() has been deprecated.
304 * memcached_server_list() has been deprecated. Use memcached_server_cursor() to walk the servers found in a memcached_st() structure.
305 * memcached_verbosity() can now be run concurrently with other operations.
307 * Fixes memory leak found in EJECT HOSTS.
310 > released 2010-02-10
312 * C++ interface for libhashkit.
313 * Modified memcached_set_memory_allocators() so that it requires a context pointer.
314 * memcached_clone() now runs 5 times faster.
315 * Functions used for callbacks are now given const memcached_st.
316 * Added MEMCACHED_BEHAVIOR_CORK.
317 * memslap now creates a configuration file at ~/.memslap.cnf
318 * memcached_purge() now calls any callbacks registered during get execution.
319 * Many fixes to memslap.
320 * Updates for memcapable.
321 * Compile fixes for OpenBSD.
322 * Fix for possible recursive decent on IO failure.
325 > released 2010-01-12
327 * Fixed build for libhashkit.
328 * Fixed install path regression.
329 * Modified RPM to strict check install.
330 * Added documentation for memcached_server_cursor();
331 * Added memcached_servers_reset().
332 * Modified memcached_st to remove dead cursor_server member.
335 > released 2010-01-07
337 * Merged in new memslap utility.
338 * All of constants.h has been updated to match style (all old identifiers continue to work).
339 * Added first pass for libhashkit.
340 * Updated test Framework/extended tests.
341 * Random read support during replication added.
342 * Modified use_sort so that the option can be applied to any distribution type.
343 * We removed the MEMCACHED_BEHAVIOR_KETAMA_COMPAT_MODE added in 0.35. Instead use memcached_behavior_set_distribution().
346 > released 2009-11-09
348 * Added support for by_key operations for inc/dec methods.
349 * Added mget test to memslap.
350 * Support for compatible ketama for SpyMemcached
351 * Update C++ interface.
355 > released 2009-10-13
357 * Added support for setting behavior flags on a connection pool.
358 * Don't increment server_failure_counter on normal disconnects.
359 * Added prototype for a callback based protocol parser (server side) with examples so that you could let your own application speak the memcached protocol
360 * Updated memcapable to test ASCII protocol.
361 * Changed behavior so that server can be removed at first sign of failure.
362 * Added memcached_server_get_last_disconnect() call
365 > released 2009-09-23
367 * Added memcapable to test servers for binary compatibility.
368 * Updated C++ interface. Added basic support for C++ exceptions. Added multiple constructors the memcached client object. The C++ interface now takes parameters which are C++ types (such as std::string).
369 * Several bug fixes for binary protocol support.
370 * Fixed crashing issue with dumping from memcachd server (server internals were changed without documenting change).
373 > released 2009-09-15
375 * Change of behavior where linger is only modified for no-block and then it is set to zero.
376 * Added Twitter's memcached_server_error() functions.
377 * Fix for OSX compiles in development builds.
378 * Updated C++ interface.
379 * Updated memcached_mget and memcached_mget_by_key to take a size_t as a parameter instead of an unsigned int for number_of_keys.
382 > released 2009-07-10
384 * Added support or HA via replication.
385 * malloc() removed for server key usage.
386 * Update build system.
387 * Added support for memcached_set_memory_allocators().
388 * Fixed bug in configure.ac for have_htoll.
391 > released 2009-06-01
393 * Added memcachd_dump command (and framework for memdump tool).
394 * Realigned all structures to remove padding (and line up important bits for 64bit caches.
395 * Remove some of sprintf() in storage calls().
396 * Removed printf() in stat call for unknown stat member.
397 * memcached_generate_hash() function added.
398 * Added tests to make sure all hash functions are stable.
401 > released 2009-05-19
403 * Fixed malloc usage to calloc for spots where we need zero filled memory.
404 * All code warnings now treated as errors.
405 * Fixes for debian packaging.
406 * Added new pooling mechanism.
407 * MEMCACHED_BEHAVIOR_NO_BLOCK no longer also sets MEMCACHED_BEHAVIOR_BUFFER_REQUESTS.
408 * Updated generic rpm.
411 > released 2009-04-15
413 * Fixed bug in init sructure (reapplied)
414 * Fixed bug in get/set by key (nikkhils@gmail.com)
417 > released 2009-03-30
419 * Added new UDP fire-forget mode.
420 * Reworked performance for mget() to better make use of async protocol
421 * Cleaned up execution of fetch (just one set of code now)
422 * Fixed Jenkin's for big endian hosts.
423 * Updates for memstat to determine network latency.
424 * Updates for binary protocol.
425 * Many updates to documentation.
428 > released 2009-01-29
430 * Fix for decrement on hash key
431 * Fixed assert that was catching bad memset() call in host_reset()
432 * Fix purge issue for blocked IO which has been stacked.
435 > released 2008-11-28
437 * Jenkins HASH added.
438 * Update of Murmur hash code
439 * Support explicit weights (Robey Pointer, Evan Weaver)
440 * Bugfix for ketama continuum (Robey Pointer)
441 * New behavior MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY (Robey Pointer)
442 * Don't ever call stats for weighting servers, because it is unstable.
445 > released 1970-01-01
447 * Cleanup compile warnings.
448 * Fix issues in partitioning by keys.
449 * Fixed "fail case" to make sure when calling memcached_clone() no memcached_st is over written.
450 * New memcached_server_by_key() method for finding a server from a key.
451 * memcached_server_free() was added for freeing server structures.
455 > released 2008-09-07
457 * Added strings.h header for Solaris 9
459 * Support for weighted Ketama from Yin Chen.
461 * Fix for 0 length key to trigger bad key.
462 * Added behaviors MEMCACHED_BEHAVIOR_SND_TIMEOUT, MEMCACHED_BEHAVIOR_RCV_TIMEOUT
463 * Support for Binary Protocol added
466 > released 2008-07-14
468 * Fix where master key was no being checked for "bad key"
469 * Fixed bugs in stats output (thread output was wrong)
470 * Clarified MEMCACHED_BAD_KEY_PROVIDED is return for bad prefix key.
471 * Found a bug in Flags return (Jacek Ostrowski)
472 * Fixed issue with compiling on Visual Studio
475 > released 2008-05-24
477 * Change of char * to const char * for all key based functions.
478 * New MEMCACHED_CALLBACK_PREFIX_KEY added. You can now create domains for values.
479 * Fixed bug introducd in last version on memcp
480 * Fix for death of file io to call shutdown()
483 > released 2008-05-05
485 * New consistent distribution tests.
486 * Found a memory leak when a server constantly fails.
487 * Fix in watchpoint macro
488 * Changed default timeout to 1 second for poll timeouts
489 * Wheel uses less memory/dynamic allocation for size (no longer limited to 512 hosts by default.
490 * memslap memory leak fix
491 * Added Ketama distribution
492 * Fix assert.h compile problem on CentOS
495 > released 2008-04-09
497 * Documentation fix in libmemcached.
498 * Fixed bug where sort was always occuring on hosts
499 * Logic fix in branch prediction (thanks Jay!)
500 * Read through cached support.
501 * Fixed for cas by key operation.
502 * Fix for memcached_server_st list structures to have correct count.
503 * Added callback MEMCACHED_CALLBACK_DELETE_TRIGGER
504 * Removed function call in favor of macro (aka cut out some instructions)
508 > released 2008-03-17
510 * Fix plus tests for non-zero value objects and flags.
511 * MEMCACHED_HASH_MURMUR added for murmur algorithm provided.
512 * MEMCACHED_BEHAVIOR_RETRY_TIMEOUT added to keep connecting from looping on timeout.
513 * gcc branch prediction optimizations
514 * Refactored entire tree to make include files cleaner
515 * Fixed leaked socket.
518 > released 2008-02-27
520 * MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT added for connect timeout in non-block mode.
521 * Incompatible change in memcached_behavior_set() api. We now use a uint64_t, instead of a pointer.
522 * Fix for storage of values for zero.
523 * memcached_server_cursor() function added to API for cycling through servers.
526 > released 2008-02-18
528 * Work on the UDP protocol
529 * Added get_by_key, set_by_key tests for C++ API
530 * Fix for limit_maxbytes to be 64bit in stats
531 * Added Atom Smasher test (scale baby, scale!)
532 * Servers are now sorted, meaning that servers are now ordered so that clients with the same lists, will have same distribution. (Idea from Ross McFarland). MEMCACHED_BEHAVIOR_SORT_HOSTS was added to enable this support.
533 * Added MEMCACHED_BAD_KEY_PROVIDED error for auto, set, and get operations. MEMCACHED_BEHAVIOR_VERIFY_KEY was added to enable this feature.
534 * More error messages on command line tools.
535 * Fixed bugs in memcached_cas() operator.
536 * Fix to loop through interfaces
539 > released 2008-01-29
541 * More work on the C++ API.
542 * Bug fixes around block corner cases.
543 * Slight performance increase in both read() and write().
546 > released 2008-01-22
548 * For for bug found by Evan Weaver where increment() was not returning propper error of value was not found.
549 * Fix for bad null pointer on flag by Toru Maesaka.
550 * Refactor of all IO to just pass in the active server
551 * Problem configuring (PKG_CHECK_MODULES) fixed by removal of "rpath" in support/libmemcached.pc.in (Thanks to Ross McFarland).
552 * Added memcached_callback_get()/set()
553 * First prototype of C++ interface
554 * Updated docs for uint16_t changes in previous release
557 > released 2008-01-13
559 * MEMCACHED_BEHAVIOR_USER_DATA added to store user pointer.
560 * Fix for failure to connect to invalidate socket.
561 * Patch from Marc Rossi to add --hash option for memcp, memrm, and memcat.
562 * Kevin's patch for fixing EOF issues during a read.
563 * Toru Maesaka patch for stats mismatch
564 * Fix for when CRC return 0
565 * Fixed uint16_t issues around flags. Turns out the documentation on the protocol was wrong.
566 * Lingering socket fixes for FreeBSD.
567 * Patches from Kevin Dalley for FreeBSD 4.0
568 * Added multi delete functions.
569 * All get key returns have C style null termination
570 * If memcached_server_list_append is passed NULLs instead of pointers it returns NULL.
571 * Added memcached_fetch_execute() method
572 * Found a bug where memcached_fetch() was not null terminating the result value.
573 * memcached_behavior() now has the ability to set "buffering" so that data is not automatically flushed.
574 * Behavior change, buffered commands now return MEMCACHED_BUFFERED
577 > released 2007-12-11
579 * Updates for consistent hashing
581 * Static allocation for hostname (performance)
582 * Fixed bug where in non-block mode all data might not have been sent on close().
583 * Refactor of memcached_get() to use common code.
584 * Change in value fetch, MEMCACHED_END is now returned when keys are no longer in the pipe.
585 * Fixed bug where key could be out of range of characters
586 * Added _by_key() methods to allow partitioning of values to particular servers.
587 * MEMCACHED_DEFAILT_TIMEOUT is now set to a non -1 value.
588 * Performance improvements in get operations.
591 > released 2007-11-26
593 * Added option to memcache_behavior_set() so that poll() can be timed out.
594 * Fixed memory leak in case of using memcached_fetch_result() where no value was returned.
595 * Bug fixed in memcached_connect() which would cause servers that did not need to be enabled to be enabled (performance issue).
596 * Rewrote bounds checking code for get calls.
597 * "make test" now starts its own memcached servers.
598 * Added Hseih hash (MEMCACHED_HASH_HSIEH), which is showing about 7% performance over standard hash.
601 > released 2007-11-21
603 * Added append binary test.
604 * Added MEMCACHED_BEHAVIOR_CACHE_LOOKUPS behavior so that you can save on multiple DNS lookups.
605 * Added CAS support, though this is optional and must be enabled during runtime.
606 * Added the utility memerror to create human readable error strings from memcached errors (aka convert ints to strings)
607 * Fixed type in MEMCACHED_HOST_LOOKUP_FAILURE
608 * Fixed bug where hostname might not be null terminated
609 * Moved to using gethostbyname_r() on Linux to solve thread safety issue
610 * Added -rpath support for pkg-config
611 * Documentation fix for hash setting using memcached_behavior_set()
614 > released 2007-11-15
616 * fix for when no servers are definied.
617 * different buffers are now kept for different connections to speed up async efforts
618 * Modified increment/decrement functions to return uint64_t values
619 * Fixed bug in cases where zero length keys were provided
620 * Thread cleanup issue in memslap
621 * No hostname lookup on reconnect
622 * Fix for flag settings (was doing hex by accident!)
623 * Support for 1.2.4 server additions "prepend" and "append" added.
624 * Added memcached_version()... not sure if I will make this public or not.
627 > released 2007-11-05
629 * Adding support for CRC hash method
630 * Adding support for UNIX sockets
631 * Added additional HASHing methods of FNV1_64,FNV1A_64, FNV1_32, FNV1A_32
632 * Added pkgconfig support (PKG_CHECK_MODULES)
633 * Fixed conflict with defined type in MySQL
634 * Added memcached_result_st structure and functions to manipulate it.
637 > released 2007-10-30
639 * Poved to poll() from select()
640 * Fixes in internal string class for allocation of large numbers of strings.
641 * memcached_mget() function now sends keys as it parses them instead of building strings as it goes.
642 * Propper flush now for making sure we get all IO sent even when in non-block mode.
643 * Added --enable-debug rule for configure
644 * All asserts() removed (hey this is going into production!)
648 > released 2007-10-17
650 * get value returns are now null terminated (request by Cal Heldenbrand)
651 * Fixed connections for more hosts then two.
652 * Rewrite of the read/write IO systems to handle different sorts of host failures.
653 * Added man pages for all functions and tools
654 * Raised buffer size for readinng/writing to 16K
655 * You can now optionally set the socket size for recv/send via memached_behavior_set/get.
658 > released 2007-10-09
660 * Ruby maintainer mentioned TCP_NODELAY patch he had added. Added this to C
661 library as well. (Eric Hodel drbrain@segment7.net)
662 * Added support script for set_benchmark
663 * Updated memslap to allow testing of TCP_NODELAY
664 * Updated memslap to support --flush (aka dump memcache servers before testing)
665 * Fixed bug in multiple hosts not being activated
666 * Added environmental variable MEMCACHED_SERVERS which can be used to set the servers list.
667 * fixed memcached_stat method (and now memstat works)
668 * server connect now happens on demand.
669 * Help for all command line applications
672 > released 2007-10-03
674 * Added buffered IO to write calls for keys
675 * Added buffered IO for reads
676 * memstat was broken (bad if/else on connect)
677 * New non-blocking IO (not default yet). Mucho faster
678 * Refactor of test system.
679 * memslap crash solved
682 > released 2007-10-01
684 * Jeff Fisher <guppy@techmonkeys.org> provided a spec file
685 * Added "make rpm" around dist file
686 * Added support for Solaris
687 * Added support for DTrace
688 * Fixed read to be recv and write to be send
689 * Bug fix where memstat would core if no server was found
690 * Added memslap tool (load generator)
691 * Numerous bug fixes in library
692 * Added calls to library for creating host lists (see text cases to understand how to use this).
695 > released 2007-09-27
697 * First public version