X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Flibmemcached_configuration.rst;h=e0f51b12f432665801912fc7c93bb42d9dd14f0f;hb=d42f4de9a5967b6c98a1fabf7e32ab23f331cf98;hp=74902aab7663d987a00aa95d6fdf4e05b3c1028b;hpb=a6c3e3a3d04f379b1480c8c88a8eae17e54b1449;p=awesomized%2Flibmemcached diff --git a/docs/libmemcached_configuration.rst b/docs/libmemcached_configuration.rst index 74902aab..e0f51b12 100644 --- a/docs/libmemcached_configuration.rst +++ b/docs/libmemcached_configuration.rst @@ -2,13 +2,15 @@ Configuring Libmemcached ======================== -.. index:: object: memcached_st +.. highlightlang:: c -------- SYNOPSIS -------- -#include +#include + +.. envvar:: LIBMEMCACHED .. c:function:: memcached_st *memcached(const char *string, size_t string_length) @@ -17,26 +19,29 @@ SYNOPSIS 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. .. describe:: --REMOVE_FAILED_SERVERS -Enable the behavior MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. +Enable the behavior :c:type:`MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS`. .. describe:: --BINARY-PROTOCOL @@ -44,7 +49,7 @@ Force all connections to use the binary protocol. .. describe:: --BUFFER-REQUESTS -Enable MEMCACHED_BEHAVIOR_BUFFER_REQUESTS. +Please see :c:type:`MEMCACHED_BEHAVIOR_BUFFER_REQUESTS`. .. describe:: --CONFIGURE-FILE= @@ -52,7 +57,7 @@ Provide a configuration file to be used to load requests. Beware that by using a .. describe:: --CONNECT-TIMEOUT= -Enable MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT. +Please see :c:type:`MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT`. .. describe:: --DISTRIBUTION= @@ -86,11 +91,11 @@ When adding new servers always calculate their distribution based on sorted nami .. describe:: --SUPPORT-CAS -See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SUPPORT_CAS +See :manpage:`memcached_behavior_set(3)` for :c:type:`MEMCACHED_BEHAVIOR_SUPPORT_CAS` .. describe:: --USE-UDP -See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_USE_UDP +See :manpage:`memcached_behavior_set(3)` for :c:type:`MEMCACHED_BEHAVIOR_USE_UDP` .. describe:: --NAMESPACE= @@ -186,7 +191,7 @@ RETURN ------ -memcached() 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.