diff options
| author | Continuous Integration <ci@tangent.org> | 2014-02-16 03:31:37 -0800 |
|---|---|---|
| committer | Continuous Integration <ci@tangent.org> | 2014-02-16 03:31:37 -0800 |
| commit | b163cbc1e82ea834b66e3b4c1e8070394ccb506d (patch) | |
| tree | 999734df2e2c288d6726af31f9336beadb2a781a /docs/source/memcached_sasl.rst | |
| parent | 8541a9863cffad457f4d583af6a6c3613250193d (diff) | |
| parent | 37deb7fa75a0b3fbea4d58c032446213f0d5a02a (diff) | |
| download | libmemcached-trunk.tar.gz | |
Diffstat (limited to 'docs/source/memcached_sasl.rst')
| -rw-r--r-- | docs/source/memcached_sasl.rst | 80 |
1 files changed, 80 insertions, 0 deletions
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 <libmemcached/memcached_pool.h> + +.. 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/ <http://libmemcached.org/>`_ + + +------ +AUTHOR +------ + + +Brian Aker, <brian@tangent.org> + +Trond Norbye, <trond.norbye@gmail.com> + + +-------- +SEE ALSO +-------- + + +:manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)` |