SYNOPSIS
--------
-#include <libmemcached-1.0/memcached.h>
+.. describe:: #include <libmemcached-1.0/memcached.h>
-.. envvar:: LIBMEMCACHED
-
-.. c:function:: memcached_st *memcached(const char *string, size_t string_length)
+.. 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)
+.. 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
servers. By passing in an option string you can generate a ``memcached_st`` object
that you can use in your application directly.
-.. describe:: --SERVER=<servername>:<optional_port>/?<optional_weight>
+General Options:
+****************
+
+.. option:: --SERVER=<servername>:<optional_port>/?<optional_weight>
+
+Provide a servername to be used by the client.
-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.
+Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1.
-.. describe:: --SOCKET=\"<filepath>/?<optional_weight>\"
+.. option:: --SOCKET=\"<filepath>/?<optional_weight>\"
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
+.. option:: --VERIFY-KEY
Verify that keys that are being used fit within the design of the protocol being used.
-.. describe:: --REMOVE_FAILED_SERVERS
+.. option:: --REMOVE_FAILED_SERVERS
Enable the behavior :c:type:`MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS`.
-.. describe:: --BINARY-PROTOCOL
+.. option:: --BINARY-PROTOCOL
Force all connections to use the binary protocol.
-.. describe:: --BUFFER-REQUESTS
+.. option:: --BUFFER-REQUESTS
Please see :c:type:`MEMCACHED_BEHAVIOR_BUFFER_REQUESTS`.
-.. describe:: --CONFIGURE-FILE=
+.. option:: --CONFIGURE-FILE=
Provide a configuration file to be used to load requests. Beware that by using a configuration file libmemcached will reset memcached_st based on information only contained in the file.
-.. describe:: --CONNECT-TIMEOUT=
+.. option:: --CONNECT-TIMEOUT=
Please see :c:type:`MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT`.
-.. describe:: --DISTRIBUTION=
+.. option:: --DISTRIBUTION=
Set the distribution model used by the client. See :manpage:`memcached_behavior_set(3)` for more details.
-.. describe:: --HASH=
+.. option:: --HASH=
-Set the hashing alogrthm used for placing keys on servers.
+Set the hashing algorithm used for placing keys on servers.
-.. describe:: --HASH-WITH-NAMESPACE
+.. option:: --HASH-WITH-NAMESPACE
When enabled the prefix key will be added to the key when determining which
server to store the data in.
-.. describe:: --NOREPLY
+.. option:: --NOREPLY
Enable "no reply" for all calls that support this. It is highly recommended
that you use this option with the binary protocol only.
-.. describe:: --NUMBER-OF-REPLICAS=
+.. option:: --NUMBER-OF-REPLICAS=
-Set the nummber of servers that keys will be replicated to.
+Set the number of servers that keys will be replicated to.
-.. describe:: --RANDOMIZE-REPLICA-READ
+.. option:: --RANDOMIZE-REPLICA-READ
Select randomly the server within the replication pool to read from.
-.. describe:: --SORT-HOSTS
+.. option:: --SORT-HOSTS
When adding new servers always calculate their distribution based on sorted naming order.
-.. describe:: --SUPPORT-CAS
+.. option:: --SUPPORT-CAS
See :manpage:`memcached_behavior_set(3)` for :c:type:`MEMCACHED_BEHAVIOR_SUPPORT_CAS`
-.. describe:: --USE-UDP
+.. option:: --USE-UDP
See :manpage:`memcached_behavior_set(3)` for :c:type:`MEMCACHED_BEHAVIOR_USE_UDP`
-.. describe:: --NAMESPACE=
+.. option:: --NAMESPACE=
A namespace is a container that provides context for keys, only other
requests that know the namespace can access these values. This is
accomplished by prepending the namespace value to all keys.
-**********************
-Mecached Pool Options:
-**********************
+***********************
+Memcached Pool Options:
+***********************
-.. describe:: --POOL-MIN
+.. option:: --POOL-MIN
Initial size of pool.
-.. describe:: --POOL-MAX
+.. option:: --POOL-MAX
Maximize size of the pool.
I/O Options:
************
-.. describe:: --TCP-NODELAY
+.. option:: --TCP-NODELAY
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_TCP_NODELAY
-.. describe:: --TCP-KEEPALIVE
+.. option:: --TCP-KEEPALIVE
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
-.. describe:: --RETRY-TIMEOUT=
+.. option:: --RETRY-TIMEOUT=
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_RETRY_TIMEOUT
-.. describe:: --SERVER-FAILURE-LIMIT=
+.. option:: --SERVER-FAILURE-LIMIT=
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT
-.. describe:: --SND-TIMEOUT=
+.. option:: --SND-TIMEOUT=
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SND_TIMEOUT
-.. describe:: --SOCKET-RECV-SIZE=
+.. option:: --SOCKET-RECV-SIZE=
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE
-.. describe:: --SOCKET-SEND-SIZE=
+.. option:: --SOCKET-SEND-SIZE=
See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
-.. describe:: --POLL-TIMEOUT=
+.. option:: --POLL-TIMEOUT=
That sets the value of the timeout used by :manpage: `poll()`.
-.. describe:: --IO-BYTES-WATERMARK=
+.. option:: --IO-BYTES-WATERMARK=
-.. describe:: --IO-KEY-PREFETCH=
+.. option:: --IO-KEY-PREFETCH=
-.. describe:: --IO-MSG-WATERMARK=
+.. option:: --IO-MSG-WATERMARK=
-.. describe:: --TCP-KEEPIDLE
+.. option:: --TCP-KEEPIDLE
-.. describe:: --RCV-TIMEOUT=
+.. option:: --RCV-TIMEOUT=
-******
-Other:
-******
+Other Options:
+**************
-.. describe:: INCLUDE
+.. option:: INCLUDE
Include a file in configuration. Unlike --CONFIGURE-FILE= this will not reset memcached_st
-.. describe:: RESET
+.. option:: RESET
Reset memcached_st and continue to process.
-.. describe:: END
+.. option:: END
-End configutation processing.
+End configuration processing.
-.. describe:: ERROR
+.. option:: ERROR
-End configutation processing and throw an error.
+End configuration processing and throw an error.
+
+
+-----------
+ENVIRONMENT
+-----------
+
+.. envvar:: LIBMEMCACHED
------
.. code-block:: c
- const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com"
- memcached_st *memc= memcached(config_string, strlen(config_string);
+ const char *config_string=
+ "--SERVER=host10.example.com "
+ "--SERVER=host11.example.com "
+ "--SERVER=host10.example.com";
+ memcached_st *memc= memcached(config_string, strlen(config_string));
{
- ...
+ // ...
}
memcached_free(memc);
-----
-HOME
-----
-
-
-To find out more information please check:
-`http://libmemcached.org/ <http://libmemcached.org/>`_
-
-
-
--------
SEE ALSO
--------