X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_servers.pod;h=0e26e37d58e83938c55828854e7d514485e71175;hb=7a85b394e18dc4d8b1450174372d45eff846b908;hp=d417dfd15aa3555ee8ad2c5c6acaf73ef49bb97c;hpb=2eef99ff2e885ddb235623b7434921b18ca21d1e;p=awesomized%2Flibmemcached

diff --git a/docs/memcached_servers.pod b/docs/memcached_servers.pod
index d417dfd1..0e26e37d 100755
--- a/docs/memcached_servers.pod
+++ b/docs/memcached_servers.pod
@@ -17,17 +17,22 @@ C Client Library for memcached (libmemcached, -lmemcached)
 
   memcached_return
     memcached_server_add (memcached_st *ptr,
-                          char *hostname,
+                          const char *hostname,
                           unsigned int port);
 
   memcached_return
     memcached_server_add_unix_socket (memcached_st *ptr,
-                                      char *socket);
+                                      const char *socket);
 
   memcached_return
     memcached_server_push (memcached_st *ptr,
                            memcached_server_st *list);
 
+  memcached_server_st *
+    memcached_server_by_key (memcached_st *ptr,  
+                             const char *key, size_t key_length, 
+                             memcached_return *error);
+
 =head1 DESCRIPTION
 
 libmemcached(3) performs operations on a list of hosts. The order of these
@@ -57,6 +62,12 @@ end. Duplicate servers are allowed, so duplication is not checked. A
 copy is made of structure so the list provided (and any operations on
 the list) are not saved.
 
+memcached_server_by_key() allows you to provide a key and retrieve the
+server which would be used for assignment. This structure is cloned
+from its original structure and must be freed. If NULL is returned you
+should consult *error. The returning structure should be freed with
+memcached_server_free().
+
 =head1 RETURN
 
 Varies, see particular functions.