X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_sasl.rst;h=4dc4039c4f0aec375e754116b7cab5b8a1a36d1f;hb=a6c3e3a3d04f379b1480c8c88a8eae17e54b1449;hp=3e3b7789e79c92688f008214caadc97d1685f0ba;hpb=1edb76c1dfdf6307d010307b6f04bed3ce22e3a2;p=awesomized%2Flibmemcached diff --git a/docs/memcached_sasl.rst b/docs/memcached_sasl.rst index 3e3b7789..4dc4039c 100644 --- a/docs/memcached_sasl.rst +++ b/docs/memcached_sasl.rst @@ -1,46 +1,31 @@ -.. highlight:: perl - - -memcached_set_sasl_callbacks, memcached_get_sasl_callbacks, memcached_sasl_set_auth_data, memcached_destroy_sasl_auth_data -************************************************************************************************************************** - - +============ SASL support +============ - -******* -LIBRARY -******* +.. index:: object: memcached_st -C Client Library for memcached (libmemcached, -lmemcached) +-------- +SYNOPSIS +-------- +#include -******** -SYNOPSIS -******** +.. 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 memcached_set_sasl_auth_data(memcached_st *ptr, const char *username, const char *password) -.. code-block:: perl +.. c:function:: memcached_return memcached_destroy_sasl_auth_data(memcached_st *ptr) - #include - - void memcached_set_sasl_callbacks(memcached_st *ptr, - const sasl_callback_t *callbacks) - - const sasl_callback_t *memcached_get_sasl_callbacks(memcached_st *ptr) - - memcached_return memcached_set_sasl_auth_data(memcached_st *ptr, - const char *username, - const char *password) - memcached_return 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 @@ -49,7 +34,7 @@ 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. -memcached_set_sasl_auth_data() is a helper function for you defining +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 memcached_destroy_sasl_auth_data before calling memcached_free to avoid @@ -61,9 +46,9 @@ before enabling it in libmemcached, and you have to shut down libsasl by calling sasl_done() when you are done using SASL from libmemcached. -****** +------ RETURN -****** +------ memcached_get_sasl_callbacks() returns the callbacks currently used @@ -71,27 +56,28 @@ by this memcached handle. memcached_get_sasl_set_auth_data() returns MEMCACHED_SUCCESS upon success. -**** +---- HOME -**** +---- To find out more information please check: `http://libmemcached.org/ `_ -****** +------ AUTHOR -****** +------ +Brian Aker, + Trond Norbye, -******** +-------- SEE ALSO -******** - +-------- -memcached(1) libmemcached(3) +:manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`