ffontaine / libmemcached

Resurrection of libmemcached

libmemcached-awesome

libmemcached-awesome is an open source C/C++ client library and tools for the memcached server (http://memcached.org/). It has been designed to be light on memory usage, thread safe, and provide full access to server side methods.

NOTE:
This is a resurrection of the original work from Brian Aker at libmemcached.org.

Documentation

See https://awesomized.github.io/libmemcached

Building and updating docs

See gh-pages/publish script and the docs-publish-pages workflow, which automate pushing updated documentation to github pages.

Installing

libmemcached-awesome uses CMake. Please see/edit CMakeConfig.txt or use ccmake(1) or cmake-gui(1) to set any preferred options.

From source

git clone github.com:awesomized/libmemcached
mkdir build-libmemcached
cd $_
cmake ../libmemcached
make
sudo make install

Requirements

• CMake 3.9+
• C++11 compiler
• GNU Bison 2.3+ and Flex

Optional dependencies

• C++17 compiler (required for: tests)
• Intel's libtbb (optional for: tests; for GCC's stdlib parallelism support)
• pthreads (required for: tests, contrib/bin/memaslap, libmemcachedutil/pool)
• libevent (required for: contrib/bin/memaslap)
• Cyrus' libsasl2 (required for: libmemcached/sasl)

Binaries

CI and release builds for Linux, a couple BSDs, MacOS and Windows are available at https://artifacts.m6w6.name/libmemcached/ and rsync://m6w6.name::artifacts/libmemcached/.

Testing

Enable the BUILD_TESTING setting for a build and run make test.

cmake -DBUILD_TESTING=ON ../libmemcached
make test

Continuous integration

CI/Testing is performed on the following system matrix:

OS	Compiler	Arch	Comments
Linux	GNU 7/9/10, Clang 9/10/11/12	amd64	sasl, coverage, sanitizers
MacOS	AppleClang 12	amd64	sasl, coverage
FreeBSD	Clang 11	amd64	sasl, coverage
OpenBSD	Clang 10	amd64	sasl, coverage
Windows	MSVC 16, MinGW	amd64	no sasl, no tests
Solaris	SunPro 12.5	amd64	no sasl, no tests, manually

libmemcached-awesome has been tested against [memcached](https://github. com/memcached/memcached) v1.5 and v1.6.

ChangeLog

Check out the latest releases or the bundled ChangeLog for a comprehensive list of changes.

License

libmemcached-awesome is licensed under the 3-Clause-BSD license, which can be found in the accompanying LICENSE file.

Contributing

Please report any issues on the bug tracker.

A list of known permanent issues is maintained in BUGS.

All forms of contribution are welcome! Please see the bundled CONTRIBUTING note for the general principles followed.

The list of current and past maintainers and contributors is available in AUTHORS.