@@ -44,7+46,7 @@ Compile and link with \-lmemcached
.SH DESCRIPTION
.sp
Libmemcached implements a custom language for configuring and modifying
.SH DESCRIPTION
.sp
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 \fBmemcached_st\fP object
that you can use in your application directly.
.INDENT 0.0
.TP
that you can use in your application directly.
.INDENT 0.0
.TP
@@ -54,6+56,12 @@ that you can use in your application directly.
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.
.INDENT 0.0
.TP
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.
.INDENT 0.0
.TP
+.B \-\-SOCKET="<filepath>/?<optional_weight>"
+.UNINDENT
+.sp
+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.
+.INDENT 0.0
+.TP
.B \-\-VERIFY\-KEY
.UNINDENT
.sp
.B \-\-VERIFY\-KEY
.UNINDENT
.sp
@@ -102,44+110,82 @@ Set the distribution model used by the client. See :manpage:\(ga\(ga for more d
Set the hashing alogrthm used for placing keys on servers.
.INDENT 0.0
.TP
Set the hashing alogrthm used for placing keys on servers.
.INDENT 0.0
.TP
-.B \-\-HASH\-WITH\-PREFIX_KEY
+.B \-\-HASH\-WITH\-NAMESPACE
.UNINDENT
.UNINDENT
+.sp
+When enabled the prefix key will be added to the key when determining which
+server to store the data in.
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-IO\-BYTES\-WATERMARK=
+.B \-\-NOREPLY
.UNINDENT
.UNINDENT
+.sp
+Enable "no reply" for all calls that support this. It is highly recommended
+that you use this option with the binary protocol only.
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-IO\-KEY\-PREFETCH=
+.B \-\-NUMBER\-OF\-REPLICAS=
.UNINDENT
.UNINDENT
+.sp
+Set the nummber of servers that keys will be replicated to.
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-IO\-MSG\-WATERMARK=
+.B \-\-RANDOMIZE\-REPLICA\-READ
.UNINDENT
.UNINDENT
+.sp
+Select randomly the server within the replication pool to read from.
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-NOREPLY
+.B \-\-SORT\-HOSTS
.UNINDENT
.UNINDENT
+.sp
+When adding new servers always calculate their distribution based on sorted naming order.
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-NUMBER\-OF\-REPLICAS=
+.B \-\-SUPPORT\-CAS
.UNINDENT
.sp
.UNINDENT
.sp
-Set the nummber of servers that keys will be replicated to.
+See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_SUPPORT_CAS
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-POLL\-TIMEOUT=
+.B \-\-USE\-UDP
.UNINDENT
.UNINDENT
+.sp
+See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_USE_UDP
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-RANDOMIZE\-REPLICA\-READ
+.B \-\-NAMESPACE=
.UNINDENT
.sp
.UNINDENT
.sp
-Select randomly the server within the replication pool to read from.
+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.
+.SS Mecached Pool Options:
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-RCV\-TIMEOUT=
+.B \-\-POOL\-MIN
.UNINDENT
.UNINDENT
+.sp
+Initial size of pool.
+.INDENT 0.0
+.TP
+.B \-\-POOL\-MAX
+.UNINDENT
+.sp
+Maximize size of the pool.
+.SS I/O Options:
+.INDENT 0.0
+.TP
+.B \-\-TCP\-NODELAY
+.UNINDENT
+.sp
+See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_TCP_NODELAY
+.INDENT 0.0
+.TP
+.B \-\-TCP\-KEEPALIVE
+.UNINDENT
+.sp
+See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
.INDENT 0.0
.TP
.B \-\-RETRY\-TIMEOUT=
.INDENT 0.0
.TP
.B \-\-RETRY\-TIMEOUT=
@@ -172,42+218,31 @@ See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE
See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
.INDENT 0.0
.TP
See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE
.INDENT 0.0
.TP
-.B \-\-SORT\-HOSTS
+.B \-\-POLL\-TIMEOUT=
.UNINDENT
.sp
.UNINDENT
.sp
-When adding new servers always calculate their distribution based on sorted naming order.
+That sets the value of the timeout used by :manpage: \fIpoll()\fP.
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-SUPPORT\-CAS
+.B \-\-IO\-BYTES\-WATERMARK=
.UNINDENT
.UNINDENT
-.sp
-See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_SUPPORT_CAS
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-TCP\-NODELAY
+.B \-\-IO\-KEY\-PREFETCH=
.UNINDENT
.UNINDENT
-.sp
-See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_TCP_NODELAY
.INDENT 0.0
.TP
.INDENT 0.0
.TP
-.B \-\-TCP\-KEEPALIVE
+.B \-\-IO\-MSG\-WATERMARK=
.UNINDENT
.UNINDENT
-.sp
-See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_TCP_KEEPALIVE
.INDENT 0.0
.TP
.B \-\-TCP\-KEEPIDLE
.UNINDENT
.INDENT 0.0
.TP
.INDENT 0.0
.TP
.B \-\-TCP\-KEEPIDLE
.UNINDENT
.INDENT 0.0
.TP
-.B \-\-USE\-UDP
-.UNINDENT
-.sp
-See \fImemcached_behavior_set(3)\fP for MEMCACHED_BEHAVIOR_USE_UDP