From f2a59b728c20f7fe78874dd41187ab3fb2db6c7e Mon Sep 17 00:00:00 2001 From: Brian Aker Date: Sun, 16 Feb 2014 01:06:40 -0800 Subject: Fix for building docs. --- docs/source/memcached_sasl.rst | 80 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 docs/source/memcached_sasl.rst (limited to 'docs/source/memcached_sasl.rst') diff --git a/docs/source/memcached_sasl.rst b/docs/source/memcached_sasl.rst new file mode 100644 index 00000000..2a2e5699 --- /dev/null +++ b/docs/source/memcached_sasl.rst @@ -0,0 +1,80 @@ +============ +SASL support +============ + +.. index:: object: memcached_st + + +-------- +SYNOPSIS +-------- + +#include + +.. c:function:: void memcached_set_sasl_callbacks(memcached_st *ptr, const sasl_callback_t *callbacks) + +.. c:function:: const sasl_callback_t *memcached_get_sasl_callbacks(memcached_st *ptr) + +.. c:function:: memcached_return_t memcached_set_sasl_auth_data(memcached_st *ptr, const char *username, const char *password) + +.. c:function:: memcached_return_t memcached_destroy_sasl_auth_data(memcached_st *ptr) + +Compile and link with -lmemcached + + + +----------- +DESCRIPTION +----------- + + +libmemcached(3) allows you to plug in your own callbacks function used by +libsasl to perform SASL authentication. + +Please note that SASL requires the memcached binary protocol, and you have +to specify the callbacks before you connect to the server. + +:c:func:`memcached_set_sasl_auth_data` is a helper function defining +the basic functionality for you, but it will store the username and password +in memory. If you choose to use this method you have to call +:c:type:`memcached_destroy_sasl_auth_data` before calling +:c:type:`memcached_free` to avoid a memory leak. You should NOT call +:c:type:`memcached_destroy_sasl_auth_data` if you specify your own callback +function with :c:func:`memcached_set_sasl_callbacks`. + + +------ +RETURN +------ + + +:c:func:`memcached_get_sasl_callbacks` returns the callbacks currently used by +this memcached handle. :c:func:`memcached_set_sasl_auth_data` returns +:c:type:`MEMCACHED_SUCCESS` upon success. + + +---- +HOME +---- + + +To find out more information please check: +`http://libmemcached.org/ `_ + + +------ +AUTHOR +------ + + +Brian Aker, + +Trond Norbye, + + +-------- +SEE ALSO +-------- + + +:manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)` -- cgit v1.2.1