-.TH "LIBMEMCACHED" "3" "October 18, 2011" "1.01" "libmemcached"
+.TH "LIBMEMCACHED" "3" "July 05, 2012" "1.0.9" "libmemcached"
.SH NAME
libmemcached \- Introducing the C Client Library for memcached
.
libMemcached was designed to provide the greatest number of options to use Memcached. Some of the features provided:
.INDENT 0.0
.IP 1. 3
-.
Asynchronous and Synchronous Transport Support.
.IP 2. 3
-.
Consistent Hashing and Distribution.
.IP 3. 3
-.
Tunable Hashing algorithm to match keys.
.IP 4. 3
-.
Access to large object support.
.IP 5. 3
-.
Local replication.
.IP 6. 3
-.
A complete reference guide and documentation to the API.
.IP 7. 3
-.
Tools to Manage your Memcached networks.
.UNINDENT
.SH DESCRIPTION
.sp
Nearly all functions return a \fBmemcached_return_t\fP value.
This value can be translated to a printable string with
-\fBmemcached_strerror()\fP.
+\fBmemcached_strerror\fP.
.sp
Objects are stored on servers by hashing keys. The hash value maps the key to a particular server. All clients understand how this hashing works, so it is possibly to reliably both push data to a server and retrieve data from a server.
.sp
.INDENT 0.0
.TP
.B MEMCACHED_DEFAULT_PORT
-.
The default port used by memcached(3).
.UNINDENT
.INDENT 0.0
.TP
.B MEMCACHED_MAX_KEY
-.
Default maximum size of a key (which includes the null pointer). Master keys
have no limit, this only applies to keys used for storage.
.UNINDENT
.INDENT 0.0
.TP
.B MEMCACHED_MAX_KEY
-.
Default size of key (which includes the null pointer).
.UNINDENT
.INDENT 0.0
.TP
.B MEMCACHED_STRIDE
-.
This is the "stride" used in the consistent hash used between replicas.
.UNINDENT
.INDENT 0.0
.TP
.B MEMCACHED_MAX_HOST_LENGTH
-.
Maximum allowed size of the hostname.
.UNINDENT
.INDENT 0.0
.TP
.B LIBMEMCACHED_VERSION_STRING
-.
String value of libmemcached version such as "1.23.4"
.UNINDENT
.INDENT 0.0
.TP
.B LIBMEMCACHED_VERSION_HEX
-.
Hex value of the version number. "0x00048000" This can be used for comparing versions based on number.
.UNINDENT
+.INDENT 0.0
+.TP
+.B MEMCACHED_PREFIX_KEY_MAX_SIZE
+Maximum length allowed for namespacing of a key.
+.UNINDENT
.SH THREADS AND PROCESSES
.sp
When using threads or forked processes it is important to keep one instance