1 ========================
2 Configuring Libmemcached
3 ========================
5 Libmemcached implements a custom language for configuring and modifying servers.
7 .. describe:: --SERVER=<servername>:<optional_port>/?<optional_weight>
9 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.
11 .. describe:: --VERIFY-KEY
13 Verify that keys that are being used fit within the design of the protocol being used.
15 .. describe:: --AUTO-EJECT_HOSTS
17 Enable the behavior MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS.
19 .. describe:: --BINARY-PROTOCOL
21 Force all connections to use the binary protocol.
23 .. describe:: --BUFFER-REQUESTS
25 Enable MEMCACHED_BEHAVIOR_BUFFER_REQUESTS.
27 .. describe:: --CONFIGURE-FILE=
29 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.
31 .. describe:: --CONNECT-TIMEOUT=
33 Enable MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT.
35 .. describe:: --DISTRIBUTION=
37 Set the distribution model used by the client. See :manpage:`` for more details.
41 Set the hashing alogrthm used for placing keys on servers.
43 .. describe:: --HASH-WITH-PREFIX_KEY
45 .. describe:: --IO-BYTES-WATERMARK=
47 .. describe:: --IO-KEY-PREFETCH=
49 .. describe:: --IO-MSG-WATERMARK=
51 .. describe:: --NOREPLY
53 .. describe:: --NUMBER-OF-REPLICAS=
55 Set the nummber of servers that keys will be replicated to.
57 .. describe:: --POLL-TIMEOUT=
59 .. describe:: --RANDOMIZE-REPLICA-READ
61 Select randomly the server within the replication pool to read from.
63 .. describe:: --RCV-TIMEOUT=
65 .. describe:: --RETRY-TIMEOUT=
67 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_RETRY_TIMEOUT
69 .. describe:: --SERVER-FAILURE-LIMIT=
71 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT
73 .. describe:: --SND-TIMEOUT=
75 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SND_TIMEOUT
77 .. describe:: --SOCKET-RECV-SIZE=
79 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE
81 .. describe:: --SOCKET-SEND-SIZE=
83 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
85 .. describe:: --SORT-HOSTS
87 When adding new servers always calculate their distribution based on sorted naming order.
89 .. describe:: --SUPPORT-CAS
91 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_SUPPORT_CAS
93 .. describe:: --TCP-NODELAY
95 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_TCP_NODELAY
97 .. describe:: --TCP-KEEPALIVE
99 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
101 .. describe:: --TCP-KEEPIDLE
103 .. describe:: --USE-UDP
105 See :manpage:`memcached_behavior_set(3)` for MEMCACHED_BEHAVIOR_USE_UDP
107 .. describe:: --PREFIX-KEY=
109 .. describe:: INCLUDE
111 Include a file in configuration. Unlike --CONFIGURE-FILE= this will not reset memcached_st
115 Reset memcached_st and continue to process.
119 End configutation processing.
123 End configutation processing and throw an error.