=head1 NAME
-memcached_server_count, memcached_server_list, memcached_server_add, memcached_server_push
+memcached_server_count, memcached_server_list, memcached_server_add, memcached_server_push, memcached_server_get_last_disconnect - Manage server list
=head1 LIBRARY
memcached_return
memcached_server_add (memcached_st *ptr,
- char *hostname,
+ const char *hostname,
+ unsigned int port);
+
+ memcached_return
+ memcached_server_add_udp (memcached_st *ptr,
+ 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_by_key (memcached_st *ptr,
const char *key, size_t key_length,
memcached_return *error);
+ memcached_server_st *
+ memcached_server_get_last_disconnect (memcached_st *ptr)
+
=head1 DESCRIPTION
You are responsible for freeing this list (aka it is not a pointer to the
currently used structure).
-memcached_server_add() pushes a single server into the C<memcached_st>
+memcached_server_add() pushes a single TCP server into the C<memcached_st>
structure. This server will be placed at the end. Duplicate servers are
-allowed, so duplication is not checked.
+allowed, so duplication is not checked. Executing this function with the
+C<MEMCACHED_BEHAVIOR_USE_UDP> behavior set will result in a
+C<MEMCACHED_INVALID_HOST_PROTOCOL>.
+
+memcached_server_add_udp() pushes a single UDP server into the C<memcached_st>
+structure. This server will be placed at the end. Duplicate servers are
+allowed, so duplication is not checked. Executing this function with out
+setting the C<MEMCACHED_BEHAVIOR_USE_UDP> behavior will result in a
+C<MEMCACHED_INVALID_HOST_PROTOCOL>.
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.
should consult *error. The returning structure should be freed with
memcached_server_free().
+memcached_server_get_last_disconnect() returns a pointer to the last server
+for which there was a connection problem. It does not mean this particular
+server is currently dead but if the library is reporting a server is,
+the returned server is a very good candidate.
+
=head1 RETURN
Varies, see particular functions.