X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Flibmemcached_configuration.rst;h=2f3da9d44b991ae3e5a4035afd7776940bbf9815;hb=6ae03b4b29148dd9295e0eca7e84004b073a9ec0;hp=05b2af8ea0df0773c08407679f4c9b5f755bccfc;hpb=6e9731947eace4be83d553a242a44b36b3adcf22;p=m6w6%2Flibmemcached diff --git a/docs/libmemcached_configuration.rst b/docs/libmemcached_configuration.rst index 05b2af8e..2f3da9d4 100644 --- a/docs/libmemcached_configuration.rst +++ b/docs/libmemcached_configuration.rst @@ -2,32 +2,39 @@ Configuring Libmemcached ======================== +.. highlightlang:: c + -------- SYNOPSIS -------- +#include -.. c:function:: memcached_st *memcached_create_with_options(const char *string, size_t string_length) +.. envvar:: LIBMEMCACHED +.. c:function:: memcached_st *memcached(const char *string, size_t string_length) .. c:function:: memcached_return_t libmemcached_check_configuration(const char *option_string, size_t length, char *error_buffer, size_t error_buffer_size) Compile and link with -lmemcached - ----------- DESCRIPTION ----------- Libmemcached implements a custom language for configuring and modifying -servers. By passing in an option string you can generate a memcached_st object +servers. By passing in an option string you can generate a ``memcached_st`` object that you can use in your application directly. .. describe:: --SERVER=:/? Provide a servername to be used by the client. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. +.. describe:: --SOCKET=\"/?\" + +Provide a filepath to a UNIX socket file. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. + .. describe:: --VERIFY-KEY Verify that keys that are being used fit within the design of the protocol being used. @@ -184,7 +191,7 @@ RETURN ------ -memcached_create_with_options() returns a pointer to the memcached_st that was +:c:func:`memcached()` returns a pointer to the memcached_st that was created (or initialized). On an allocation failure, it returns NULL. @@ -197,7 +204,7 @@ EXAMPLE .. code-block:: c const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com" - memcached_st *memc= memcached_create_with_options(config_string, strlen(config_string); + memcached_st *memc= memcached(config_string, strlen(config_string); { ... } @@ -211,7 +218,7 @@ HOME To find out more information please check: -`https://launchpad.net/libmemcached `_ +`http://libmemcached.org/ `_