Update build files.
[m6w6/libmemcached] / docs / memcached_sasl.rst
index 1d1993bcc9597e6e551bfdf417809e407fa20132..4dc4039c4f0aec375e754116b7cab5b8a1a36d1f 100644 (file)
@@ -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 <libmemcached/memcached_pool.h>
 
-********
-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 <memcached.h>
-   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/ <http://libmemcached.org/>`_
 
 
-******
+------
 AUTHOR
-******
+------
 
 
+Brian Aker, <brian@tangent.org>
+
 Trond Norbye, <trond.norbye@gmail.com>
 
 
-********
+--------
 SEE ALSO
-********
-
+--------
 
-memcached(1) libmemcached(3)
 
+:manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`