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,
+ 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
memcached_server_count() provides you a count of the current number of
servers being used by a C<memcached_st> structure.
-memcached_server_list() is used to provide an array of all connected hosts.
+memcached_server_list() is used to provide an array of all defined hosts.
You are responsible for freeing this list (aka it is not a pointer to the
currently used structure).
structure. This server will be placed at the end. Duplicate servers are
allowed, so duplication is not checked.
+memcached_server_add_unix_socket() pushes a single UNIX socket into the
+C<memcached_st> structure. This UNIX socket will be placed at the end.
+Duplicate servers are allowed, so duplication is not checked. The length
+of the filename must be one character less then MEMCACHED_MAX_HOST_LENGTH.
+
memcached_server_push() pushes an array of C<memcached_server_st> into
the C<memcached_st> structure. These servers will be placed at the
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.